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

الفئات

المستوى الثاني في الشجرة: كل فئة تنتمي لـ Super Category وتحتوي على منتجات ومواصفات فنية. فئات الإنارة مثلاً: Panel Lights، Bulbs، LED Strips…

المجموعة: Products & Categories اسم القائمة: Categories الرابط: /admin/categories الأيقونة: وسم الخطوة 3 في ترتيب الإنشاء

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

الفئة هي الوعاء الفعلي للمنتجات. عند إنشاء منتج تختار فئة فيُملأ النوع الافتراضي (إن وُجد) وتظهر المواصفات الخاصة بتلك الفئة. الموقع يعرض الفئات تحت كل Super Category مع فلاتر مبنية على مواصفاتها.

الفئة ترتبط بـ Super Category بعلاقة cascade: إن حُذف الأب تُحذف الفئة وكل مواصفاتها.

الارتباطات

المورد	الحقل	الأثر
Super Categories	`super_category_id` — مطلوب	التصنيف الأب. حذف الأب يحذف الفئة.
Product Types	`default_product_type_id` — اختياري	يُملأ نوع المنتج تلقائياً عند الإنشاء في هذه الفئة.
Products	`category_id`	المنتجات في هذه الفئة. عمود Products في الجدول.
Category Specs	`category_id`	مواصفات فنية خاصة بالفئة. تظهر في تبويب Specifications عند إنشاء/تعديل منتج. حذف الفئة يحذف مواصفاتها (cascade).
Storefront Products	`category_id`	منتجات المتجر تنتمي لفئة أيضاً. عند حذف الفئة يُفرَّغ الرابط (null).
Comparison Groups	`category_id` — اختياري	مجموعة مقارنة مرتبطة بفئة. عند حذف الفئة يُفرَّغ الرابط.
الموقع	API Categories + Filters	صفحات الفئات وفلاتر المواصفات في المتجر.

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

Create Category

Super Category *

Lighting

Name (English) *

Panel Lights

Name (Arabic)

لوحات إنارة

Default Product Type

—

Product Domain

lighting

Image

JPG/PNG/WebP

الحقول

الاسم	التقني	مطلوب؟	الشرح
Super Category	`super_category_id`	مطلوب	القسم الأب.
Name (English)	`name_en`	مطلوب	يولّد Slug.
Name (Arabic)	`name_ar`	اختياري	للعرض العربي.
Slug	`slug`	اختياري / فريد	يُولَّد تلقائياً.
Details (EN/AR)	`details_en/ar`	اختياري	وصف قصير.
Image	`image_link`	اختياري	taxonomy/categories.
Label	`label`	اختياري	تسمية إضافية حتى 50 حرفاً.
Product Domain	`product_domain`	اختياري	lighting / energy. يُستخدم كفلتر.
Default Product Type	`default_product_type_id`	اختياري	يُملأ تلقائياً عند إنشاء منتج في هذه الفئة.

فلاتر الجدول: Super Category، Product Domain، Trashed. أعمدة: صورة، Super، Name EN/AR، Domain، Car Type، Products عداد.

تبويب المواصفات (في صفحة التعديل)

عند تعديل الفئة يظهر تبويب Spec Definitions (RelationManager) يسمح بإضافة وتعديل وحذف مواصفات الفئة مباشرة. هذا بديل عن فتح شاشة Category Specs منفصلة.

خطوات العمل

تأكد من وجود Super Category.
أنشئ الفئة واربطها بالأب.
اختر Default Product Type إن أردت تعبئة النوع تلقائياً.
بعد الحفظ افتح التعديل وأضف المواصفات من تبويب Spec Definitions.

أخطاء شائعة

المشكلة	السبب	الحل
لا تظهر مواصفات عند إنشاء منتج	الفئة بلا Spec Definitions نشطة	أضف مواصفات من تعديل الفئة أو Category Specs.
حذفت الفئة وفقدت المواصفات	Cascade على specDefinitions	استعدها من Trashed أو أعد إنشاءها.
Default Product Type لا يعمل	لم تُربط الفئة بنوع	عيّن default_product_type_id.