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

التوثيق

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

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

دليل خطوة بخطوة لمتاجر WooCommerce

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

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

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

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

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

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

أسهل طريقة لإضافة روبوت الدردشة إلى متجر WooCommerce الخاص بك هي استخدام إضافة رأس/تذييل مجانية:

  1. سجّل الدخول إلى لوحة تحكم WordPress
  2. انتقل إلى الإضافات → إضافة جديدة
  3. ابحث عن "Insert Headers and Footers" من WPCode (أو إضافة مشابهة)
  4. انقر على "Install Now" ثم "Activate"
  5. انتقل إلى Code Snippets → Header & Footer (أو صفحة إعدادات الإضافة)
  6. الصق كود Asyntai المضمّن في قسم "Footer"
  7. انقر على "Save Changes"

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

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

تحتوي العديد من قوالب WooCommerce على خيارات مدمجة لإضافة نصوص برمجية مخصصة:

  1. انتقل إلى المظهر → تخصيص
  2. ابحث عن قسم يسمى "Additional CSS/JS" أو "Custom Code" أو "Footer Scripts"
  3. الصق كود Asyntai المضمّن في الحقل المناسب
  4. انقر على "Publish" لحفظ التغييرات

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

بديل: تعديل ملفات القالب (functions.php)

للمطورين أو الذين يشعرون بالراحة في تعديل ملفات القالب:

  1. انتقل إلى المظهر → محرر ملفات القالب
  2. حدد القالب النشط (أو يفضل القالب الفرعي)
  3. افتح ملف functions.php
  4. أضف الكود التالي في نهاية الملف:
    function add_asyntai_chatbot() {
      echo '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
    }
    add_action('wp_footer', 'add_asyntai_chatbot');
  5. استبدل YOUR_WIDGET_ID بمعرف الأداة الفعلي الخاص بك
  6. انقر على "Update File"

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

بديل: خطاف WooCommerce المخصص

لتحميل روبوت الدردشة فقط على صفحات WooCommerce (المتجر، المنتج، السلة، الدفع):

  1. أضف هذا الكود إلى ملف functions.php الخاص بقالبك:
    function add_asyntai_chatbot_woocommerce() {
      if (is_woocommerce() || is_cart() || is_checkout() || is_account_page()) {
        echo '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
      }
    }
    add_action('wp_footer', 'add_asyntai_chatbot_woocommerce');
  2. استبدل YOUR_WIDGET_ID بمعرف الأداة الفعلي الخاص بك
  3. احفظ الملف

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

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

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

لا ترى الأداة؟ إذا كانت لديك إضافة تخزين مؤقت مثبتة (مثل WP Super Cache أو W3 Total Cache أو WP Rocket)، امسح ذاكرة التخزين المؤقت أولاً. جرّب أيضًا مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح خاص.