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

التوثيق

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

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

دليل خطوة بخطوة لنظام إدارة المحتوى Bludit

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

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

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

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

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

الخطوة 2: إضافة الكود باستخدام إضافة HTML Code (موصى به)

أسهل طريقة لإضافة روبوت الدردشة إلى موقع Bludit الخاص بك هي استخدام إضافة HTML Code المدمجة:

  1. سجّل الدخول إلى لوحة إدارة Bludit الخاصة بك
  2. انتقل إلى Plugins في الشريط الجانبي الأيسر
  3. ابحث عن إضافة "HTML Code" (عادة ما تكون مثبتة مسبقاً)
  4. إذا لم تكن نشطة، انقر على "Activate" لتفعيلها
  5. انقر على "Configure" في إضافة HTML Code
  6. في التكوين، سترى حقولاً لكود الرأس والتذييل
  7. الصق كود تضمين Asyntai الخاص بك في حقل "Footer"
  8. انقر على "Save"

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

الطريقة البديلة 1: الدمج مع ملف القالب

لمزيد من التحكم، يمكنك إضافة الكود مباشرة إلى ملفات القالب الخاصة بك:

  1. اتصل بتثبيت Bludit الخاص بك عبر FTP أو مدير الملفات
  2. انتقل إلى /bl-themes/your-theme-name/
  3. افتح ملف index.php للتحرير
  4. ابحث عن وسم الإغلاق </body>
  5. الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة
  6. احفظ الملف
  7. امسح ذاكرة التخزين المؤقت لموقعك إن أمكن

ملاحظة: عند تحرير ملفات القالب مباشرة، تأكد من عمل نسخة احتياطية من الملف الأصلي أولاً. قد تكتب تحديثات القالب فوق تغييراتك، لذا وثّق تعديلاتك.

الطريقة البديلة 2: محتوى مخصص في الصفحات

يمكنك أيضاً إضافة كود روبوت الدردشة مباشرة إلى صفحات محددة باستخدام محرر محتوى Bludit:

  1. سجّل الدخول إلى لوحة إدارة Bludit الخاصة بك
  2. انتقل إلى Content واختر الصفحة التي تريد تحريرها
  3. انتقل إلى وضع HTML في المحرر (إذا كنت تستخدم محرراً مرئياً)
  4. أضف كود تضمين Asyntai الخاص بك في أي مكان في محتوى الصفحة
  5. انقر على "Save"
  6. كرر ذلك للصفحات الأخرى التي تريد روبوت الدردشة فيها

مهم: عند إضافة الكود مباشرة إلى محتوى الصفحة، ستحتاج إلى إضافته إلى كل صفحة على حدة. للتثبيت على مستوى الموقع، استخدم إضافة HTML Code أو طريقة ملف القالب بدلاً من ذلك.

استخدام خطافات الإضافات (متقدم)

للمطورين الذين ينشئون إضافات مخصصة، يوفر Bludit خطافات الإضافات:

  • siteBodyBegin - يُنفَّذ في أعلى وسم <body>
  • siteBodyEnd - يُنفَّذ في الأسفل، مثالي لكود JavaScript مثل أداة Asyntai

يمكنك إنشاء إضافة مخصصة تستخدم خطاف siteBodyEnd لحقن كود روبوت الدردشة في جميع الصفحات.

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

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

لا ترى الأداة؟ تأكد من حفظ تكوين الإضافة أو تغييرات ملف القالب. امسح ذاكرة التخزين المؤقت للمتصفح وذاكرة Bludit المؤقتة (إن كانت مفعّلة). تحقق من وحدة تحكم المتصفح (F12) بحثاً عن أي أخطاء JavaScript.