كيفية إضافة روبوت الدردشة Asyntai AI إلى Drupal
دليل خطوة بخطوة لمواقع Drupal
الخطوة 1: احصل على كود التضمين
أولاً، انتقل إلى لوحة تحكم Asyntai وانتقل لأسفل إلى قسم "Embed Code". انسخ كود التضمين الفريد الذي سيبدو هكذا:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
ملاحظة: الكود أعلاه مجرد مثال. يجب عليك نسخ كود التضمين الفريد الخاص بك من لوحة التحكم لأنه يحتوي على معرف الأداة الشخصي الخاص بك.
الخطوة 2: استخدام وحدة Header and Footer Scripts (موصى بها)
أسهل طريقة لإضافة روبوت الدردشة هي استخدام وحدة "Header and Footer Scripts":
- سجّل الدخول إلى لوحة إدارة Drupal
- انتقل إلى Extend وانقر على "Install new module"
- ابحث عن "Header and Footer Scripts" أو قم بتنزيلها من 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: التحقق من التثبيت
بعد حفظ تغييراتك ومسح ذاكرة التخزين المؤقت، قم بزيارة موقعك في علامة تبويب جديدة أو نافذة تصفح متخفي. يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى. انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح.
لا ترى الأداة؟ تأكد من مسح ذاكرة التخزين المؤقت لـ Drupal بالانتقال إلى Configuration → Performance → Clear all caches. جرّب أيضاً مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح متخفي.
Weebly