كيفية إضافة روبوت Asyntai AI للدردشة إلى Umbraco
دليل خطوة بخطوة لمواقع Umbraco CMS
الخطوة 1: احصل على كود التضمين
أولاً، انتقل إلى لوحة تحكم Asyntai وانتقل لأسفل إلى قسم "Embed Code". انسخ كود التضمين الفريد الذي سيبدو هكذا:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
ملاحظة: الكود أعلاه مجرد مثال. يجب عليك نسخ كود التضمين الفريد الخاص بك من لوحة التحكم لأنه يحتوي على معرف الأداة الشخصي الخاص بك.
الخطوة 2: تعديل القالب الرئيسي (موصى به)
أسهل طريقة لإضافة روبوت الدردشة إلى جميع الصفحات هي تعديل القالب الرئيسي:
- سجّل الدخول إلى لوحة تحكم Umbraco
- انتقل إلى Settings في الشريط الجانبي الأيسر
- وسّع القوالب
- انقر على قالب Master (أو قالب التخطيط الرئيسي الذي يستخدمه موقعك)
- ابحث عن وسم الإغلاق
</body> - الصق كود تضمين Asyntai الخاص بك قبل وسم
</body>مباشرة - انقر على "Save"
نصيحة: إضافة البرنامج النصي قبل وسم الإغلاق </body> يضمن تحميله بعد محتوى الصفحة، وهو أمر موصى به لأدوات الدردشة ولن يبطئ تحميل صفحتك.
بديل: استخدام نوع مستند إعدادات الموقع
لمزيد من المرونة، يمكنك إضافة حقل مخصص لإدارة نصوص التذييل البرمجية:
- انتقل إلى Settings → Document Types
- عدّل نوع مستند إعدادات الموقع (أو أنشئ واحدًا إذا لم يكن موجودًا)
- أضف خاصية جديدة باسم "Footer Scripts" بنوع بيانات Textarea
- احفظ نوع المستند
- انتقل إلى المحتوى وعدّل عقدة إعدادات الموقع
- الصق كود Asyntai المضمّن في حقل Footer Scripts
- في القالب الرئيسي، أضف هذا الكود قبل
</body>:@Html.Raw(Model.Value("footerScripts")) - احفظ كلاً من المحتوى والقالب
ملاحظة: استخدام @Html.Raw() مهم لعرض وسوم النصوص البرمجية بشكل صحيح بدون ترميز HTML.
بديل: استخدام مجلد النصوص البرمجية
يمكنك أيضًا إنشاء ملف JavaScript في لوحة تحكم Umbraco:
- انتقل إلى Settings → Scripts
- انقر بزر الماوس الأيمن على Scripts واختر "Create"
- أنشئ ملفًا جديدًا باسم asyntai-chatbot.js
- أضف الكود التالي:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - استبدل
YOUR_WIDGET_IDبمعرف الأداة الفعلي الخاص بك - احفظ الملف
- قم بتضمين هذا النص البرمجي في القالب الرئيسي قبل
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
بديل: صفحة محددة باستخدام RenderSection
إذا كنت تريد روبوت الدردشة في صفحات محددة فقط:
- في القالب الرئيسي، أضف قبل
</body>:@RenderSection("footerScripts", required: false) - في قالب الصفحة المحددة التي تريد روبوت الدردشة فيها، أضف:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
الخطوة 3: التحقق من التثبيت
بعد حفظ التغييرات، قم بزيارة موقعك في علامة تبويب جديدة أو نافذة تصفح خاص. يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى. انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح.
لا ترى الأداة؟ تأكد من حفظ القالب بعد إجراء التغييرات. جرّب مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح خاص. إذا كنت تستخدم Umbraco Cloud، يجب أن يتم النشر تلقائيًا. بالنسبة لـ Umbraco المستضاف ذاتيًا، قد تحتاج إلى إعادة تشغيل التطبيق أو مسح ذاكرة التخزين المؤقت.
Weebly