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

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

المنصة:

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

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

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

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

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

أسهل طريقة لإضافة روبوت الدردشة هي تعديل قالب تذييل القالب الخاص بك:

الوصول إلى ملفات OpenCart عبر FTP أو مدير الملفات
انتقل إلى قالب تذييل القالب الخاص بك:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
افتح ملف التذييل للتعديل
ابحث عن وسم الإغلاق </body>
الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة
احفظ الملف
امسح ذاكرة التخزين المؤقت لـ OpenCart: Dashboard → أيقونة الترس الزرقاء (أعلى اليمين) → Refresh أو احذف محتويات system/storage/cache/

نصيحة: إذا كنت تستخدم القالب الافتراضي، فسيكون المسار catalog/view/theme/default/template/common/footer.twig. أنشئ دائماً نسخة احتياطية قبل تعديل ملفات القوالب.

بديل: استخدام خيار الكود المخصص في القالب

تتضمن العديد من قوالب OpenCart الحديثة خياراً مدمجاً للكود المخصص:

سجّل الدخول إلى لوحة إدارة OpenCart
انتقل إلى Extensions → Themes (أو Extensions → Extensions → Themes)
انقر على Edit في القالب النشط
ابحث عن قسم "Custom Code" أو "Footer Scripts" أو "Custom JavaScript"
الصق كود تضمين Asyntai
انقر على "Save"
امسح ذاكرة التخزين المؤقت

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

بديل: استخدام إضافة كود مخصص

يمكنك تثبيت إضافة مجانية من سوق OpenCart لإضافة أكواد مخصصة:

انتقل إلى سوق OpenCart
ابحث عن "Custom Script" أو "Header Footer Scripts" أو "Custom Code"
قم بتنزيل وتثبيت إضافة مناسبة
في لوحة الإدارة، انتقل إلى Extensions → Extensions → Modules
ابحث عن وحدة الكود المخصص وقم بتثبيتها
قم بتكوين الوحدة والصق كود تضمين Asyntai في قسم التذييل
احفظ وامسح ذاكرة التخزين المؤقت

مهم: يُوصى باستخدام الإضافات بدلاً من تعديل الملفات الأساسية، لأنها تبقى سليمة بعد تحديثات OpenCart. تشمل الإضافات الشائعة "Custom Script in Header & Footer" المتوفرة في السوق.

بديل: استخدام طريقة addScript (للمطورين)

للمطورين، يوفر OpenCart 3.x/4.x طريقة برمجية لإضافة الأكواد:

افتح catalog/controller/common/footer.php
أضف السطر التالي قبل $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
بالنسبة لسمة البيانات، ستحتاج إلى تعديل footer.twig لتضمينها يدوياً، أو إضافة JavaScript مضمن بعد حلقة الأكواد

ملاحظة: لكي تعمل الأداة بشكل صحيح مع سمة البيانات، فإن طريقة القالب أبسط لأن طريقة addScript لا تدعم السمات المخصصة مباشرة.

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

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

لا ترى الأداة؟ تأكد من مسح ذاكرة التخزين المؤقت لـ OpenCart. انتقل إلى لوحة الإدارة، وانقر على أيقونة الترس الزرقاء في الزاوية العلوية اليمنى، وانقر على أزرار التحديث. جرب أيضاً مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح خاص. إذا عدّلت ملف القالب الخطأ، تحقق من أن قالبك يستخدم الملف الذي عدّلته.