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

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

المنصة:

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

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

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

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

الخطوة 2: إضافة الكود إلى قالب الصفحة الرئيسية (مُوصى به)

لإضافة روبوت الدردشة إلى جميع صفحات موقع Kentico الخاص بك دفعة واحدة، استخدم طريقة قالب الصفحة الرئيسية:

سجّل الدخول إلى لوحة إدارة Kentico وانتقل إلى تطبيق Page templates
حدد موقع وافتح قالب الصفحة الرئيسية (القالب المستخدم عبر جميع الصفحات)
انقر على علامة تبويب Header في محرر القالب
في قسم الرأس، الصق كود التضمين الخاص بـ Asyntai
بدلاً من ذلك، أضف الكود إلى تخطيط القالب قبل وسم الإغلاق </head>
انقر على Save لتطبيق التغييرات
امسح ذاكرة التخزين المؤقت للموقع وتحقق من التغييرات على الموقع المباشر

نصيحة: يضمن استخدام قالب الصفحة الرئيسية ظهور روبوت الدردشة في كل صفحة ترث من هذا القالب. هذه هي الطريقة الأكثر كفاءة للنشر على مستوى الموقع في Kentico.

الطريقة البديلة 1: رأس قالب الصفحة

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

انتقل إلى تطبيق Page templates في لوحة إدارة Kentico
اختر قالب الصفحة المحدد الذي تريد تحريره
انقر على علامة تبويب Header
أضف كود التضمين الخاص بـ Asyntai باستخدام وسم script:

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

انقر على Save
ستتضمن جميع الصفحات التي تستخدم هذا القالب الآن روبوت الدردشة

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

الطريقة البديلة 2: عنصر ويب HEAD HTML

لتحكم أكثر دقة في صفحات محددة أو لـ JavaScript قابل للتوريث عبر الصفحات الفرعية:

افتح الصفحة التي تريد تحريرها في محرر صفحات Kentico
أضف عنصر ويب جديدًا إلى الصفحة (يُفضل في صفحة رئيسية للتوريث)
ابحث عن عنصر ويب HEAD HTML واختره
في إعدادات عنصر الويب، الصق كود التضمين الخاص بـ Asyntai
اضبط عنصر الويب ليكون قابلاً للتوريث إذا كنت تريد أن تحتوي الصفحات الفرعية على روبوت الدردشة
انقر على OK لحفظ عنصر الويب
احفظ الصفحة وانشرها

نصيحة: عنصر ويب HEAD HTML مثالي لإضافة كود إلى صفحة رئيسية سينتشر تلقائيًا إلى جميع الصفحات الفرعية، مما يُنشئ تثبيتًا على مستوى القسم.

الطريقة البديلة 3: ملفات JavaScript مخصصة (متقدم)

للمطورين الذين يفضلون إدارة النصوص البرمجية كملفات:

في مشروع Kentico الخاص بك، انتقل إلى مجلد ~/CMSScripts/Custom/
أنشئ ملف JavaScript جديدًا (مثل asyntai-widget.js)
أضف كودًا لتحميل أداة Asyntai الخاصة بك ديناميكيًا:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

أشر إلى هذا الملف في رأس قالب الصفحة الرئيسية:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

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

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

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

لا ترى الأداة؟ تأكد من حفظ جميع التغييرات ومسح ذاكرة التخزين المؤقت لـ Kentico (Settings > System > Clear cache). حاول عرض موقعك في نافذة تصفح خاص. تحقق من وحدة تحكم المتصفح (F12) بحثًا عن أي أخطاء JavaScript قد تمنع تحميل الأداة.