دليل مرجعي شامل لجميع موجزات RSS المتاحة في Discourse، بما في ذلك هياكل الروابط، ومتطلبات المصادقة، وأفضل الممارسات لقارئات الموجزات.
مستوى المستخدم المطلوب: جميع المستخدمين
يُعد RSS (النشر البسيط للتجميع) تنسيقاً موحداً وقابلاً للقراءة آلياً، يتيح مشاركة المحتوى بين المواقع والمنصات بسهولة. يوفر Discourse مجموعة واسعة من موجزات RSS للمواضيع، والمشاركات، والفئات، والوسوم، والمستخدمين، والمجموعات.
روابط مستقرة: يتم تعريف روابط RSS التي تحتوي على معرّف (مثل معرّف الفئة، أو معرّف الموضوع، أو معرّف الشارة) بناءً على ذلك المعرّف. لن تتعطل الروابط في حال تغيير “المسار النصي” (الجزء النصي من الرابط)، لكن المسار النصي يظل إلزامياً في مسار الرابط.
على سبيل المثال، تؤدي هذه الروابط جميعها إلى نفس موجز RSS:
https://meta.discourse.org/t/events-plugin/69776.rsshttps://meta.discourse.org/t/a-random-slug/69776.rsshttps://meta.discourse.org/t/-/69776.rss
الشارات
الحصول على موجز لشارة محددة.
https://meta.discourse.org/badges/[id]/[badge_name].rss
الفئات
الحصول على موجز لأحدث المواضيع في فئة محددة.
https://meta.discourse.org/c/[category_slug]/[id].rss
الفئات والوسوم
الحصول على موجز للمواضيع ضمن فئة محددة والتي تحمل وسماً محدداً أيضاً.
مهم: على عكس موجزات الفئات القياسية، تستضيف موجزات الفئات+الوسوم تحت المسار
/tags/وليس/c/.
الرابط المعياري (موصى به): يستخدم المعرّف الرقمي للوسم لضمان الاستقرار.
https://meta.discourse.org/tags/c/[category_slug]/[id]/[tag_slug]/[tag_id]/l/latest.rss
الرابط القديم: يستخدم اسم الوسم فقط.
https://meta.discourse.org/tags/c/[category_slug]/[id]/[tag_name]/l/latest.rss
ملاحظة: يمكنك استبدال كلمة latest بمرشحات أخرى مثل top (الأعلى)، أو hot (الساخنة)، أو new (الجديدة)، أو unread (غير المقروءة).
المجموعات
الحصول على موجزات لنشاط المجموعات. تعمل كلا السابقتين /groups/ و /g/.
الإشارات: المواضيع التي تم الإشارة إلى المجموعة فيها.
https://meta.discourse.org/groups/[group_name]/mentions.rss
أو
https://meta.discourse.org/g/[group_name]/mentions.rss
المشاركات: جميع المشاركات التي قام بها أعضاء المجموعة.
https://meta.discourse.org/groups/[group_name]/posts.rss
أو
https://meta.discourse.org/g/[group_name]/posts.rss
المشاركات (عالمية)
الحصول على موجز لجميع المشاركات العامة عبر الموقع بأكمله.
https://meta.discourse.org/posts.rss
الوسوم
الحصول على موجز للمواضيع التي تحمل وسماً محدداً.
الرابط المعياري (موصى به): يستخدم المعرّف الرقمي للوسم لضمان الاستقرار.
https://meta.discourse.org/tag/[tag_slug]/[tag_id].rss
الرابط القديم: يستخدم اسم الوسم فقط.
https://meta.discourse.org/tag/[tag_name].rss
المواضيع
الحصول على موجزات لقوائم المواضيع.
المواضيع الساخنة: المواضيع الرائجة حالياً.
https://meta.discourse.org/hot.rss
أفضل المواضيع (حسب الفترة الزمنية): أكثر المواضيع شعبية خلال مدة محددة.
https://meta.discourse.org/top.rss?period=[period]
حيث [period] هي إحدى القيم التالية: all (الكل)، yearly (سنوي)، quarterly (ربع سنوي)، monthly (شهري)، weekly (أسبوعي)، daily (يومي).
top/yearly.rss) تعمل، لكنها تحوّل تلقائياً إلى تنسيق معلمة الاستعلام المذكور أعلاه.
أفضل المواضيع (الافتراضي): تستخدم الفترة الزمنية الافتراضية للموقع.
https://meta.discourse.org/top.rss
أحدث المواضيع: المواضيع ذات النشاط الأخير (الردود).
https://meta.discourse.org/latest.rss
ترتيب مستقر لقارئات الموجزات: افتراضياً، يتم ترتيب “الأحدث” بناءً على وقت آخر رد. هذا يعني أن ترتيب العناصر في قارئ الموجزات الخاص بك سيتغير كلما رد شخص ما على موضوع قديم. للحصول على ترتيب زمني مستقر بناءً على وقت إنشاء المواضيع، أضف
?order=created:
https://meta.discourse.org/latest.rss?order=created
موضوع واحد: موجز لموضوع محدد واحد.
https://meta.discourse.org/t/[topic_slug]/[id].rss
المستخدمون
الحصول على موجزات لنشاط مستخدم محدد. تعمل كلا السابقتين /users/ و /u/.
المشاركات: جميع المشاركات التي قام بها المستخدم.
https://meta.discourse.org/users/[username]/activity.rss
أو
https://meta.discourse.org/u/[username]/activity.rss
المواضيع: المواضيع التي أنشأها المستخدم.
https://meta.discourse.org/users/[username]/activity/topics.rss
أو
https://meta.discourse.org/u/[username]/activity/topics.rss
الموجزات المصادق عليها
تتطلب الموجزات التالية تسجيل الدخول أو توفير مفتاح API. فهي توفر عرضاً مخصصاً للمحتوى.
- المواضيع غير المقروءة: المواضيع التي لم تقم بقراءتها بعد.
https://meta.discourse.org/unread.rss - المواضيع الجديدة (شخصية): مواضيع جديدة بالنسبة لك منذ زيارتك الأخيرة.
https://meta.discourse.org/new.rss - المواضيع المقروءة: المواضيع التي قمت بقراءتها بالفعل.
https://meta.discourse.org/read.rss - المواضيع المنشورة: المواضيع التي أنشأتها.
https://meta.discourse.org/posted.rss - المحفوظات: المواضيع التي قمت بحفظها.
https://meta.discourse.org/bookmarks.rss
/new.rss: الرابط/new.rssغير موجود للمستخدمين العامين غير المصادق عليهم. عرض “الجديد” خاص بتاريخ حسابك. إذا كنت بحاجة إلى موجز عام للمواضيع مرتبة حسب تاريخ الإنشاء، استخدم/latest.rss?order=created.
المشكلات الشائعة والحلول
المشكلة: “الصفحة مفقودة” أو خطأ 404 على /new.rss
- السبب: هذا الموجز متاح فقط للمستخدمين المسجلين الدخول.
- الحل: استخدم
/latest.rss?order=createdللحصول على موجز زمني عام، أو تأكد من تسجيل دخولك.
المشكلة: إعادة ترتيب عناصر الموجز في قارئي
- السبب: يقوم موجز
latestالافتراضي بالفرز حسب وقت آخر رد. - الحل: أضف
?order=createdإلى الرابط للفرز حسب وقت إنشاء الموضوع.
المشكلة: موجز الفئة + الوسم لا يعمل
- السبب: استخدام السابقتين
/c/بدلاً من/tags/c/. - الحل: تأكد من أن الرابط يبدأ بـ
/tags/c/(على سبيل المثال:https://site.com/tags/c/category-slug/1/tag-slug/2/l/latest.rss).
الأسئلة الشائعة
س: هل يمكنني إنشاء موجز RSS لاستعلام بحث؟
ج: لا، لا يدعم Discourse موجزات RSS لاستعلامات البحث بشكل أصلي. يجب عليك استخدام الوسوم أو الفئات لتصفية المحتوى.
س: لماذا تظهر بعض موجزات الفئات الخاصة بي رسالة “هذه الصفحة خاصة”؟
ج: إذا كانت الفئة مقيدة بمجموعات أو مستخدمين محددين، فسيكون موجز RSS مقيداً أيضاً. يجب أن تكون مسجلاً الدخول بصلاحيات مناسبة لعرض الموجز.
س: هل يتم تخزين موجزات RSS مؤقتاً (تخزين مؤقت)؟
ج: نعم، يقوم Discourse بتخزين موجزات RSS مؤقتاً لمدة دقيقة واحدة لتحسين الأداء.
