Un guide de référence complet pour tous les flux RSS disponibles dans Discourse, y compris les structures d’URL, les exigences d’authentification et les meilleures pratiques pour les lecteurs de flux.
Niveau d’utilisateur requis : Tous les utilisateurs
RSS (Really Simple Syndication) est un format standardisé et lisible par ordinateur qui permet de partager facilement du contenu entre des sites et des plateformes. Discourse propose une large gamme de flux RSS pour les sujets, les messages, les catégories, les étiquettes, les utilisateurs et les groupes.
URL stables : Les liens RSS contenant un ID (par exemple, l’ID de catégorie, l’ID de sujet, l’ID de badge) sont définis par cet ID. Les liens ne se briseront pas si le « slug » (la partie texte de l’URL) change, mais le slug reste obligatoire dans le chemin de l’URL.
Par exemple, ces liens mènent tous au même flux 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
Badges
Obtenez un flux pour un badge spécifique.
https://meta.discourse.org/badges/[id]/[badge_name].rss
Catégories
Obtenez un flux des derniers sujets dans une catégorie spécifique.
https://meta.discourse.org/c/[category_slug]/[id].rss
Catégories et Étiquettes
Obtenez un flux de sujets dans une catégorie spécifique qui possèdent également une étiquette spécifique.
Important : Contrairement aux flux de catégories standards, les flux catégorie+étiquette sont hébergés sous le chemin
/tags/, et non/c/.
URL canonique (Recommandée) : Utilise l’ID numérique de l’étiquette pour la stabilité.
https://meta.discourse.org/tags/c/[category_slug]/[id]/[tag_slug]/[tag_id]/l/latest.rss
URL héritée : Utilise uniquement le nom de l’étiquette.
https://meta.discourse.org/tags/c/[category_slug]/[id]/[tag_name]/l/latest.rss
Remarque : Vous pouvez remplacer latest par d’autres filtres comme top, hot, new ou unread.
Groupes
Obtenez des flux pour l’activité des groupes. Les préfixes /groups/ et /g/ fonctionnent tous les deux.
Mentions : Sujets dans lesquels le groupe est mentionné.
https://meta.discourse.org/groups/[group_name]/mentions.rss
ou
https://meta.discourse.org/g/[group_name]/mentions.rss
Messages : Tous les messages publiés par les membres du groupe.
https://meta.discourse.org/groups/[group_name]/posts.rss
ou
https://meta.discourse.org/g/[group_name]/posts.rss
Messages (Global)
Obtenez un flux de tous les messages publics sur l’ensemble du site.
https://meta.discourse.org/posts.rss
Étiquettes
Obtenez un flux de sujets avec une étiquette spécifique.
URL canonique (Recommandée) : Utilise l’ID numérique de l’étiquette pour la stabilité.
https://meta.discourse.org/tag/[tag_slug]/[tag_id].rss
URL héritée : Utilise uniquement le nom de l’étiquette.
https://meta.discourse.org/tag/[tag_name].rss
Sujets
Obtenez des flux pour les listes de sujets.
Sujets populaires : Sujets actuellement tendance.
https://meta.discourse.org/hot.rss
Sujets les plus populaires (par période) : Sujets les plus populaires sur une durée spécifique.
https://meta.discourse.org/top.rss?period=[period]
Où [period] est l’un des éléments suivants : all, yearly, quarterly, monthly, weekly, daily.
top/yearly.rss) fonctionnent toujours mais redirigent vers le format de paramètre de requête ci-dessus.
Sujets les plus populaires (Par défaut) : Utilise la période par défaut du site.
https://meta.discourse.org/top.rss
Derniers sujets : Sujets avec l’activité la plus récente (réponses).
https://meta.discourse.org/latest.rss
Tri stable pour les lecteurs de flux : Par défaut, le flux « Latest » est trié par la date de la dernière réponse. Cela signifie que l’ordre des éléments dans votre lecteur de flux changera chaque fois que quelqu’un répond à un ancien sujet. Pour obtenir un ordre chronologique stable basé sur la date de création des sujets, ajoutez
?order=created:
https://meta.discourse.org/latest.rss?order=created
Sujet unique : Un flux pour un sujet spécifique.
https://meta.discourse.org/t/[topic_slug]/[id].rss
Utilisateurs
Obtenez des flux pour l’activité d’un utilisateur spécifique. Les préfixes /users/ et /u/ fonctionnent tous les deux.
Messages : Tous les messages publiés par l’utilisateur.
https://meta.discourse.org/users/[username]/activity.rss
ou
https://meta.discourse.org/u/[username]/activity.rss
Sujets : Sujets créés par l’utilisateur.
https://meta.discourse.org/users/[username]/activity/topics.rss
ou
https://meta.discourse.org/u/[username]/activity/topics.rss
Flux authentifiés
Les flux suivants nécessitent d’être connecté ou de fournir une clé API. Ils offrent des vues personnalisées du contenu.
- Sujets non lus : Sujets que vous n’avez pas encore lus.
https://meta.discourse.org/unread.rss - Nouveaux sujets (Personnel) : Sujets nouveaux pour vous depuis votre dernière visite.
https://meta.discourse.org/new.rss - Sujets lus : Sujets que vous avez déjà lus.
https://meta.discourse.org/read.rss - Sujets publiés : Sujets que vous avez créés.
https://meta.discourse.org/posted.rss - Signets : Sujets que vous avez mis en signet.
https://meta.discourse.org/bookmarks.rss
/new.rss: L’URL/new.rssn’existe pas pour les utilisateurs publics non authentifiés. La vue « New » est spécifique à l’historique de votre compte. Si vous avez besoin d’un flux public de sujets triés par date de création, utilisez/latest.rss?order=created.
Problèmes courants et solutions
Problème : « Page manquante » ou 404 sur /new.rss
- Cause : Ce flux est uniquement disponible pour les utilisateurs connectés.
- Solution : Utilisez
/latest.rss?order=createdpour un flux chronologique public, ou assurez-vous d’être connecté.
Problème : Réorganisation des éléments du flux dans mon lecteur
- Cause : Le flux
latestpar défaut trie par la date de la dernière réponse. - Solution : Ajoutez
?order=createdà l’URL pour trier par date de création du sujet.
Problème : Le flux Catégorie + Étiquette ne fonctionne pas
- Cause : Utilisation du préfixe
/c/au lieu de/tags/c/. - Solution : Assurez-vous que l’URL commence par
/tags/c/(par exemple,https://site.com/tags/c/category-slug/1/tag-slug/2/l/latest.rss).
FAQ
Q : Puis-je créer un flux RSS pour une requête de recherche ?
R : Non, Discourse ne prend pas nativement en charge les flux RSS pour les requêtes de recherche. Vous devez utiliser des étiquettes ou des catégories pour filtrer le contenu.
Q : Pourquoi mes flux de catégories affichent-ils parfois « Cette page est privée » ?
R : Si la catégorie est restreinte à des groupes ou des utilisateurs spécifiques, le flux RSS le sera également. Vous devez être connecté avec les autorisations appropriées pour afficher le flux.
Q : Les flux RSS sont-ils mis en cache ?
R : Oui, Discourse met en cache les flux RSS pendant 1 minute pour améliorer les performances.
