← العودة للفهرس

مجموعات المقارنة

تجميع منتجات المتجر لميزة «قارن» على الموقع. يعمل مع مواصفات الفئة المعلّمة is_comparable.

المجموعة: Products & Categories اسم القائمة: Comparison Groups الرابط: /admin/comparison-groups الأيقونة: ميزان اختياري — الخطوة 8

الغرض ومنطق العمل

ثلاث خطوات للمقارنة على الموقع:

  1. أنشئ Comparison Group (اختياري: اربطها بـ Category).
  2. في Category Specs فعّل Comparable على المواصفات المراد مقارنتها (واط، فولت…).
  3. في Storefront Products عيّن comparison_group_id لكل منتج تريد مقارنته.

الموقع يقارن المواصفات المشتركة القابلة للمقارنة بين منتجات نفس المجموعة.

الارتباطات

الموردالحقلالأثر
Categories category_id — اختياري ربط المجموعة بفئة. حذف الفئة يُفرّغ الرابط.
Storefront Products comparison_group_id عدد Products في الجدول = storefront_products_count.
Category Specs is_comparable تحدد أي حقول تظهر في جدول المقارنة.
API V2 compare + compare-suggestions POST compare، GET compare-suggestions.

صورة تقريبية — النموذج

Create Comparison Group
Create group → assign Storefront Products → mark specs Comparable
Panel Lights
Panel Lights Compare
مقارنة لوحات
panel-lights-compare
✓
1

الحقول

الاسمالتقنيمطلوب؟الشرح
Categorycategory_idاختياريتنظيم إداري. المقارنة تعمل عبر comparison_group_id.
Namenameمطلوبيولّد slug.
Name ARname_arاختياري—
Slugslugاختياري / فريد—
Descriptiondescriptionاختياري—
Activeis_activeافتراضي true—
Sort Ordersort_orderافتراضي 1الجدول قابل لإعادة الترتيب.

فلاتر: Category، Active. أعمدة: Name، Active، Sort، Products count. Edit / Delete.

كيف تعمل المقارنة على الموقع

APIالوظيفة
GET …/products/{slug}/compare-suggestions منتجات أخرى في نفس comparison_group_id.
POST …/products/compare يستقبل storefront_product_ids. يجمع المواصفات حيث is_comparable=true المشتركة بين الفئات.
بدون is_comparable على Category Specs لن تظهر حقول في جدول المقارنة حتى لو المنتجات في نفس المجموعة.

خطوات العمل

  1. Comparison Groups → + New → Name → Category (اختياري) → Active.
  2. Category Specs → عدّل مواصفات الفئة → فعّل Comparable (و Wattage، Voltage…).
  3. Storefront Products → Edit → Comparison Group → اختر المجموعة.
  4. كرّر للمنتجات المراد مقارنتها في نفس المجموعة.
  5. تحقق من compare-suggestions و compare على الموقع.

أخطاء شائعة

المشكلةالسببالحل
المقارنة فارغةلا specs is_comparableفعّل Comparable على Category Specs.
منتج لا يظهر في الاقتراحاتcomparison_group_id مختلف أو nullعيّن نفس المجموعة.
حقول مختلفة بين منتجينفئات مختلفة بspecs مختلفةAPI يعرض المشترك فقط. وحّد الفئة أو المواصفات.