يشرح هذا الدليل نظام تصفية المواضيع المتقدم في Discourse، بما في ذلك بناء جملة لغة الاستعلام الكامل، وخيارات التصفية، وكيفية استخدام المسار
/filterبفعالية.
مستوى المستخدم المطلوب: جميع المستخدمين
استخدام لغة استعلام تصفية المواضيع في Discourse
يوفر مرشح المواضيع في Discourse لغة استعلام قوية للعثور على المواضيع بناءً على معايير متعددة. تتيح لك واجهة البحث المتقدم هذه دمج المرشحات، وفرز النتائج، وإنشاء استعلامات دقيقة لأي محتوى على منتداك.
الوصول إلى المرشح
يمكنك الوصول إلى مرشح المواضيع بطريقتين:
الوصول المباشر عبر عنوان URL:
انتقل إلى /filter على مثيل Discourse الخاص بك (على سبيل المثال: https://meta.discourse.org/filter)
التنقل من الشريط الجانبي:
انقر فوق “المزيد” في الشريط الجانبي الخاص بك، ثم حدد خيار المرشح
تتضمن واجهة المرشح نظام إكمال تلقائي ذكي يقترح المرشحات والقيم المتاحة أثناء الكتابة.
بناء جملة الاستعلام الأساسي
تستخدم المرشحات بناء جملة منظم بالصيغة:
filter-name:value
دمج مرشحات متعددة:
category:support status:open created-after:2023-01-01
تضمين مصطلحات البحث العادية:
category:support ssl certificate error
يبحث هذا عن مواضيع في فئة “الدعم” تحتوي على الكلمات “خطأ في شهادة ssl”.
مرشحات الفئات
category: (اسم مستعار: categories:)
تصفية المواضيع حسب الفئة
الاستخدام الأساسي:
category:support
category:dev,support # مواضيع في فئات dev أو support
category:documentation:admins # مواضيع في الفئة الفرعية للمسؤولين ضمن التوثيق
البادئات المتقدمة:
=- فئة بدون فئات فرعية:=category:general-- استبعاد فئة:-category:off-topic-=- استبعاد فئة بدون فئات فرعية:-=category:meta
أمثلة:
category:bug,feature # تضمين فئات الأخطاء أو الميزات (مع الفئات الفرعية)
=category:bug,feature # تضمين فئات الأخطاء أو الميزات (بدون الفئات الفرعية)
-category:bug,feature # استبعاد فئات الأخطاء أو الميزات (مع الفئات الفرعية)
-=category:bug,feature # استبعاد فئات الأخطاء أو الميزات (بدون الفئات الفرعية)
مرشحات العلامات
tag: (اسم مستعار: tags:)
تصفية المواضيع حسب العلامات (يتطلب تمكين العلامات)
الاستخدام الأساسي:
tag:bug
tag:feature,enhancement # مواضيع بعلامات feature أو enhancement
tag:bug+urgent # مواضيع بعلامتي bug و urgent معًا
الاستبعاد:
-tag:solved # استبعاد المواضيع ذات العلامة solved
-tag:bug+urgent # استبعاد المواضيع ذات العلامتين bug و urgent معًا
-tag:bug,urgent # استبعاد المواضيع ذات العلامة bug أو urgent
tag_group:
التصفية حسب مجموعات العلامات
الاستخدام الأساسي:
tag_group:moderation
-tag_group:staff-only # استبعاد المواضيع ذات العلامات من مجموعة staff-only
مرشحات التاريخ
تدعم جميع مرشحات التاريخ التواريخ المحددة (YYYY-MM-DD) والأيام النسبية:
تواريخ النشاط
activity-before:- المواضيع التي كان آخر نشاط لها قبل التاريخ المحددactivity-after:- المواضيع التي كان آخر نشاط لها بعد التاريخ المحدد
تواريخ الإنشاء
created-before:- المواضيع التي تم إنشاؤها قبل التاريخ المحددcreated-after:- المواضيع التي تم إنشاؤها بعد التاريخ المحدد
تواريخ آخر مشاركة
latest-post-before:- المواضيع التي كانت آخر مشاركة لها قبل التاريخ المحددlatest-post-after:- المواضيع التي كانت آخر مشاركة لها بعد التاريخ المحدد
أمثلة على تنسيق التاريخ:
created-after:2023-12-25 # تاريخ محدد (YYYY-MM-DD)
created-after:30 # قبل 30 يومًا
created-after:1 # بالأمس
created-after:0 # اليوم
اقتراحات سريعة:
1- الأمس7- الأسبوع الماضي30- الشهر الماضي365- العام الماضي
مرشحات المستخدم
created-by:
التصفية حسب مؤلف الموضوع
الاستخدام الأساسي:
created-by:username
created-by:user1,user2 # مواضيع بواسطة user1 أو user2
created-by:@username # البادئة @ اختيارية
المرشحات الشخصية (للمستخدمين المسجلين فقط)
in:
التصفية حسب علاقتك الشخصية بالمواضيع
الخيارات المتاحة:
in:pinned- المواضيع المثبتة لكin:bookmarked- المواضيع التي قمت بوضع إشارة مرجعية لهاin:watching- المواضيع التي تتابعهاin:tracking- المواضيع التي تتعقبهاin:muted- المواضيع التي كتمتهاin:normal- المواضيع ذات مستوى الإشعارات العاديin:watching_first_post- المواضيع التي تتابع فيها المنشور الأول فقط
أمثلة:
in:bookmarked category:support
in:watching,tracking # مواضيع تتابعها أو تتعقبها
المرشحات الرقمية
مرشحات الإعجابات
likes-min:- الحد الأدنى للإعجابات الإجمالية عبر جميع المشاركاتlikes-max:- الحد الأقصى للإعجابات الإجمالية عبر جميع المشاركاتlikes-op-min:- الحد الأدنى للإعجابات في المنشور الافتتاحيlikes-op-max:- الحد الأقصى للإعجابات في المنشور الافتتاحي
مرشحات عدد المشاركات
posts-min:- الحد الأدنى لعدد المشاركاتposts-max:- الحد الأقصى لعدد المشاركات
مرشحات المشاركين
posters-min:- الحد الأدنى لعدد المشاركينposters-max:- الحد الأقصى لعدد المشاركين
مرشحات عدد المشاهدات
views-min:- الحد الأدنى لعدد المشاهداتviews-max:- الحد الأقصى لعدد المشاهدات
أمثلة:
likes-min:10 # مواضيع حصلت على 10 إعجابات على الأقل
posts-min:5 posts-max:20 # مواضيع تحتوي على 5-20 مشاركة
views-min:100 likes-op-min:5 # مواضيع شائعة مع منشورات افتتاحية جذابة
مرشحات الحالة
status:
التصفية حسب حالة الموضوع
الحالات المتاحة:
status:open- المواضيع المفتوحة (غير مغلقة أو مؤرشفة)status:closed- المواضيع المغلقةstatus:archived- المواضيع المؤرشفةstatus:listed- المواضيع المدرجة (المرئية)status:unlisted- المواضيع غير المدرجةstatus:deleted- المواضيع المحذوفة (يتطلب إذنًا)status:public- المواضيع العامة (الفئات غير المقيدة)
الحالات الخاصة بالإضافات:
status:solved- المواضيع المحلولة (مع إضافة Solved)status:unsolved- المواضيع غير المحلولة (مع إضافة Solved)
أمثلة:
status:open category:support
status:closed created-after:30
خيارات الفرز
order:
فرز النتائج حسب معايير مختلفة
عمليات الفرز المتاحة:
order:activity- آخر نشاط (افتراضي، تنازلي)order:activity-asc- أقدم نشاط أولاًorder:created- تاريخ الإنشاء (الأحدث أولاً)order:created-asc- الأقدم أولاًorder:latest-post- تاريخ آخر مشاركة (الأحدث أولاً)order:latest-post-asc- أقدم آخر مشاركةorder:likes- أكبر عدد من الإعجابات عبر جميع المشاركاتorder:likes-asc- أقل عدد من الإعجاباتorder:likes-op- أكبر عدد من الإعجابات في المنشور الافتتاحيorder:likes-op-asc- أقل عدد من الإعجابات في المنشور الافتتاحيorder:posters- أكبر عدد من المشاركينorder:posters-asc- أقل عدد من المشاركينorder:title- أبجديًا حسب العنوانorder:title-asc- أبجديًا عكسيًاorder:views- أكبر عدد من المشاهداتorder:views-asc- أقل عدد من المشاهداتorder:category- اسم الفئةorder:category-asc- اسم الفئة عكسيًاorder:read- تاريخ آخر قراءة (للمستخدمين المسجلين)order:read-asc- أقدم قراءة أولاً
أمثلة متقدمة
العثور على مناقشات حديثة وشائعة:
created-after:7 likes-min:10 order:likes
مواضيع الدعم التي تحتاج إلى اهتمام:
category:support status:open posts-max:3 created-after:7
مواضيع التطوير التي قمت بوضع إشارة مرجعية لها:
category:dev in:bookmarked order:activity
استبعاد تقارير الأخطاء المحلولة:
category:bug -tag:solved status:open order:created
مواضيع ذات تفاعل عالٍ من مستخدمين محددين:
created-by:admin,moderator likes-min:5 views-min:100
المواضيع غير المدرجة الحديثة (للموظفين فقط):
status:unlisted created-after:30 order:created
ميزات الإكمال التلقائي
يوفر إدخال المرشح اقتراحات ذكية:
- اقتراحات المرشحات - يعرض المرشحات المتاحة أثناء الكتابة
- الإكمال التلقائي للفئات - يقترح الفئات حسب الاسم أو المعرف (slug)
- الإكمال التلقائي للعلامات - يقترح العلامات مع عدد المشاركات
- الإكمال التلقائي لأسماء المستخدمين - يقترح أسماء المستخدمين مع أسماء العرض
- اقتراحات التاريخ - يقدم خيارات تاريخ سريعة (الأمس، الأسبوع الماضي، إلخ)
- دعم البادئات - يعرض خيارات البادئات للفئات والعلامات
نصائح وأفضل الممارسات
- استخدم الإكمال التلقائي - توفر واجهة المرشح اقتراحات ذكية أثناء الكتابة
- اجمع بين المرشحات - امزج أنواعًا مختلفة من المرشحات للحصول على نتائج دقيقة
- شارك عناوين URL للمرشحات - عناوين URL للمرشحات قابلة للمشاركة - انسخ عنوان URL لمشاركة بحثك
- أضف مرشحات مفيدة إلى الشريط الجانبي الخاص بك - يمكن إضافة عناوين URL للمرشحات إلى الشريط الجانبي الخاص بك لسهولة الوصول
- استخدم الاستبعاد - استخدم البادئة
-لاستبعاد النتائج غير المرغوب فيها - اختصارات التاريخ - استخدم الأرقام للتواريخ النسبية (30 = قبل 30 يومًا)
- التنقل باستخدام لوحة المفاتيح - استخدم مفاتيح الأسهم للتنقل بين الاقتراحات، و Tab/Enter للاختيار
إنشاء روابط مخصصة للشريط الجانبي
يمكنك إضافة روابط المرشحات إلى الشريط الجانبي الخاص بك كروابط مخصصة:
- انتقل إلى إعدادات الشريط الجانبي الخاص بك
- أضف رابطًا مخصصًا بعنوان URL للمرشح مثل
/filter?q=category:support status:open - أعطه اسمًا وصفيًا مثل “مواضيع الدعم المفتوحة”
ملاحظات فنية
- يستخدم المرشح البحث النصي الكامل للكلمات الرئيسية مع المرشحات
- يطبق الحد الأدنى لطول مصطلح البحث على عمليات البحث عن الكلمات الرئيسية
- النتائج مدركة للأذونات - أنت ترى فقط المواضيع التي يمكنك الوصول إليها
- تتم معالجة استعلامات المرشحات من جانب الخادم لتحسين الأداء
- تدعم الميزة ملحقات الإضافات للمرشحات المخصصة