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

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

المنصة:

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

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

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

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

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

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

سجّل الدخول إلى مدير MODX (لوحة الإدارة)
في الشريط الجانبي الأيسر، انتقل إلى Elements > Templates
افتح قالب موقعك (يُسمى عادةً "BaseTemplate" أو القالب النشط الخاص بك)
ابحث عن وسم الإغلاق </body> في كود القالب
الصق كود التضمين الخاص بـ Asyntai قبل وسم الإغلاق </body> مباشرة
انقر على "Save" لحفظ القالب

<!-- Your existing template content -->

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

نصيحة: إضافة الكود قبل وسم الإغلاق </body> مباشرة يضمن تحميل روبوت الدردشة بعد جميع محتوى الصفحة، وهو الموضع الموصى به لأدوات الدردشة ولن يبطئ تحميل صفحتك.

الطريقة البديلة 1: استخدام مقتطف MODX

يمكنك استخدام MODX Chunk للحفاظ على كود التضمين منفصلاً وقابلاً لإعادة الاستخدام:

في مدير MODX، انتقل إلى Elements > Chunks
انقر على "New Chunk" لإنشاء مقتطف جديد
سمِّ المقتطف "asyntaiWidget"
الصق كود التضمين الخاص بـ Asyntai في منطقة محتوى المقتطف
انقر على "Save"
افتح القالب (ضمن Elements > Templates)
أضف استدعاء المقتطف [[$asyntaiWidget]] قبل وسم الإغلاق </body> مباشرة
احفظ القالب

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

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

الطريقة البديلة 2: استخدام إعدادات نظام MODX (رأس/تذييل HTML)

تتضمن بعض إعدادات MODX عناصر نائبة للنصوص البرمجية في التذييل عبر إعدادات النظام:

في مدير MODX، انتقل إلى System > System Settings
فلتر حسب "htmlhead" أو ابحث عن إعداد نظام مخصص للنصوص البرمجية في التذييل
إذا كان إعدادك يحتوي على عنصر نائب للنصوص البرمجية في التذييل (مثل [[++footer_scripts]])، يمكنك استخدامه
اضبط قيمة إعداد النظام على كود التضمين الخاص بـ Asyntai
تأكد من وجود العنصر النائب المقابل [[++footer_scripts]] في القالب قبل وسم الإغلاق </body>
احفظ إعداد النظام

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

ملاحظة: تعتمد هذه الطريقة على وجود إعداد نظام مخصص للنصوص البرمجية في التذييل في إعداد MODX الخاص بك. إذا لم يكن موجودًا، يمكنك إنشاء إعداد نظام مخصص والإشارة إليه في القالب باستخدام صيغة [[++setting_key]].

الطريقة البديلة 3: استخدام إضافة MODX (OnWebPagePrerender)

لنهج متقدم، يمكنك إنشاء إضافة MODX تحقن تلقائيًا كود روبوت الدردشة في كل صفحة:

في مدير MODX، انتقل إلى Elements > Plugins
انقر على "New Plugin" لإنشاء إضافة جديدة
سمِّ الإضافة "AsyntaiChatbot"
الصق كود PHP التالي في منطقة كود الإضافة:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

انقر على علامة تبويب "System Events"
حدد المربع بجوار "OnWebPagePrerender" لتشغيل هذه الإضافة عند ذلك الحدث
انقر على "Save"

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

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

بعد إضافة كود التضمين باستخدام أي من الطرق أعلاه، تحتاج إلى مسح ذاكرة التخزين المؤقت لـ MODX والتحقق من التثبيت:

في مدير MODX، انتقل إلى Manage > Clear Cache (أو انقر على أيقونة مسح ذاكرة التخزين المؤقت في القائمة العلوية)
افتح موقعك في علامة تبويب جديدة أو نافذة تصفح خاص
يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى من صفحتك
انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح

لا ترى الأداة؟ تأكد من مسح ذاكرة التخزين المؤقت لـ MODX من Manage > Clear Cache في مدير MODX. حاول أيضًا مسح ذاكرة التخزين المؤقت للمتصفح أو عرض الموقع في نافذة تصفح خاص. إذا استخدمت طريقة الإضافة، تحقق من تحديد حدث النظام "OnWebPagePrerender" لإضافتك.