 |
Résumé | Permet d’importer automatiquement le contenu de flux RSS/ATOM sur votre site Discourse en tant que sujets |
 |
Guide d’installation | Ce plugin est inclus dans le noyau Discourse. Il n’est pas nécessaire d’installer le plugin séparément. |
Cette documentation explique comment configurer et utiliser le plugin RSS Polling pour importer automatiquement le contenu des flux RSS dans votre communauté Discourse en tant que sujets.
Configurer les flux RSS
Pour activer le plugin, rendez-vous dans Admins → Plugins installés, trouvez le plugin RSS Polling et activez l’interrupteur.
Une fois activé, cliquez sur Paramètres puis sur le bouton Ajouter un flux pour configurer votre premier flux.
Vous devrez ajouter les informations suivantes :
- URL du flux : L’URL du flux RSS ou Atom à importer.
- Filtre de catégorie (facultatif) : Limite les éléments du flux importés en fonction des métadonnées de catégorie de l’élément. Seuls les éléments dont la catégorie du flux correspond à la valeur saisie seront importés dans Discourse. Par exemple, si un flux contient des éléments étiquetés avec plusieurs catégories, vous pouvez saisir un terme de catégorie spécifique pour n’importer que ces éléments.
- Auteur : Un utilisateur Discourse existant qui sera listé comme auteur de tous les sujets importés depuis ce flux.
- Catégorie : La catégorie Discourse où les sujets importés seront publiés.
- Tags : Un ou plusieurs tags qui seront appliqués à tous les sujets provenant de ce flux.
Cliquez sur Enregistrer pour ajouter le flux.
🎥 Exemple courant : Flux YouTube
Importer une playlist YouTube
Utilisez le point de terminaison du flux RSS de YouTube pour les playlists :
https://www.youtube.com/feeds/videos.xml?playlist_id=<ID-PLAYLIST>
Où <ID-PLAYLIST> est le jeton trouvé dans l’URL de la playlist. Par exemple, étant donné cette URL de playlist :
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
L’URL de flux correcte est :
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importer une chaîne YouTube
Utilisez le format de flux RSS de la chaîne :
https://www.youtube.com/feeds/videos.xml?channel_id=<ID-CHAINE>
Vous pouvez trouver l’channel_id sur YouTube sous Paramètres avancés pour la chaîne.
L’utilisation directe d’une URL de chaîne standard, d’une URL de nom d’utilisateur ou d’une URL de chaîne personnalisée ne fonctionnera pas. Le plugin RSS Polling nécessite le format explicite d’URL de flux
channel_id.
Tester les flux
Avant d’enregistrer un nouveau flux ou un flux modifié, cliquez sur Tester le flux pour récupérer et analyser le flux sans rien importer. Vous verrez :
- Un compte récapitulatif du nombre d’éléments qui seraient importés, déjà importés ou ignorés.
- Un décompte ligne par ligne des premiers éléments du flux, chacun avec une explication en langage clair de la raison pour laquelle il serait importé ou ignoré.
Cela est utile pour vérifier votre configuration — en particulier le filtre de catégorie — avant qu’elle n’affecte votre communauté.
Sondages récents
Sur la page de modification de tout flux existant, la zone Sondages récents affiche les dernières tentatives de sondage. Chaque tentative affiche les comptes des éléments importés, mis à jour, ignorés et échoués. Vous pouvez développer toute tentative pour voir les détails par élément, y compris les liens vers les sujets créés ou mis à jour.
Lorsque vous cliquez sur Sondage maintenant, les résultats apparaissent en temps réel sans rafraîchissement de la page.
Paramètres
L’onglet Paramètres renvoie aux paramètres de site pertinents pour RSS Polling.
| Nom | Description |
|---|---|
rss polling feed request timeout |
Temps d’attente (en secondes) avant d’abandonner une requête de flux lente. Par défaut, 30 secondes. |
rss polling verbose logging |
Active la journalisation détaillée par élément pour chaque tentative de sondage. Désactivé par défaut ; utile pour le dépannage. |
rss polling use pubdate |
Utilise la date de publication originale de l’élément du flux comme date du sujet, plutôt que la date d’importation. |
rss polling update tags |
Met à jour les tags du sujet lors d’une mise à jour ; lorsqu’il est désactivé, il ne récupère que les tags initiaux. |
Contrôler la visibilité des sujets
Empêcher les sujets d’être non listés
Par défaut, les sujets intégrés sont non listés jusqu’à ce qu’ils reçoivent une réponse. Pour empêcher les sujets importés via RSS d’être non listés :
- Rendez-vous dans Admin → Tous les paramètres du site.
- Recherchez
embed unlisted. - Désactivez ce paramètre.
Afficher le contenu complet du message
Si le paramètre embed truncate est activé (par défaut), les sujets de flux n’afficheront qu’un extrait. Pour afficher le contenu complet :
- Rendez-vous dans Admin → Tous les paramètres du site.
- Recherchez
embed truncate. - Désactivez ce paramètre.
Si le contenu complet du message ne s’affiche toujours pas correctement, configurez le paramètre embed whitelist selector pour spécifier quels éléments HTML doivent être importés.
Problèmes courants
Le flux ne se met pas à jour
- Confirmez que l’URL du flux est valide et accessible publiquement.
- Vérifiez que
rss polling frequencyn’est pas réglé trop haut. - Vérifiez qu’il y a de nouveaux éléments dans le flux depuis le dernier sondage.
- Utilisez le bouton Tester le flux pour vérifier ce que le plugin voit dans le flux sans engager un sondage complet.
- Activez
rss polling verbose loggingpour plus de détails sur ce qui se passe lors de chaque sondage.
Sujets créés avec de mauvaises dates
Activez le paramètre rss polling use pubdate pour utiliser la date de publication originale de l’élément du flux au lieu de la date d’importation.
Chaque URL de flux n’est importée qu’une seule fois
Supprimer et réajouter la même URL de flux ne réimportera pas les éléments traités précédemment. Chaque élément RSS n’est importé qu’une seule fois.