مقدمة

تتيح لك وحدة Filters إنشاء مجموعات الفلاتر - مجموعات مسماة تجمع البيانات من وحدات مختلفة في النظام في قائمة واحدة قابلة للإدارة.

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

الفكرة الرئيسية من الوحدة هي أنك لا تحتاج إلى تكرار البيانات يدويًا. في مجموعة الفلاتر، تضيف روابط إلى الكيانات الموجودة بالفعل (المنتجات، الصفحات، الخصومات، إلخ)، وعند الحاجة، يمكنك إضافة قيم عشوائية خاصة بك.

إنشاء مجموعة فلاتر

لإنشاء مجموعة فلاتر جديدة:

1. افتح وحدة Filters في القائمة اليسرى.
2. تحت قائمة المجموعات، يوجد نموذج Create Filter. املأ فيه حقلين:
   • Name - اسم مجموعة الفلاتر؛
   • Marker - معرف فريد يمكن من خلاله الحصول على المجموعة في كود التطبيق.
3. اضغط على Add - ستظهر المجموعة في القائمة.
4. افتح المجموعة باستخدام زر التحرير: سيتاح لك اختيار أنواع العناصر التي ستدخل في الفلتر.

أنواع العناصر

بعد إنشاء المجموعة، تختار البيانات من أي أنواع ستشارك في الفلتر. كل نوع هو جدول بيانات يتكون من السجلات التي تم إنشاؤها بالفعل في الوحدات المعنية في النظام:

• Pages - صفحات المشروع.
• Products - منتجات الكتالوج.
• Admins - مدراء النظام.
• Attribute - السمات من مجموعات السمات.
• Discounts - الخصومات.
• Personal Discounts - الخصومات الشخصية (الفردية).
• Bonuses - المكافآت.
• Payment Methods - طرق الدفع.

عند اختيار النوع، تحصل على جدول بالسجلات الحالية من هذه الوحدة وتحدد فيه العناصر التي يجب أن تدخل في مجموعة الفلاتر. وبالتالي، يعتمد الفلتر دائمًا على البيانات الحقيقية للنظام.

معلومات

العناصر في جداول الأنواع هي روابط إلى السجلات الموجودة في وحدات أخرى. إذا تم تغيير السجل الأصلي (مثل منتج أو خصم)، ستعرض مجموعة الفلاتر بياناته الحالية.

تكوين الفلتر - العناصر المخصصة

بالإضافة إلى البيانات من الوحدات الأخرى، يمكن إضافة قيم عشوائية خاصة إلى مجموعة الفلاتر. هذا مفيد عندما لا يوجد العنصر المطلوب في أي وحدة - على سبيل المثال، الخيارات "الكل"، "بدون فئة" أو أي قيم خدمية.

عند التبديل إلى عرض Configure Filter، يتم فتح جدول بالبيانات المختارة للمجموعة. في هذا العرض، لا تختار سجلات جديدة، بل تقوم بتكوين كيفية ترتيب العناصر المختارة وتجميعها في الفلتر النهائي.

يتم تفعيل العرض من خلال علامة Configure Filter فوق قائمة العناصر. يتم حفظ الاختيار: إذا تم تفعيل العرض في مجموعة واحدة، سيبقى مفعلًا عند فتح مجموعات فلاتر أخرى في نفس المتصفح.

في جدول Configure Filter، تتوفر الإجراءات التالية:

• السحب والإفلات (drag-and-drop) - يمكن سحب الصفوف وتغيير ترتيبها. بهذه الطريقة، تحدد الترتيب الذي ستظهر به العناصر للمستخدم.

• بناء التداخل - من خلال سحب صف داخل آخر، يمكنك إنشاء عناصر متداخلة (هيكل هرمي). هذا يسمح بتجميع الفلاتر حسب المستويات - على سبيل المثال، الفئة الأم والقيم المتداخلة فيها.

• نقل العناصر المختارة - طريقة ثانية لبناء التداخل، مريحة لعدة صفوف في وقت واحد:

  1. اضغط على Select items - ستظهر علامات اختيار بجانب الصفوف. حدد العناصر المطلوبة؛ زر Select All يحدد الكل، وعدد Selected يظهر عدد العناصر المختارة.
  2. اضغط على Attach to parent.
  3. في نافذة Choose parent for transfer، اضغط على العنصر الذي سيصبح الوالد، أو اختر To root (top level) لنقل العناصر إلى المستوى الأعلى، ثم أكد بالضغط على زر Move. يتم نقل العناصر المختارة مع عناصرها المتداخلة.

  زر Cancel يخرج من وضع الاختيار دون نقل.

إضافة عناصر مخصصة

يمكنك إضافة قيم عشوائية خاصة مباشرة في هذا الجدول - وهذا مفيد عندما لا يوجد العنصر المطلوب في أي وحدة (مثل الخيارات "الكل"، "بدون فئة" أو القيم الخدمية).

1. اضغط على Add Custom Item لإضافة عنصر جديد.
2. املأ حقلين:
   • Title - الاسم المعروض للعنصر (ما سيراه المستخدم).
   • Value - قيمة العنصر (ما سيتم تمريره كخيار مختار).

تضاف العناصر المخصصة إلى البيانات المختارة بالفعل وتشارك أيضًا في السحب والإفلات وبناء التداخل. يتم تخزينها داخل مجموعة الفلاتر ولا تعتمد على الوحدات الأخرى.