# المتغيرات المتسلسلة

**الفئة:** المنتجات  ·  **أدنى خطة:** Pro  ·  **المعرّف:** `cascading-variants`

أنشئ مجموعات متغيرات متسلسلة — مثلاً: العلامة التجارية ← الموديل. تظهر المجموعات الفرعية فقط عند اختيار الخيار الأب.

## المميزات[​](#المميزات "رابط مباشر إلى المميزات")

* مجموعات متغيرات أب-ابن
* تسلسل العلامة التجارية ← الموديل
* يعمل مع متغيرات الألوان والنصوص
* متوافق مع تتبع مخزون المتغيرات
* متوافق مع مخزون التوليفات

## متى تستخدمها[​](#متى-تستخدمها "رابط مباشر إلى متى تستخدمها")

إذا كنت تبيع حافظات الهاتف أو قطع غيار السيارات أو البطاريات البديلة أو أي شيء حيث رحلة العميل هي *"اختر علامة، ثم اختر موديلاً متوافقاً"*، فإن هذه الإضافة تنظّم المنتقي:

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

## كيف تفعّلها[​](#كيف-تفعّلها "رابط مباشر إلى كيف تفعّلها")

1. افتح **لوحة التحكم → الإضافات** على [`/dashboard/addons`](https://dzbuild.com/dashboard/addons).
2. ابحث عن **المتغيرات المتسلسلة** ضمن فئة *المنتجات*.
3. انقر **تفعيل الإضافة** (تحتاج خطة Pro).
4. افتح منتجاً على `/dashboard/products/create` أو `/dashboard/products/{id}/edit` → يظهر في قسم **المتغيرات** منتقي **يعتمد على**. وهو يظهر في المجموعة الثانية وما بعدها فقط — إذ لا يوجد أب ممكن للمجموعة الأولى.

## خطوات الإعداد[​](#خطوات-الإعداد "رابط مباشر إلى خطوات الإعداد")

ترتبط المجموعة الفرعية بـ**خيار أب واحد**، لا بمجموعة أب كاملة. لذلك تُنشئ مجموعة فرعية واحدة لكل خيار أب:

1. أنشئ المجموعة الأب **العلامة** بخيارات *Apple*، *Samsung*، *Xiaomi*.
2. أنشئ مجموعة فرعية منفصلة لكل علامة — **موديلات Apple**، **موديلات Samsung**، **موديلات Xiaomi** — تحتوي كل واحدة على موديلات تلك العلامة فقط.
3. في كل مجموعة فرعية، عيّن **يعتمد على** إلى الخيار الأب المطابق. تعرض القائمة المنسدلة المدخلات بصيغة *العلامة ← Apple*. وتركها فارغة يعني أن المجموعة ظاهرة دائماً.
4. احفظ. تعرض واجهة المتجر المجموعة الفرعية التي اختار العميل خيارها الأب فقط.

يمكن لكل مجموعة فرعية أن تعتمد على خيار أب واحد بالضبط.

## التوافق[​](#التوافق "رابط مباشر إلى التوافق")

* الإظهار/الإخفاء يعمل مع مجموعات `color` و`text` و`image_text`. لاحظ أنه في صفحات المنتجات، عند تبديل العميل للخيار الأب، يحتفظ خيار `image_text` في الفرع الذي غادره بتمييزه البصري رغم أن الاختيار نفسه قد أُلغي، لذا فضّل `color` أو `text` داخل المجموعات الفرعية المتسلسلة.
* تبديل الخيار الأب يلغي كل الاختيارات الواقعة تحته ويعيد حساب السعر المعروض فوراً.
* تتبع المخزون يبقى عاملاً في كل مستوى: مخزون الخيار، مخزون التوليفة، أو مخزون المنتج — راجع [المتغيرات](https://dzbuild.com/ar/ar/docs/selling/variants.md).
* التسلسل متعدد المستويات مدعوم: العلامة ← الموديل ← السنة. تعلن كل مجموعة فرعية عن الخيار الأب الوحيد الذي تعتمد عليه.

## أين يُطبَّق التسلسل[​](#أين-يُطبَّق-التسلسل "رابط مباشر إلى أين يُطبَّق التسلسل")

* صفحات المنتجات.
* نماذج الطلب في **صفحات الهبوط**.
* صفحة منتج قالب **Digital**، ما دامت إضافة [متغيرات المنتج الرقمي](https://dzbuild.com/ar/ar/docs/addons/digital-product.md) لا تعمل على المنتج نفسه. راجع التحذير أدناه.

لا تجمع المتغيرات المتسلسلة مع أكورديون متغيرات المنتج الرقمي في المنتج نفسه

عندما يُركَّب الأكورديون فإنه يخفي المنتقي القياسي ويعيد بناء المجموعات في قائمته الخاصة، ولا يُدرج المجموعات الفرعية المتسلسلة في تلك القائمة. عندئذٍ تُظهر إضافة التسلسل وتخفي تلك المجموعات داخل منتقٍ لم يعد المشتري يراه، فلا تظهر المجموعات الفرعية إطلاقاً ولا يستطيع المشتري اختيار الموديل.

ولا يُركَّب الأكورديون إلا إذا كان في المنتج مجموعة واحدة على الأقل غير متسلسلة. فإذا كانت كل مجموعات المنتج مجموعات فرعية متسلسلة، ينسحب الأكورديون ويبقى المنتقي القياسي ظاهراً ويعمل التسلسل كالمعتاد. أما ما بين الحالتين فمعطوب، لذا اختر في قالب `Digital` إحدى الإضافتين لكل منتج.

المجموعات الفرعية المخفية لا تمنع الطلب أبداً

لا يختار العميل إلا من المجموعات الظاهرة أمامه. العميل الذي يختار *Apple* لا يرى مجموعة *موديلات Samsung* أصلاً، ويمرّ طلبه دون أي اختيار منها.

## نصائح[​](#نصائح "رابط مباشر إلى نصائح")

* مخزون التوليفات لا يتبع التسلسل: جدول التوليفات يجمع كل خيار من كل مجموعة، بما فيها المجموعات الفرعية، فلا يقتصر على الأزواج (العلامة، الموديل) الصالحة وقد يبلغ حد 1000 توليفة. إذا كبر الجدول أكثر من اللازم، تتبّع مخزون كل خيار بدلاً من ذلك.