انتقل إلى المحتوى الرئيسي

المقدمة

قم ببناء التنقل والتصفية المتعددة من شجرة فلتر محتوى محلية واحدة.

مزيد من المعلومات حول واجهة مستخدم الوحدة https://doc.oneentry.cloud/docs/category/filters

🎯 ماذا تفعل هذه الوحدة؟​

تتيح لك وحدة Filters استرجاع فلتر محتوى بواسطة علامته. فلتر المحتوى هو شجرة من العناصر المنسقة والمحلية - يمكن أن تمزج بين الصفحات والمنتجات والسمات والخصومات والمكافآت وطرق الدفع والإدخالات المخصصة في هيكل واحد.

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

📖 شرح بسيط​

فلتر المحتوى هو شجرة حيث تشير كل عقدة إلى شيء في مشروعك:

  • 📄 صفحة - رابط إلى صفحة (لها url)
  • 🛍️ منتج - إدخال منتج
  • 🏷️ سمة - سمة للتصفية بناءً عليها
  • 💸 خصم / خصم شخصي - إدخال خصم
  • 🎁 مكافأة - إدخال مكافأة
  • 💳 طريقة الدفع - طريقة دفع
  • ✏️ مخصص - إدخال مخصص قمت بتعريفه

تحمل كل عقدة معلومات محلية وقد تحتوي على children متداخلة، لذا يمكنك عرض فلاتر وقوائم متعددة المستويات مباشرة من الاستجابة.

✨ المفاهيم الأساسية​

العلامة​

كل فلتر له علامة فريدة (على سبيل المثال main). تطلب فلترًا بواسطة العلامة، وتكون الاستجابة محلية إلى رمز اللغة المطلوب.

شجرة العناصر​

مصفوفة items هي شجرة: العناصر العادية والمخصصة تعيش في نفس المصفوفة، ويمكن أن تحتوي كل عقدة على children. قم بالتنقل في الشجرة لعرض واجهة المستخدم الخاصة بك.

📋 ما تحتاج إلى معرفته​

  • مرر langCode للحصول على الفلتر محليًا إلى لغة معينة (الإعداد الافتراضي هو en_US).
  • تكشف عقد الصفحات (type: "page") عن url؛ تستخدم أنواع العقد الأخرى marker للإشارة إلى كيانها.
  • يحمل حقل value قيمة عقدة موحدة (على سبيل المثال قيمة الخصم أو عنوان السمة) عند الاقتضاء.

📊 جدول مرجعي سريع​

الطريقةالوصف
getFilterByMarker()احصل على فلتر محتوى بواسطة علامته

❓ الأسئلة الشائعة (FAQ)​

من أين تأتي فلاتر المحتوى؟​

تتم تكوين فلاتر المحتوى في لوحة إدارة OneEntry. يسترجع SDK هذه الفلاتر للقراءة فقط بواسطة العلامة.

كيف يمكنني عرض فلتر متعدد المستويات؟​

قم بالتنقل بشكل متكرر في مصفوفة items - قد تحتوي كل عقدة على مصفوفة children بنفس شكل العقدة.

🎓 أفضل الممارسات​

  • قم بالإشارة إلى الفلاتر بواسطة العلامة، وليس بواسطة عنوان العرض.
  • اطلب الفلتر بلغة المستخدم الحالية عبر langCode.
  • قم بتخزين الفلاتر في الذاكرة - فهي تتغير نادرًا.

تعريف وحدة Filters​


const { Filters } = defineOneEntry(
  "your-project-url", {
    "token": "your-app-token"
  }
);

🔗 الوثائق ذات الصلة​