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

دليل خطوة بخطوة لمواقع Concrete CMS (المعروف سابقاً بـ Concrete5)

المنصة:

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

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

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

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

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

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

ادخل إلى تثبيت Concrete CMS الخاص بك عبر FTP أو مدير الملفات
انتقل إلى مجلد /application/themes/your_theme_name/
حدد موقع وافتح ملف footer.php (أو قالب التذييل المكافئ)
ابحث عن السطر الذي يحتوي على وسم الإغلاق </body>
الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة
احفظ الملف وارفعه مرة أخرى إلى خادمك إذا كنت تحرر محلياً
امسح ذاكرة التخزين المؤقت لـ Concrete CMS: Dashboard → System & Settings → Clear Cache

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

الطريقة البديلة 1: كتلة HTML (الأسهل لغير المطورين)

إذا كنت تفضل عدم تحرير ملفات القالب، يمكنك استخدام كتلة HTML المدمجة في Concrete CMS:

سجّل الدخول إلى لوحة تحكم Concrete CMS الخاصة بك
انتقل إلى الصفحة التي تريد إضافة روبوت الدردشة إليها
انقر على Edit Page (أيقونة القلم في شريط الأدوات)
انقر على Add Block في المنطقة التي تريد وضع الكود فيها
ابحث عن كتلة HTML واخترها
الصق كود تضمين Asyntai الخاص بك في محرر HTML
انقر على Add لحفظ الكتلة
انقر على Publish لجعل التغييرات مباشرة

ملاحظة: طريقة كتلة HTML رائعة لإضافة روبوت الدردشة إلى صفحات محددة. للتثبيت على مستوى الموقع، ستحتاج إلى إضافة كتلة HTML إلى كل صفحة، أو استخدام طريقة تذييل القالب الموضحة أعلاه. لا يؤثر الموضع المرئي للكتلة على مكان ظهور روبوت الدردشة - سيظهر في الزاوية السفلية اليمنى.

الطريقة البديلة 2: ملف رأس القالب

يمكنك أيضاً إضافة الكود إلى ملف رأس القالب للتثبيت على مستوى الموقع:

ادخل إلى ملفات Concrete CMS الخاصة بك عبر FTP أو مدير الملفات
انتقل إلى /application/themes/your_theme_name/
افتح ملف header.php (أو elements/header.php)
ابحث عن وسم الإغلاق </head>
الصق كود تضمين Asyntai الخاص بك قبل وسم </head> مباشرة
احفظ وارفع الملف
امسح ذاكرة التخزين المؤقت من لوحة التحكم

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

نصيحة: تأكد من تضمين عناصر الرأس المطلوبة باستخدام <?php View::element('header_required'); ?> في ملف header.php الخاص بك ليعمل Concrete CMS بشكل صحيح.

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

للمطورين الذين يريدون مزيداً من التحكم، يمكنكم إنشاء قالب صفحة مخصص:

أنشئ ملف قالب صفحة جديد في /application/themes/your_theme_name/
أو انسخ قالباً موجوداً (مثل default.php) وأعد تسميته
أضف كود تضمين Asyntai الخاص بك إلى ملف القالب قبل </body>
في لوحة تحكم Concrete CMS، انتقل إلى Pages & Themes
انقر على Page Types
اختر نوع الصفحة الذي تريد استخدام هذا القالب معه
عيّن قالبك المخصص لنوع الصفحة
ستتضمن الآن جميع الصفحات التي تستخدم نوع الصفحة هذا روبوت الدردشة

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

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

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

لا ترى الأداة؟ تأكد من مسح ذاكرة التخزين المؤقت لـ Concrete CMS (Dashboard → System & Settings → Clear Cache). جرب عرض موقعك في نافذة تصفح خاص. تأكد من حفظ ورفع جميع تغييرات الملفات. افتح وحدة تحكم المتصفح (F12) للتحقق من أي أخطاء JavaScript.