العودة إلى لوحة التحكم

التوثيق

تعلّم كيفية استخدام Asyntai

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

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

الحصول على كود التضمين

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

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

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

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

الخطوة 2: استخدام وحدة الكود المخصص (موصى به)

أسهل طريقة لإضافة روبوت الدردشة هي استخدام وحدة "Custom Code" المجانية من سوق PrestaShop Addons:

  1. سجّل الدخول إلى المكتب الخلفي لـ PrestaShop
  2. انتقل إلى Modules → Module Manager
  3. انقر على "Upload a module" أو ابحث في السوق عن "Custom Code" أو "Header Footer Scripts"
  4. قم بتثبيت وحدة مثل "Custom JS and CSS" أو ما شابهها
  5. بعد التثبيت، انتقل إلى إعدادات الوحدة
  6. ابحث عن قسم "Footer Scripts" أو "Before </body>"
  7. الصق كود تضمين Asyntai
  8. انقر على "Save"

نصيحة: تشمل الوحدات المجانية الشائعة لهذا الغرض "Custom JS and CSS Pro" و"Custom Code" و"Header and Footer Scripts". تبقى هذه الوحدات سليمة بعد تحديثات القوالب وPrestaShop.

بديل: تعديل قالب السمة (PrestaShop 1.7+/8)

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

  1. الوصول إلى ملفات PrestaShop عبر FTP أو مدير الملفات
  2. انتقل إلى مجلد القالب: themes/your_theme/templates/_partials/
  3. افتح ملف footer.tpl (أو في بعض القوالب، تحقق من templates/layouts/layout-both-columns.tpl)
  4. ابحث عن وسم الإغلاق </body> أو قسم {block name='javascript_bottom'}
  5. الصق كود التضمين الخاص بـ Asyntai قبل وسم الإغلاق </body> مباشرة
  6. احفظ الملف
  7. امسح ذاكرة التخزين المؤقت لـ PrestaShop: Advanced Parameters → Performance → Clear cache

مهم: قد يتم الكتابة فوق التغييرات على ملفات القالب عند تحديثه. فكر في استخدام قالب فرعي أو وحدة لحل أكثر استدامة.

بديل: استخدام ملف JavaScript المخصص للقالب

تتضمن العديد من قوالب PrestaShop ملف custom.js لأكوادك الخاصة:

  1. انتقل إلى: themes/your_theme/assets/js/
  2. ابحث عن ملف باسم custom.js (أنشئه إذا لم يكن موجوداً)
  3. أضف الكود التالي لتحميل روبوت الدردشة ديناميكياً:
    (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);
    })();
  4. استبدل YOUR_WIDGET_ID بمعرف الأداة الفعلي الخاص بك
  5. امسح ذاكرة التخزين المؤقت لـ PrestaShop

بديل: إنشاء وحدة بسيطة (للمطورين)

للمطورين، يمكنكم إنشاء وحدة بسيطة باستخدام خطاف displayFooter:

  1. أنشئ مجلداً: modules/asyntaichatbot/
  2. أنشئ ملف asyntaichatbot.php بهذا الكود:
    <?php
    class AsyntaiChatbot extends Module {
      public function __construct() {
        $this->name = 'asyntaichatbot';
        $this->version = '1.0.0';
        $this->author = 'Your Name';
        parent::__construct();
        $this->displayName = 'Asyntai Chatbot';
      }
      public function install() {
        return parent::install() && $this->registerHook('displayFooter');
      }
      public function hookDisplayFooter($params) {
        return '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
      }
    }
  3. استبدل YOUR_WIDGET_ID بمعرف الأداة الفعلي الخاص بك
  4. ثبّت الوحدة عبر Modules → Module Manager

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

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

لا ترى الأداة؟ تأكد من مسح ذاكرة التخزين المؤقت لـ PrestaShop: انتقل إلى Advanced Parameters → Performance → Clear cache. جرب أيضاً مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح خاص. إذا كنت تستخدم وحدة مخصصة، تحقق من تفعيلها في Module Manager.