العودة إلى لوحة التحكم

التوثيق

تعلّم كيفية استخدام Asyntai

كيفية إضافة روبوت الدردشة Asyntai AI إلى Ghost

دليل خطوة بخطوة لمواقع Ghost CMS

الحصول على كود التضمين

الخطوة 1: احصل على كود التضمين

أولاً، انتقل إلى لوحة تحكم Asyntai وانتقل لأسفل إلى قسم "Embed Code". انسخ كود التضمين الفريد الذي سيبدو هكذا:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

ملاحظة: الكود أعلاه مجرد مثال. يجب عليك نسخ كود التضمين الفريد الخاص بك من لوحة التحكم لأنه يحتوي على معرف الأداة الشخصي الخاص بك.

الخطوة 2: استخدام حقن الكود (موصى بها)

يحتوي Ghost على ميزة حقن الكود المدمجة التي تجعل إضافة السكريبتات المخصصة سهلة جداً:

  1. سجّل الدخول إلى لوحة إدارة Ghost
  2. انقر على أيقونة الترس (الإعدادات) في الزاوية السفلية اليسرى
  3. مرّر للأسفل إلى قسم "Advanced"
  4. انقر على "Code injection"
  5. في قسم "Site footer"، الصق كود Asyntai المضمّن
  6. انقر على "Save" في الزاوية العلوية اليمنى

نصيحة: تضمن إضافة JavaScript إلى تذييل الموقع (بدلاً من رأس الموقع) تحميله بعد محتوى الصفحة، وهو ما يُوصى به لأدوات الدردشة ولن يبطئ تحميل صفحتك.

بديل: حقن كود خاص بالصفحة

إذا كنت تريد روبوت الدردشة في صفحات أو منشورات محددة فقط:

  1. Open the post or page you want to add the chatbot to
  2. Click the settings icon (gear) in the top right corner
  3. مرّر للأسفل للعثور على "Code injection"
  4. وسّع القسم والصق كود Asyntai المضمّن في حقل "Post footer"
  5. انقر خارج الحقل للحفظ، ثم انشر/حدّث منشورك

ملاحظة: حقن الكود الخاص بالصفحة مفيد إذا كنت تريد روبوت الدردشة في صفحات معينة فقط بدلاً من موقعك بالكامل.

بديل: تعديل ملفات القالب (للاستضافة الذاتية)

إذا كنت تستضيف Ghost ذاتياً وتفضل تعديل ملفات القالب مباشرةً:

  1. ادخل إلى ملفات تثبيت Ghost عبر FTP أو مدير الملفات
  2. انتقل إلى مجلد القالب: content/themes/your-theme/
  3. افتح ملف default.hbs (ملف التخطيط الرئيسي)
  4. ابحث عن وسم الإغلاق </body>
  5. الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة
  6. احفظ الملف
  7. أعد تشغيل Ghost أو امسح ذاكرة التخزين المؤقت

مهم: لا يُوصى بتعديل ملفات القالب مباشرةً إلا عند الضرورة. قد تُكتب التغييرات فوقها عند تحديث القالب. يُفضَّل استخدام طريقة حقن الكود لأنها تصمد أمام تحديثات القالب.

الخطوة 3: التحقق من التثبيت

بعد حفظ تغييراتك، قم بزيارة موقع Ghost في علامة تبويب جديدة أو نافذة تصفح متخفي. يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى. انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح.

لا ترى الأداة؟ تأكد من النقر على "Save" بعد إضافة الكود في Code Injection. جرّب مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح متخفي. إذا كنت تستخدم Ghost(Pro)، يجب أن تظهر التغييرات فوراً. للاستضافة الذاتية لـ Ghost، قد تحتاج إلى إعادة تشغيل خدمة Ghost.