يشرح هذا الدليل كيفية استخدام سلاسل الاستعلام للحصول على طرق عرض مواضيع مخصصة ومفلترة على أي موقع Discourse. يمكن لجميع المستخدمين استخدام سلاسل الاستعلام لعرض قوائم مواضيع محددة، وإنشاء روابط مخصصة لقوائم مواضيع فريدة، والبحث عن مواضيع تلبي معايير محددة.
مستوى المستخدم المطلوب: جميع المستخدمين
تعد سلاسل الاستعلام نصًا يمكنك إلحاقه بنهاية معظم عناوين URL الخاصة بـ Discourse للحصول على عرض مخصص ومفلتر للمواضيع. يمكن أن تكون مفيدة لعرض قوائم مواضيع محددة، وإنشاء روابط مخصصة لقوائم مواضيع فريدة، والبحث عن مواضيع تلبي معايير محددة.
فهم سلاسل الاستعلام
تتم إضافة سلسلة استعلام إلى نهاية عنوان URL، بدءًا بعلامة استفهام (?)، متبوعة بمعلمات وقيمها. على سبيل المثال:
https://meta.discourse.org/?status=open
في عنوان URL هذا، ?status=open هي سلسلة الاستعلام.
ستظل قائمة المواضيع التي تراها عند استخدام سلاسل الاستعلام مقصورة على المواضيع التي يمكن الوصول إليها بواسطة حساب المستخدم الخاص بك. لا يلزم تمكين أي إعدادات لاستخدام سلاسل الاستعلام.
معلمات سلسلة الاستعلام المتاحة
فيما يلي معلمات سلسلة الاستعلام التي يمكنك استخدامها على جميع مواقع Discourse:
الحالة
استخدم ?status=_ لعرض المواضيع ذات حالة محددة:
open: المواضيع المفتوحة فقطclosed: المواضيع المغلقة فقطarchived: المواضيع المؤرشفة فقطunlisted: المواضيع غير المدرجة فقطdeleted: المواضيع المحذوفة فقط
البحث
استخدم ?search=_ لإنشاء صفحة كاملة لنتائج البحث. استبدل _ بمصطلحات البحث الخاصة بك.
الحالة
استخدم ?state=_ لعرض المواضيع ذات حالة محددة:
muted: عرض المواضيع التي كتمتهاnormal: عرض المواضيع التي قمت بتعيينها على عاديtracking: عرض المواضيع التي تتعقبهاwatching: عرض المواضيع التي تراقبها
ترتيب تصاعدي
استخدم ?ascending=true لعرض المواضيع حسب التاريخ بترتيب تصاعدي. الافتراضي هو الترتيب التنازلي.
الترتيب
استخدم ?order=_ لعرض المواضيع بترتيب تنازلي حسب معايير مختلفة:
likes: حسب عدد الإعجاباتop_likes: حسب الإعجابات في المنشور الأصليviews: حسب المشاهداتposts: حسب عدد المشاركات (الردود)activity: حسب تاريخ آخر نشاط (يشمل تاريخbumped_at)posters: حسب عدد المشاركينcategory: حسب اسم الفئة (من Z إلى A)created: حسب تاريخ إنشاء الموضوع (أحدث المواضيع أولاً)
عوامل تصفية عدد المشاركات
?max_posts=_: يعرض المواضيع التي تحتوي على عدد مشاركات يساوي_أو أقل?min_posts=_: يعرض المواضيع التي تحتوي على عدد مشاركات يساوي_أو أكبر
معرفات المواضيع
استخدم ?topic_ids=_ لعرض قائمة بالمواضيع ذات المعرفات المحددة. يقبل سلسلة من معرفات المواضيع مفصولة بفواصل.
الفئة
استخدم ?category=_ لعرض قائمة بالمواضيع لفئات محددة. يقبل سلسلة من أرقام معرفات الفئات مفصولة بفواصل.
العلامات
استخدم ?tags=_ لتصفية المواضيع حسب العلامات. على سبيل المثال، https://meta.discourse.org/?tags=how-to سيعرض جميع المواضيع التي تحمل علامة how-to.
معلمات خاصة بالإضافات
تضيف بعض الإضافات معلمات سلسلة استعلام إضافية:
إضافة الحل
إذا قمت بتثبيت إضافة Solved:
?solved=yes: عرض المواضيع المحلولة?solved=no: عرض المواضيع غير المحلولة
إضافة التعيين
إذا قمت بتثبيت إضافة Assign:
?assigned=username: عرض جميع المواضيع المعينة لمستخدم معين?assigned=*: عرض جميع المواضيع المعينة لجميع المستخدمين?assigned=me: عرض جميع المواضيع المعينة للمستخدم الحالي?assigned=nobody: عرض جميع المواضيع غير المعينة
دمج سلاسل الاستعلام
يمكنك دمج سلاسل استعلام متعددة باستخدام الرمز العطف (&). عند استخدام سلاسل استعلام متعددة، يلزم وجود الرمز ? للمعلمة الأولى فقط. على سبيل المثال:
https://meta.discourse.org/?max_posts=1&status=closed
سيعرض عنوان URL هذا المواضيع المغلقة التي تحتوي على منشور واحد فقط.
استخدام صفحة البحث المتقدم
يمكنك أيضًا استخدام صفحة البحث المتقدم لبناء عناوين URL هذه باستخدام واجهة مستخدم رسومية ثم نسخ عنوان URL الناتج. لاحظ أن بعض عوامل تصفية البحث قد لا تعمل كمعلمات لسلسلة الاستعلام خارج سياق البحث.
