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

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

المنصة:

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

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

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

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

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

الطريقة الموصى بها لإضافة روبوت الدردشة هي تعديل ملف قالب e107 مباشرةً:

انتقل إلى مجلد قالب e107 الخاص بك: e107_themes/yourtheme/
افتح ملف القالب الرئيسي (عادةً theme.php أو theme.html)
ابحث عن وسم الإغلاق </body>
الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة:

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

نصيحة: إذا كان قالبك يستخدم theme.php، ابحث عن القسم الذي يُعرض فيه HTML التذييل. يجب وضع كود التضمين بعد كل المحتوى الآخر ولكن قبل وسم إغلاق body.

الطريقة البديلة 1: استخدام رأس/تذييل e107 المخصص

يمكنك إضافة سكريبت روبوت الدردشة من خلال لوحة إدارة e107 بدون تعديل ملفات القالب:

سجّل الدخول إلى لوحة إدارة e107
انتقل إلى Admin > Preferences > Site Preferences
ابحث عن قسم "Custom Footer" أو "Footer Scripts"
الصق كود Asyntai المضمّن في منطقة نص سكريبتات التذييل
انقر على "Save" لتطبيق التغييرات

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

الطريقة البديلة 2: استخدام إضافة e107

لنهج أكثر نمطية، يمكنك إنشاء إضافة بسيطة أو استخدام نظام خطافات الإضافات لحقن سكريبت روبوت الدردشة:

أنشئ إضافة بسيطة أو استخدم إضافة "Custom Pages"
أضف السكريبت عبر نظام خطافات إضافات e107 بإنشاء ملف e_footer.php في مجلد الإضافة
داخل e_footer.php، أخرج كود التضمين:

<?php
// e_footer.php - Asyntai Chatbot Plugin Hook
echo '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
?>

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

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

يمكنك استخدام نظام القوائم المدمج في e107 لإضافة سكريبت روبوت الدردشة إلى منطقة التذييل:

سجّل الدخول إلى لوحة إدارة e107
انتقل إلى Admin > Menus
أنشئ قائمة HTML مخصصة
الصق كود Asyntai المضمّن في محتوى القائمة
عيّن القائمة إلى منطقة التذييل في قالبك
احفظ إعدادات القائمة

مهم: عند استخدام نظام القوائم، تأكد من أن منطقة القائمة التي تعيّنها تدعم إخراج HTML/script الخام. قد تزيل بعض مناطق القوائم وسوم script لأسباب أمنية. إذا تمت إزالة السكريبت، استخدم إحدى الطرق الأخرى بدلاً من ذلك.

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

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

لا ترى الأداة؟ جرّب مسح ذاكرة التخزين المؤقت لـ e107 من لوحة الإدارة تحت Admin > Cache. جرّب أيضاً مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح متخفي. تأكد من أن كود التضمين موضوع بشكل صحيح ويحتوي على معرّف الأداة الفريد الخاص بك من لوحة التحكم.