Mirror Smart Search

التثبيت والتفعيل وأول تشغيل

1. من «الإضافات ← أضف إضافة جديدة ← رفع إضافة» اختر ملف ZIP، ثم ثبّت وفعّل. المتطلبات: ووردبريس 6.2 أو أحدث، وWooCommerce 9.2 أو أحدث، وPHP 7.4 أو أحدث، وامتداد openssl.
2. افتح «WooCommerce ← بحث المتجر» وأدخل كود التفعيل من حسابك على mirrororg.com ← أكواد التفعيل، ثم اضغط «تفعيل».
3. بعد التفعيل تظهر الشاشة كاملة. اضغط «إعادة بناء الفهرس الآن» (تستغرق ثواني في معظم المتاجر). يُبنى الفهرس تلقائيًا أيضًا خلال دقيقة من أول تشغيل.
4. جرّب كلمة في «جرّب البحث»، مثل اسم ماركة بالعربية أو بالإنجليزية.
5. إن كان للقالب بحث فوري خاص به (Ajax search، مثل XStore وFlatsome وWoodmart) فأوقفه من إعدادات القالب، حتى لا تظهر قائمتان فوق خانة البحث.

الترخيص: ما الذي يتوقف وما الذي يبقى

بلا ترخيص مفعّل (أو بعد انتهاء الاشتراك) يتوقف:

• محرك البحث الذكي في صفحة النتائج.
• قائمة الاقتراحات الفورية.
• إعدادات «بحث المتجر» (تبقى بطاقة «الترخيص والتحديثات» وحدها).
• التحديثات.

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

الترخيص لموقع واحد لكل اشتراك. «إلغاء التفعيل» يحرّر خانة الموقع لتفعّل على موقع آخر. إن تعطّل مركز MirrorORG أو فشل الفحص الدوري لا يتوقف البحث فورًا: الحكم الموقَّع يحمل مهلة، ولا يتوقف إلا بعد انتهائها أو عند إلغاء الكود.

شاشة الترخيص يراها مدير الموقع فقط (صلاحية manage_options). مدير المتجر يرى إعدادات البحث والإحصائيات دون بطاقة الترخيص.

كيف يجد البحث المنتجات

• العربية والإنجليزية معًا: «shampoo» تجد «شامبو»، و«مزيل عرق» تجد «deodorant»، و«cerave» تجد المنتجات المكتوبة «سيرافي».
• فروق الكتابة لا تهم: أ/إ/آ/ا، ة/ه، ى/ي، ؤ/و، ئ/ي، التشكيل والتطويل، الأرقام العربية والهندية، «ال» و«بال» و«وال» و«لل» في أول الكلمة، والحروف المكررة («كرييييم» ← «كريم»)، و«210مل» ← «210 مل»، و L'Oreal ← loreal.
• تصحيح إملائي من كلمات متجرك: الكلمة التي لا تطابق شيئًا تُصحَّح إلى أقرب كلمة في أسماء منتجاتك («سيروفي» ← «سيرافي»)، وتظهر رسالة «عرضنا نتائج …» فوق النتائج.
• لا صفحة فارغة بلا داعٍ: إن منعت كلمةٌ كلَّ النتائج تُستبعد ويُعرض الأقرب لباقي الكلمات، مع ذكر الكلمة المستبعدة. وإن كانت الكلمة تطابق منتجات غير متوفرة فقط تظهر رسالة بذلك بدل «لا نتائج».
• رمز المنتج (SKU) والباركود: البحث بالرمز الكامل يفتح صفحة المنتج مباشرة، ويشمل رموز التنويعات.
• أين يبحث: اسم المنتج، والماركة، والأقسام، والخصائص، والوسوم، والرموز. ولا يبحث في وصف المنتج.
• الترتيب: مكان التطابق أولًا (الاسم ثم الماركة ثم القسم ثم الخصائص)، ثم الكلمة الكاملة قبل بدايتها قبل جزء منها، والمطابقة الحرفية قبل المرادف قبل التصحيح، والعبارة بترتيبها، ثم المتوفر قبل غير المتوفر، ثم الأكثر مبيعًا. ترتيب «حسب الصلة» هو هذا الترتيب؛ وإن اختار الزائر ترتيبًا آخر (السعر مثلًا) يبقى نفس المنتجات بترتيبه.
• إن كان خيار WooCommerce «إخفاء المنتجات غير المتوفرة» مفعّلًا فلا تظهر في النتائج ولا في الاقتراحات.

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

الفهرس

يعمل البحث على فهرس خاص (جدول {prefix}mx_search_index) بدل البحث الحرفي في جدول المقالات، ولذلك هو سريع حتى في المتاجر الكبيرة.

• يتحدّث المنتج في الفهرس تلقائيًا عند حفظه، أو تغيّر مخزونه، أو نقله إلى المهملات واسترجاعه، أو حذفه.
• تعديل قسم أو ماركة (الاسم أو الإضافة أو الحذف) يجدول إعادة بناء كاملة بعد دقيقة.
• يُعاد بناء الفهرس كاملًا كل ليلة (حوالي 01:30 بتوقيت UTC) عبر WP-Cron.
• «إعادة بناء الفهرس الآن» في الشاشة تبنيه فورًا، وتعرض البطاقة عدد المنتجات المفهرسة والمتوفرة وكلمات التصحيح والماركات المعروفة بالعربية وتاريخ آخر بناء.

إن ظهرت «الفهرس قيد البناء الآن» فهناك بناء جارٍ؛ أعد المحاولة بعد دقيقة.

قائمة الاقتراحات الفورية

تعمل على خانات البحث الموجودة في قالبك، دون كود قصير أو ودجت.

• قبل الكتابة: آخر عمليات بحث الزائر (تُحفظ في متصفحه فقط، حتى 6، ويمكنه حذفها) و«الأكثر بحثًا».
• أثناء الكتابة: «هل تقصد» عند التصحيح، ثم الماركات والأقسام المطابقة، ثم المنتجات مع الصورة والسعر والخصم و«غير متوفر»، والكلمات المطابقة مظلَّلة، ورابط «عرض كل النتائج».
• تعمل بلوحة المفاتيح (الأسهم وEnter وEsc)، والقائمة تُرسم في أعلى الصفحة فلا يقصّها رأس القالب.

من «الإعدادات ← قائمة الاقتراحات الفورية»:

• «إظهار الاقتراحات أثناء الكتابة»: أطفئه إن أردت تحسين صفحة النتائج فقط.
• «خانات البحث (CSS selector)»: اتركه فارغًا لكل خانات البحث (input[name="s"])، أو حدّد خانة بعينها مثل .header-search input[type=search]. أي بحث من هذه الخانات يفتح صفحة نتائج المنتجات.

الألوان تأتي من متغيرات CSS بادئتها --mxss-، ويمكن تجاوزها من CSS القالب.

المرادفات والبحث المقترح وأسماء الماركات

الماركات تُقرأ من تصنيف WooCommerce للماركات (product_brand). إن كان متجرك يستخدم تصنيفًا آخر للماركات فغيّره بالفلتر mxss_brand_taxonomy.

ماذا يبحث العملاء

قسم «ماذا يبحث العملاء (آخر 30 يوم)» يعرض عدد عمليات البحث والكلمات المختلفة وعمليات البحث بلا نتائج، وجدولين:

• الأكثر بحثًا: مرات البحث، ومرات فتح اقتراح من القائمة، وعدد النتائج.
• بحث بدون نتائج: فرص لإضافة منتج أو مرادف أو تصحيح اسم ماركة. اضغط أي كلمة لتجربتها في «جرّب البحث».

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

القوالب والإضافات الأخرى

• تعمل مع أي قالب يستخدم بحث ووردبريس العادي، ومع القوالب الكتلية (مثل Twenty Twenty-Five) والكلاسيكية.
• القوالب التي لها بحث فوري خاص بها: أوقفه من إعدادات القالب. إن لم يمكن إيقافه فأطفئ قائمة الاقتراحات في الإضافة، ويبقى تحسين صفحة النتائج يعمل.
• إضافات البحث الأخرى (مثل FiboSearch أو Relevanssi أو SearchWP) تغيّر صفحة النتائج أيضًا؛ استخدم إضافة بحث واحدة فقط.
• القالب الذي يتضمّن محرك البحث نفسه (قالب MediMix): تتوقف الإضافة تلقائيًا وتعرض تنبيهًا، لأن القالب يقوم بالعمل نفسه.
• متوافقة مع تخزين الطلبات عالي الأداء (HPOS).

أوامر WP-CLI

• wp mirror-search index: يعيد بناء الفهرس ويطبع عدد المنتجات وكلمات التصحيح والماركات والزمن.
• wp mirror-search search "كلمة": يطبع عدد النتائج والتصحيح والكلمات المستبعدة وأول 12 منتجًا والماركات والأقسام المطابقة.

الأوامر تعمل حين تكون الإضافة مفعّلة الترخيص.

حل المشاكل

التحديث والرجوع لإصدار سابق وإزالة الإضافة

التحديثات تصل من مركز MirrorORG: إشارة فورية عند النشر، وفحص كل ساعة احتياطيًا، وتُثبَّت تلقائيًا افتراضيًا (يمكن جعلها يدوية من «وصول التحديثات» في بطاقة الترخيص). تُطابَق بصمة الملف قبل التثبيت. التحديث يحتاج ترخيصًا مفعّلًا.

للرجوع لإصدار سابق نزّله من حسابك وارفعه من «رفع إضافة ← استبدال الحالية»؛ الفهرس والإعدادات لا تتأثر.

الإزالة: التعطيل يوقف المهام المجدولة ولا يمسح شيئًا. والحذف في هذا الإصدار لا يمسح الجداول (mx_search_index وmx_search_log) ولا الخيارات (mirror_search_*).

اللوحة بالعربية فقط في هذا الإصدار، ولم تُجرَّب الإضافة على Multisite بعد.

سجل الإصدارات

هذه التغييرات مأخوذة مباشرة من الإصدارات المنشورة على الـHub.