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

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

المنصة:

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

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

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

الخطوة 2: استخدام وحدة Header and Footer Scripts (موصى بها)

أسهل طريقة لإضافة روبوت الدردشة هي استخدام وحدة "Header and Footer Scripts":

سجّل الدخول إلى لوحة إدارة Drupal
انتقل إلى Extend وانقر على "Install new module"
Search for "Header and Footer Scripts" or download it from Drupal.org
ثبّت الوحدة وفعّلها
انتقل إلى Configuration → Development → Header and Footer Scripts
انقر على علامة تبويب "Footer"
الصق كود Asyntai المضمّن في منطقة نص سكريبتات التذييل
انقر على "Save configuration"

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

بديل: تعديل قالب السمة

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

انتقل إلى مجلد القالب الخاص بك: themes/your_theme/
افتح ملف html.html.twig (أو أنشئ واحداً إذا لم يكن موجوداً)
ابحث عن وسم الإغلاق </body>
الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة
احفظ الملف
امسح ذاكرة التخزين المؤقت لـ Drupal: Configuration → Performance → Clear all caches

مهم: قد تُكتب التغييرات على ملفات القالب فوقها عند تحديث القالب. فكّر في استخدام قالب فرعي أو وحدة Header and Footer Scripts لحل أكثر ديمومة.

بديل: استخدام المكتبات (للمطورين)

للمطورين الذين يفضلون استخدام نظام مكتبات الأصول في Drupal:

أنشئ أو عدّل ملف *.libraries.yml الخاص بالقالب
أضف إدخال مكتبة جديد:
asyntai-chatbot: js: https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
أرفق المكتبة في ملف *.info.yml الخاص بالقالب:
libraries: - your_theme/asyntai-chatbot
امسح ذاكرة التخزين المؤقت لـ Drupal

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

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