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

التوثيق

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

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

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

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

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

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

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

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

الخطوة 2: الإضافة إلى قالب السمة (موصى به)

يستخدم Backdrop CMS ملفات قوالب .tpl.php في سماته. النهج الموصى به هو إضافة كود التضمين مباشرة إلى قالب صفحة السمة النشطة:

  1. ادخل إلى تثبيت Backdrop CMS عبر FTP أو File Manager
  2. انتقل إلى دليل السمة النشطة: themes/yourtheme/
  3. افتح ملف page.tpl.php (أو layout.tpl.php حسب سمتك)
  4. ابحث عن وسم الإغلاق </body> أو السطر <?php print $page_bottom; ?>
  5. الصق كود تضمين Asyntai قبل ذلك السطر مباشرة
  6. احفظ الملف
<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

نصيحة: وضع الكود قبل <?php print $page_bottom; ?> أو وسم الإغلاق </body> مباشرة يضمن تحميل روبوت الدردشة بعد محتوى الصفحة، مما يوفر أداء تحميل أفضل للصفحة. تضيف هذه الطريقة روبوت الدردشة تلقائياً إلى كل صفحة تستخدم هذه السمة.

الطريقة البديلة 1: استخدام وحدة مخصصة

يمكنك إنشاء وحدة Backdrop CMS بسيطة تحقن سكريبت روبوت الدردشة باستخدام backdrop_add_js():

  1. أنشئ دليل الوحدة: modules/custom/asyntai_widget/
  2. أنشئ ملف الوحدة asyntai_widget.module بالكود التالي:
    // modules/custom/asyntai_widget/asyntai_widget.module
    function asyntai_widget_init() {
      backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array(
        'type' => 'external',
        'scope' => 'footer',
        'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'),
      ));
    }
  3. أنشئ ملف asyntai_widget.info:
    name = Asyntai AI Chatbot Widget
    description = Adds the Asyntai AI chatbot widget to all pages.
    backdrop = 1.x
    package = Custom
    type = module
  4. انتقل إلى Functionality (admin/modules) في لوحة إدارة Backdrop
  5. ابحث عن "Asyntai AI Chatbot Widget" ضمن حزمة Custom وقم بتفعيلها
  6. انقر على "Save configuration"

ملاحظة: استبدل YOUR_WIDGET_ID في كود الوحدة بمعرف الأداة الفعلي من لوحة تحكم Asyntai. نهج الوحدة المخصصة آمن عند الترقية ولن يتم الكتابة فوقه عند تحديث سمتك.

الطريقة البديلة 2: استخدام وحدة "Add to Head" في Backdrop

توفر وحدة "Add to Head" المساهمة طريقة سهلة لحقن السكريبتات دون تحرير الكود:

  1. قم بتنزيل وتثبيت وحدة "Add to Head" المساهمة من موقع Backdrop CMS
  2. انتقل إلى Configuration > Development > Add to Head
  3. أضف كود تضمين Asyntai في قسم التذييل
  4. انقر على "Save configuration"

نصيحة: استخدام وحدة "Add to Head" هو أسهل طريقة إذا كنت تفضل عدم تحرير ملفات السمة أو إنشاء وحدات مخصصة. توفر واجهة إدارة بسيطة لإدارة السكريبتات المحقونة.

الطريقة البديلة 3: استخدام نظام الكتل

يمكن أيضاً استخدام نظام التخطيط والكتل في Backdrop CMS لإضافة روبوت الدردشة:

  1. سجّل الدخول إلى لوحة إدارة Backdrop CMS
  2. انتقل إلى Structure > Layouts
  3. اختر التخطيط الذي تريد تعديله (مثل التخطيط الافتراضي)
  4. انقر على "Add block" في منطقة التذييل
  5. اختر "Custom block"
  6. عيّن تنسيق الكتلة إلى "Full HTML" أو "Raw HTML"
  7. الصق كود تضمين Asyntai في نص الكتلة
  8. أعطِ الكتلة عنواناً (مثل "Asyntai Chatbot") واختيارياً حدد "Hide title"
  9. انقر على "Save block" ثم "Save layout"

مهم: تأكد من تعيين تنسيق النص إلى "Full HTML" أو "Raw HTML" حتى لا تتم إزالة وسم السكريبت. تنسيق "Filtered HTML" الافتراضي سيزيل وسوم السكريبت لأسباب أمنية.

الخطوة 3: مسح ذاكرة التخزين المؤقت والتحقق

بعد إجراء التغييرات، امسح ذاكرة التخزين المؤقت لـ Backdrop CMS وتحقق من التثبيت:

  1. انتقل إلى Configuration > Performance في لوحة الإدارة الخاصة بك
  2. انقر على "Clear all caches"
  3. افتح موقعك الإلكتروني في علامة تبويب جديدة أو نافذة تصفح خاص
  4. يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى
  5. انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح

لا ترى الأداة؟ تأكد من مسح ذاكرة التخزين المؤقت لـ Backdrop CMS من Configuration > Performance. جرب عرض موقعك في نافذة تصفح خاص أو مسح ذاكرة التخزين المؤقت للمتصفح. افتح وحدة تحكم المتصفح (F12) للتحقق من أي أخطاء JavaScript. إذا استخدمت طريقة الوحدة المخصصة، تحقق من تفعيل الوحدة ضمن Functionality.