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

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

المنصة:

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

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

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

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

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

الطريقة الموصى بها لإضافة روبوت الدردشة هي تحرير التخطيط الافتراضي في واجهة October CMS الخلفية:

سجّل الدخول إلى واجهة October CMS الخلفية
انتقل إلى CMS > Layouts في القائمة الرئيسية
افتح التخطيط الافتراضي (عادةً default.htm)
ابحث عن وسم الإغلاق </body> والعنصر النائب {% scripts %} عنصر نائب
أضف كود Asyntai المضمّن مباشرة قبل {% scripts %} و </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
انقر على "Save" لتطبيق التغييرات

نصيحة: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

يمكنك استخدام العنصر النائب للنصوص البرمجية في October CMS لحقن روبوت الدردشة من صفحة أو جزء:

افتح أي صفحة أو جزء في محرر CMS
أضف الكود التالي باستخدام {% put scripts %} كتلة:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
استبدل YOUR_WIDGET_ID بمعرّف الأداة الفعلي من لوحة التحكم
انقر على "Save"

ملاحظة: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

الطريقة البديلة 2: استخدام مكون PHP

إذا كنت تفضل نهجًا برمجيًا، يمكنك إضافة نص روبوت الدردشة البرمجي عبر مكون مخصص:

أنشئ أو عدّل مكونًا في إضافة October CMS الخاصة بك
في طريقة onRun() الخاصة بالمكون، استخدم طريقة addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
استبدل YOUR_WIDGET_ID بمعرف الأداة الفعلي الخاص بك
سجّل المكون في الصفحات التي تريد ظهور روبوت الدردشة فيها

نصيحة: يمنحك استخدام المكون تحكمًا برمجيًا في وقت ومكان تحميل روبوت الدردشة. يمكنك إضافة منطق شرطي داخل onRun() للتحكم في التحميل بناءً على أدوار المستخدمين أو أنواع الصفحات أو معايير أخرى.

الطريقة البديلة 3: استخدام جزء

يمكنك إنشاء جزء قابل لإعادة الاستخدام لأداة روبوت الدردشة:

انتقل إلى CMS > Partials في واجهة October CMS الخلفية
انقر على "+ Add" لإنشاء جزء جديد
سمِّه asyntai-widget.htm
أضف كود التضمين الخاص بـ Asyntai إلى الجزء:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
انقر على "Save"
افتح قالب التخطيط وقم بتضمين الجزء قبل </body>:
{% partial 'asyntai-widget' %}
احفظ التخطيط

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

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

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

لا ترى الأداة؟ تأكد من حفظ جميع التغييرات في الواجهة الخلفية لنظام إدارة المحتوى. امسح ذاكرة التخزين المؤقت للمتصفح أو اعرض الموقع في نافذة تصفح خاص. إذا كان موقعك يستخدم التخزين المؤقت، امسح ذاكرة التخزين المؤقت لـ October CMS عن طريق تشغيل php artisan cache:clear من سطر الأوامر، أو استخدم خيار Settings > System > Clear Cache في الواجهة الخلفية.

اختيار التخطيط: تأكد من أن الصفحات التي تريد ظهور روبوت الدردشة فيها تستخدم التخطيط الصحيح. يمكنك التحقق من التخطيط الذي تستخدمه الصفحة بفتحها في CMS > Pages والنظر إلى القائمة المنسدلة Layout في إعدادات الصفحة.