مقدمة

تتيح لك وحدة 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 أعلى قائمة العناصر. ويُحفظ هذا الإعداد: إذا فعّلت العرض في إحدى المجموعات، فسيبقى مفعّلًا عند فتح مجموعات فلاتر أخرى في هذا المتصفح.

في جدول 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: قيمة العنصر (ما يُمرَّر بوصفه الخيار المحدد).

تُضاف العناصر المخصصة إلى البيانات المختارة، ويمكن سحبها وإدخالها في التداخل مثل بقية العناصر. وهي تُخزَّن داخل مجموعة الفلاتر ولا تعتمد على الوحدات الأخرى.