توثيق موصي المنتجات والحزم بالذكاء الاصطناعي لووكومرس
دليل موصي المنتجات والحزم بالذكاء الاصطناعي لووكومرس: وصل حساب الذكاء الاصطناعي، وفهرسة المنتجات، وعدّ الطلبات، والترتيب، والمعاينة، وأقسام المتجر، والتثبيت والاستبعاد، وأسطر الشرح، والإعدادات، والأداء المقاس.
يشرح الإصدار 1.0.0حُدّث في 29 أكتوبر 2026
ابدأ من هنا
ماذا تحصل عليه
| الميزة | ما تفعله |
|---|---|
| تشابه المعنى | يُضمَّن عنوان كل منتج منشور وتصنيفاته ووسومه وخصائصه الظاهرة وأوصافه على دفعات؛ وتُحسب أكثر المنتجات تشابهًا مع كل منتج على خادمك وتُحفظ. |
| يُشترى معًا | يُعدّ محليًا من طلباتك المكتملة (HPOS أو التخزين القديم للطلبات، عبر واجهة الطلبات في ووكومرس). ولا تُحفظ إلا أزواج المنتجات والأعداد. |
| المزج | وزنان للمنتجات ذات الصلة ووزنان للحزم وصفحة السلة، وحد أدنى للتشابه وحد أدنى لعدد الطلبات. |
| العرض | وضع تلقائي في صفحة المنتج (استبدال منتجات ووكومرس ذات الصلة أو إضافة قسم)، وفي صفحة السلة، واختياريًا في صفحة استلام الطلب، مع مكوّن ورمز مختصر. |
| أضف الكل إلى السلة | يُفحص كل منتج من جديد على الخادم: من الحزمة، ظاهر، قابل للشراء، متوفر؛ والمنتجات المتغيرة تحتاج خيارًا؛ والكميات محدودة. والأسعار من ووكومرس. |
| المعاينة | لأي منتج: المنتجات ذات الصلة والحزمة مع النتيجة ونسبة التشابه وعدد مرات الشراء معًا، والمنتجات المستبعدة مع السبب. |
| القواعد | استبعاد تصنيفات ووسوم ومنتجات والمنتجات النافدة؛ ولا تظهر أبدًا المنتجات المخفية والخاصة والمسودات والمحمية بكلمة مرور؛ والتثبيت لكل منتج يتجاوز قواعد الاستبعاد. |
| البديل | منتجات ذات صلة بالتصنيف والوسم حين لا توجد بيانات ذكاء اصطناعي أو طلبات، أو حين يتعطل الذكاء الاصطناعي. |
| سطر الشرح | اختياري ومعطّل افتراضيًا: سطر قصير لكل حزمة يُكتب مرة ويراجعه شخص. |
| الخصوصية | لا تتبع للزوار، ولا ملفات تعريف ارتباط للإضافة، ولا تُحفظ بيانات العملاء ولا تُرسل. |
| العربية | الإضافة وهذا الدليل بالإنجليزية والعربية؛ ولوحة التحكم تعمل من اليمين إلى اليسار. |
المتطلبات
| البند | التفاصيل |
|---|---|
| ووردبريس | 6.0 أو أحدث |
| PHP | 7.4 أو أحدث |
| ووكومرس | 8.0 أو أحدث (متوافق مع HPOS ومع الدفع بالكتل) |
| أيضًا | نموذج تضمين (مثلًا text-embedding-3-small لدى OpenAI) لتشابه المعنى. لا تقدّم أنثروبيك واجهة للتضمينات: استخدم مزوّدًا متوافقًا مع OpenAI للتضمينات. وبلا أي ذكاء اصطناعي تبقى أعداد «يُشترى معًا» والبديل تعمل. |
| مزوّد ذكاء اصطناعي | حساب ومفتاح واجهة لدى خدمة متوافقة مع OpenAI (OpenAI أو OpenRouter أو Azure أو خادم محلي مثل Ollama...) أو لدى أنثروبيك. تدفع لمزوّدك مقابل ما تستخدمه؛ ولا رسوم استخدام في الإضافة. |
| الرخصة | GPL-2.0-or-later |
التثبيت
- فُكّ ضغط الحزمة التي نزّلتها. بداخلها
ai-product-recommender-and-bundles-for-woocommerce.zip(لا تفكّ هذا الملف). - في ووردبريس افتح الإضافات ← أضف جديدًا ← رفع إضافة واختر
ai-product-recommender-and-bundles-for-woocommerce.zipواضغط التثبيت الآن. - اضغط تفعيل الإضافة. يجب أن يكون ووكومرس مفعّلًا.
- افتح الإعدادات ← موصي المنتجات بالذكاء الاصطناعي ← الاتصال بالذكاء الاصطناعي واختر المزوّد والصق مفتاح الواجهة واضغط اختبر الاتصال.
صِل الذكاء الاصطناعي
| الحقل | المعنى |
|---|---|
| المزوّد | متوافق مع OpenAI (OpenAI وOpenRouter وAzure وGroq وOllama وLM Studio...) أو أنثروبيك. |
| عنوان الواجهة | اتركه فارغًا للعنوان الرسمي. ولخدمة أخرى اكتب عنوانها، مثلًا http://localhost:11434/v1. |
| مفتاح الواجهة | يُحفظ في قاعدة بياناتك (ولا يظهر ثانية). ويمكنك تعريفه في wp-config.php فيختفي الحقل. |
| النموذج | اسم النموذج لدى مزوّدك. يكفي نموذج صغير رخيص لأغلب المهام. |
| أقصى طول للإجابة | يحدّ رموز الإجابة الواحدة فلا يكلّف الطلب أكثر مما تتوقع. |
| الحد اليومي | عدد الطلبات التي تجريها الإضافة في اليوم (0 = بلا حد). وعند بلوغه تتوقف الإضافة عن الطلب حتى الغد. |
| الخصوصية | يخفي عناوين البريد وأرقام الهاتف والأرقام الشبيهة ببطاقات الدفع قبل إرسال النص. |
فهرس منتجاتك
يُشترى معًا
| يُحفظ | لا يُحفظ |
|---|---|
| المنتج أ، المنتج ب، عدد الطلبات التي فيها الاثنان | العملاء والعناوين والبريد والأسعار وتواريخ الطلبات وأرقامها |
| عدد طلبات كل منتج | أي شيء عن الزوار |
كيف تُرتّب المنتجات
(وزن المعنى × التشابه + وزن يُشترى معًا × الحصة) ÷ (مجموع الوزنين). ولا يبقى منتج لم يُشترَ معه إلا إذا بلغ تشابهه الحد الأدنى للتشابه (35% افتراضيًا)، وتُهمل الأزواج التي ظهرت في أقل من طلبين.| القائمة | الأوزان الافتراضية | لماذا |
|---|---|---|
| المنتجات ذات الصلة | المعنى 70، يُشترى معًا 30 | البدائل والمنتجات القريبة |
| الحزمة والسلة | المعنى 30، يُشترى معًا 70 | منتجات يكمّل بعضها بعضًا |
المعاينة: ماذا سيُقترح ولماذا
في المتجر
| المكان | ما يُعرض |
|---|---|
| صفحة المنتج: منتجات ذات صلة | الاستبدال (افتراضي): يعرض قسم «منتجات ذات صلة» في ووكومرس منتجات الإضافة بمظهر قالبك؛ وفي قوالب المكوّنات يحتفظ المكوّن بترتيبه. الإضافة: قسم من الإضافة. لا تغيّر. |
| صفحة المنتج: الحزمة | «أكمل الإطلالة»: المنتج ومنتجان مقترحان (1-4)، مع مربعات اختيار ومجموع المنتجات المحددة وزر أضف الكل إلى السلة؛ أسفل الملخص أو أسفل زر الإضافة إلى السلة. |
| صفحة السلة | «قد تحتاج أيضًا» لكل منتجات السلة (السلة الكلاسيكية ومكوّن السلة). |
| صفحة استلام الطلب | اختياري: اقتراحات لمنتجات الطلب. |
| المكوّن والرمز المختصر | المكوّن «توصيات المنتجات بالذكاء الاصطناعي» و[tqpr_recommendations type="related|bundle|cart" product="ID" limit="4" title="..."]. |
التثبيت والاستبعاد
| القاعدة | التثبيت |
|---|---|
| المنتجات المخفية والخاصة والمسودات والمحمية بكلمة مرور | لا تظهر أبدًا، مثبّتة أم لا |
| النافدة (إعداد مفعّل افتراضيًا) | لا تظهر أبدًا، مثبّتة أم لا |
| التصنيفات والوسوم والمنتجات المستبعدة و«لا توصِ به أبدًا» | التثبيت يتجاوزها |
أسطر الشرح (اختيارية)
الإعدادات
| الخيار | المعنى |
|---|---|
| التوصيات | المفتاح الرئيسي. |
| أين تُعرض | المنتجات ذات الصلة، والحزمة ومكانها، وصفحة السلة، وصفحة استلام الطلب، وأعداد المنتجات. |
| الترتيب | الأوزان، والحد الأدنى للتشابه، وأقل عدد مرات الشراء معًا، والمكمّلات في الحزم، والبديل. |
| الاستبعادات | المنتجات النافدة وقوائم التصنيفات والوسوم والمنتجات. |
| يُشترى معًا | حالات الطلبات، والمدة، وأكبر طلب يُحسب، والعدّ التلقائي. |
| الفهرس | الفهرسة عند الحفظ، والمنتجات في كل دفعة، والنص لكل منتج، والمنتجات المشابهة المحفوظة، وساعات الذاكرة المؤقتة، والسعر للتقدير. |
| الشرح | تشغيل/إيقاف، والمراجعة، والأسطر في اليوم. |
الذاكرة المؤقتة والأداء
| الكتالوج | المقاس |
|---|---|
| 1000 منتج، حجم متجه 256 | نحو 20 ثانية من العمل في الخلفية لكل القوائم (0.017 ثانية لكل منتج) |
| 1000 منتج، حجم متجه 1536 | نحو 1.6 دقيقة (0.095 ثانية لكل منتج) |
| 10000 منتج، حجم متجه 256 | نحو 29 دقيقة (0.17 ثانية لكل منتج) |
| 10000 منتج، حجم متجه 512 | نحو ساعة (0.36 ثانية لكل منتج) |
| 10000 منتج، حجم متجه 1536 | نحو 4.5 ساعات (1.6 ثانية لكل منتج) |
| دفعة واحدة | من 2.5 إلى 3.3 ثانية، وذروة ذاكرة 42 ميغابايت أو أقل |
| زيارة صفحة | قراءة القائمة المحفوظة لمنتج: نحو 0.06 ملّي ثانية؛ ثم تُحفظ القوائم المرتبة مؤقتًا |
| عدّ 1000 طلب | 1.3 ثانية في 11 دفعة من 100 |
الحدود
| الحد | التفصيل |
|---|---|
| غير مخصّصة للزائر | تعتمد الاقتراحات على المنتجات لا على الزائر: لا تتبع ولا سجل ولا ملفات تعريف ارتباط. |
| المتاجر الجديدة | بلا طلبات يبقى جزء «يُشترى معًا» فارغًا ويعمل المعنى والبديل وحدهما. |
| خصم الحزمة | غير متضمن (انظر في المتجر). |
| المزوّدون | تحتاج التضمينات إلى واجهة متوافقة مع OpenAI؛ ويمكن لأنثروبيك كتابة أسطر الشرح فقط. |
| الدقة | قد تقترح التضمينات وأعداد الطلبات منتجات غريبة. افحص المنتجات المهمة في المعاينة واستخدم التثبيت والاستبعاد. |
| قوالب المكوّنات | يحتفظ مكوّن المنتجات ذات الصلة بترتيبه؛ ويُحدَّث قسم مكوّن السلة عند تحميل الصفحة التالي. |
| أنواع المنتجات | تقبل الحزم المنتجات البسيطة والمتغيرة؛ ولا يضيف زر أضف الكل المنتجات المجمّعة والخارجية. |
| التخزين المؤقت للصفحات | أقسام صفحة المنتج واحدة لكل الزوار ويمكن تخزينها مؤقتًا. أما قسم السلة (والمكوّن أو الرمز المختصر من نوع cart) فيعتمد على سلة الزائر: اعرضه فقط في صفحات لا تخزّنها إضافة التخزين المؤقت (تستثني إضافات التخزين المؤقت صفحتي السلة والدفع في ووكومرس افتراضيًا). ويحمل زر أضف الكل إلى السلة رمز أمان من ووردبريس صالحًا من 12 إلى 24 ساعة: اجعل مدة تخزين صفحات المنتجات أقل من 12 ساعة، وإلا طلب الزر من الزائر إعادة تحميل الصفحة. |
| لقطات الشاشة | التُقطت الصور على متجر أثاث تجريبي بطلبات تجريبية وخدمة تضمين اختبارية ثابتة (ليست نموذج ذكاء اصطناعي حقيقيًا). فالنتائج المعروضة للتوضيح؛ وتعتمد النتائج الحقيقية على نموذجك ومنتجاتك وطلباتك. |
الخصوصية
من يفعل ماذا
| من | يستطيع |
|---|---|
| المسؤولون | تغيير الإعدادات والاتصال بالذكاء الاصطناعي. |
| مديرو المتجر (manage_woocommerce) | الفهرسة وعدّ الطلبات والمعاينة ومراجعة الأسطر وإفراغ الذاكرة المؤقتة. |
| محررو المنتجات | التثبيت و«لا توصِ به أبدًا» للمنتجات التي يستطيعون تحريرها. |
| الزوار | رؤية الاقتراحات واستخدام أضف الكل إلى السلة (رمز أمان وفحص كل منتج). |
العربية ومن اليمين إلى اليسار
للمطورين
{prefix}tqpr_index (المتجهات) و{prefix}tqpr_similar (القوائم) و{prefix}tqpr_pairs (الأعداد) و{prefix}tqpr_pairs_build (العدّ الجاري) و{prefix}tqpr_explain (الأسطر).// The recommendations from your own code (ids, scores, reasons)
$res = TQPR_Engine::recommend( $product_id, 'bundle', 3 );
// Add a brand or any meta to the text that is embedded
add_filter( 'tqpr_product_text', function ( $text, $product ) {
return $text . "\nBrand: " . $product->get_meta( 'brand' );
}, 10, 2 );
// Never recommend some products (return a short reason)
add_filter( 'tqpr_visible', function ( $ok, $product ) {
return $product->get_meta( 'b2b_only' ) ? 'b2b' : $ok;
}, 10, 2 );
// Highest quantity of one product added by the bundle button (default 10)
add_filter( 'tqpr_bundle_max_qty', function () { return 3; } );
// The key can live in wp-config.php
define( 'TQPR_AI_KEY', 'sk-...' );استكشاف الأخطاء
| المشكلة | ما العمل |
|---|---|
| اقتراحات «التصنيف أو الوسم نفسه» فقط | لا تضمينات بعد ولا أعداد: فهرس المنتجات واعدد الطلبات. |
| أجابت الخدمة بالرمز 401 | المفتاح خاطئ أو بلا صلاحية على النموذج. |
| أجابت الخدمة بالرمز 400 أو 404 | اسم نموذج التضمين أو حجم المتجه غير مقبول: اجعل حجم المتجه 0. |
| تبقى المنتجات منتظرة | تعمل المهام الخلفية مع الزيارات (WP-Cron) أو عبر Action Scheduler: انظر ووكومرس ← الحالة ← الإجراءات المجدولة، أو اضغط الزر. |
| منتج يجب ألا يظهر أبدًا | علّمه «لا توصِ به أبدًا» أو استبعد تصنيفه أو وسمه. |
| يتخطى زر أضف الكل منتجًا متغيرًا | يجب أن يختار المتسوق خيارًا من قائمته أولًا. |
التحديث والإزالة
ثبّت ملف الإصدار الجديد فوق القديم من الإضافات ← أضف جديدًا ← رفع إضافة (يعرض ووردبريس استبدال النسخة الحالية)، أو استبدل المجلد ai-product-recommender-and-bundles-for-woocommerce عبر FTP. تبقى إعداداتك والفهرس والأعداد والأسطر. ولإزالة الإضافة عطّلها ثم احذفها: تُحذف إعداداتها معها.
حذف الإضافة يحذف أيضًا جداولها الخمسة ويزيل المنتجات المثبّتة والقوائم المحفوظة ومهامها المجدولة. ولا تتغير المنتجات والطلبات أبدًا.
الدعم
المساعدة في التثبيت وإصلاح الأخطاء مشمولان لمدة 6 أشهر مع تحديثات مدى الحياة. تواصل معنا عبر صفحة السوق التي اشتريت منها الإضافة أو راسل support@taqnix.com مع إصدار ووردبريس وإصدار الإضافة ولقطة شاشة.