---
title: كيفية تثبيت الوكيل على ووردبريس و ووكومرس
description: ثلاث طرق لإدراج الكود في ووردبريس، كيف يقرأ الوكيل كتالوج ووكومرس، ماذا تفعل مع إضافات التخزين المؤقت، وكيف تربط الدردشة بسلة التسوق.
section: platforms
keywords: WordPress, WooCommerce, تثبيت وكيل WordPress, إضافة وكيل WooCommerce, دردشة AI للمتاجر, وكيل مبيعات ذكي, ربط شات بسلة التسوق, إضافة كود في WordPress, footer.php, حلول كاش WordPress, وكيل ذكاء اصطناعي لموقع, دردشة فورية للمتاجر الإلكترونية
updated: 2026-09-06
---
على ووردبريس، يمكن إدراج الكود بثلاث طرق. اختر الطريقة التي تناسب مستوى راحتك مع تعديل ملفات القالب.

## الطريقة 1: إضافة إدراج الكود (موصى بها)

هذا هو الخيار الأكثر أمانًا: لن تفقد التعديلات عند تحديث القالب.

1.  قم بتثبيت أي إضافة لإدراج السكربتات: WPCode, Insert Headers and Footers, Code Snippets.
2.  افتح إعدادات الإضافة وابحث عن الحقل المخصص للكود في تذييل الصفحة — عادة ما يُسمى **Footer** أو **Body (before closing tag)**.
3.  الصق السطر من لوحة التحكم واحفظ التغييرات.

## الطريقة 2: ملف القالب

1.  **«المظهر» ← «محرر ملفات القالب»**.
2.  افتح ملف `footer.php`.
3.  الصق الكود قبل وسم `</body>`.
4.  حدّث الملف.

هام: عدّل القالب الفرعي. عند تحديث القالب الرئيسي، سيتم استبدال الملف مع الكود الخاص بك.

## الطريقة 3: عبر `functions.php`

لمن يفضلون التعامل مع الكود. في ملف `functions.php` الخاص بالقالب الفرعي:

```php
add_action('wp_footer', function () {
    echo '<script src="https://comag.vibevox.pro/widget.js" data-slug="your-slug" async></script>';
});
```

احصل على سطر السكربت الدقيق من لوحة التحكم، باستخدام زر «نسخ الكود».

## الكتالوج من WooCommerce

حدد عنوان الموقع في الإعدادات وشغّل التحليل. يقرأ الزاحف منتجات WooCommerce عبر البيانات المنظمة للصفحات: الاسم، السعر، التوفر، الوصف، الصور، الفئات.

ما يجب معرفته:

-   **المنتجات المتغيرة** تظهر في بطاقة المنتج مع نطاق الأسعار والخصائص.
-   **المنتجات المخفية والمسودات** لا تُقرأ — وهذا أمر طبيعي.
-   **المنتجات المخصصة للمستخدمين المسجلين فقط** لن يراها الوكيل: فهو يتصفح الموقع كزائر عادي.
-   إذا كان لديك تصدير للمنتجات بصيغة CSV، يمكنك رفعها في قسم «الكتالوج» — أحيانًا يكون هذا أسرع وأكثر دقة من الزحف.

## سلة التسوق والدفع

في WooCommerce، لا يتم عادةً تضمين الدفع في الدردشة: فالمتجر لديه نظام دفع خاص به يشمل الشحن والضرائب والقسائم.

حدد رابط سلة التسوق في الإعدادات، غالبًا ما يكون `https://نطاقك/السلة` أو `/السلة`. سيوجه الوكيل المشتري إلى هناك.

لمعرفة أي المحادثات تتحول إلى طلبات، أضف جزءًا من بكسل الشراء إلى صفحة «شكرًا على طلبك». في WooCommerce، هذا هو قالب `checkout/thankyou.php` أو نفس إضافة إدراج الكود مع شرط خاص بصفحة الطلب.

## زر الدردشة يضيف المنتج إلى سلة تسوق WooCommerce

بطاقات المنتجات في ردود الوكيل ليست مجرد صور للزينة. لكل منها رابط لصفحة المنتج في متجرك، ويعرف الوكيل كيفية استخدام آلية WooCommerce القياسية للإضافة إلى سلة التسوق: بعنوان على شكل `?add-to-cart=123`.

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

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

شيء آخر يجب معرفته: يرى الوكيل الصفحة التي فُتحت عليها الدردشة. يقرأ ترميز المنتج — الاسم، رقم المنتج، السعر — ويجيب في السياق. يقف الزائر على بطاقة المنتج ويكتب «هل يوجد أرخص؟» — يفهم الوكيل ما يجب مقارنته به، ويقدم بديلاً من كتالوجك، وليس نصيحة عامة.

السبب الرئيسي لعدم ظهور «الودجت» في ووردبريس هو الكاش. بعد إدراج الكود:

1.  امسح ذاكرة التخزين المؤقت للإضافة: WP Rocket, W3 Total Cache, LiteSpeed أو أي إضافة أخرى تستخدمها.
2.  امسح ذاكرة التخزين المؤقت لشبكة CDN، إذا كنت تستخدم Cloudflare.
3.  تحقق من الموقع في وضع التصفح المتخفي.

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

## المظهر الفاتح والداكن

الودجت يدعم كلا المظهرين. في الإعدادات، يمكنك اختيار المظهر الفاتح، الداكن، أو «حسب إعدادات الزائر» — الأخير يتبع إعدادات النظام للجهاز وهو الخيار الافتراضي.

هذا مفيد إذا كان قالب ووردبريس الخاص بك يحتوي على مفتاح للوضع الليلي والنهاري: اترك الخيار «حسب إعدادات الزائر»، وستتطابق الدردشة مع ما اختاره الشخص بالفعل.

## إضافات التخزين المؤقت

## التحقق

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

## الأسئلة الشائعة

### هل أحتاج إضافة Commerce Agents منفصلة؟

لا. يكفي سطر واحد من الكود، ولا يلزم تثبيت إضافة منفصلة.

### لم يظهر الودجت، ما الذي يجب التحقق منه أولاً؟

الكاش: إضافة التخزين المؤقت وشبكة CDN. ثم — تأكد من أن الكود تم إدراجه في تذييل الصفحة، وليس في ودجت جانبي عشوائي، وأن القالب يقوم بالفعل بإخراج `wp_footer()`.

### هل سيعرف الوكيل عن الخصومات والقسائم؟

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

### هل سيؤدي هذا إلى إبطاء الموقع؟

السكربت غير متزامن، وخفيف الوزن ولا يحجب عرض الصفحة. تأثيره على PageSpeed ضئيل.

### هل يمكن عرض الودجت في المتجر فقط، وليس في المدونة؟

نعم، إذا تم إدراج الكود عبر إضافة بشروط عرض معينة أو في `functions.php` مع التحقق من `is_woocommerce()`. في الحالة البسيطة، لا يسبب الوكيل أي إزعاج على جميع الصفحات: فهو يجيب أيضًا على أسئلة حول الشحن من المدونة.