 |
Résumé | Vous permet d’importer automatiquement du contenu depuis des flux RSS/ATOM dans votre site Discourse sous forme de sujets |
 |
Guide d’installation | Ce plugin est intégré au cœur de Discourse. Il n’est pas nécessaire d’installer le plugin séparément. |
Ce guide explique comment configurer et utiliser le plugin RSS Polling pour importer automatiquement du contenu depuis des flux RSS/ATOM dans votre site Discourse sous forme de sujets.
Niveau utilisateur requis : Administrateur
Résumé
Cette documentation couvrira l’activation du plugin RSS Polling, la configuration des URL de flux, la gestion des paramètres et le dépannage des problèmes courants. Vous apprendrez comment configurer des flux pour publier dans des catégories spécifiques, attribuer des auteurs et contrôler l’apparence du contenu sur votre site.
Activer le plugin RSS Polling
Sites auto-hébergés
Accédez à votre panneau d’administration dans Admin > Plugins et localisez le plugin RSS Polling. Activez-le à l’aide du bouton bascule :
Sites hébergés par Discourse
Si votre site est hébergé par Discourse, contactez l’équipe de support pour demander l’activation du plugin RSS Polling. Le plugin est disponible sur tous les plans d’hébergement.
Configurer les flux RSS
Une fois le plugin activé, accédez à la page de configuration de RSS Polling en visitant directement le panneau Admin > Plugin > RSS Polling, ou en naviguant vers /admin/plugins et en sélectionnant « RSS Polling » dans le menu latéral.
Ajouter un nouveau flux RSS
- Entrez l’URL du flux RSS ou ATOM dans le champ « URL du flux »
- Sélectionnez un utilisateur existant de votre site en tant qu’« Auteur » - cet utilisateur sera propriétaire de tous les posts créés à partir du flux
- Choisissez une catégorie Discourse où les sujets du flux seront publiés
- Cliquez sur le bouton
enregistrer.
Optionnel : Ajoutez des tags qui seront appliqués à tous les sujets de ce flux et/ou entrez un filtre de catégorie de flux pour limiter quels éléments du flux sont importés
Filtre de catégorie de flux
Le paramètre de filtre de catégorie de flux vous permet de limiter quels éléments du flux sont publiés en fonction des métadonnées de catégorie de l’élément. Lorsque vous entrez un terme de catégorie dans ce champ, seuls les éléments du flux correspondant à cette catégorie spécifique seront importés dans Discourse.
Par exemple, si vous examinez le flux à https://blog.discourse.org/feed.xml, vous verrez que chaque entrée contient des informations de catégorie. Vous devez entrer la valeur de la propriété term de la catégorie pour filtrer des catégories spécifiques.
Configuration des flux YouTube
exemples courants
YouTube est l’une des plateformes les plus couramment utilisées avec RSS Polling, mais il est aussi facile de le configurer incorrectement. Ci-dessous se trouvent les formats d’URL de flux recommandés et pris en charge pour les cas d’utilisation YouTube les plus courants.
Importer une playlist YouTube
Pour importer des vidéos depuis une playlist YouTube, vous devez utiliser le point de terminaison de flux RSS de YouTube pour les playlists.
Le format correct est :
https://www.youtube.com/feeds/videos.xml?playlist_id=<PLAYLIST-ID>
Où <PLAYLIST-ID> 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 RSS correcte serait :
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importer une chaîne YouTube
Pour importer des vidéos depuis une chaîne YouTube, utilisez le format de flux RSS de la chaîne :
https://www.youtube.com/feeds/videos.xml?channel_id=YOUR_CHANNEL_ID
Vous pouvez trouver le channel_id dans YouTube sous Paramètres avancés pour la chaîne.
L’utilisation d’une URL de chaîne, d’une URL de nom d’utilisateur ou d’une URL de chaîne personnalisée directement ne fonctionnera pas. Le plugin RSS Polling nécessite l’URL de flux explicite
channel_id.
Erreurs courantes à éviter
- Utilisation d’URL de pages YouTube standard au lieu d’URL de flux RSS
- Utilisation d’URL de playlist ou de chaîne sans extraire le bon ID
- Mélange des paramètres de playlist et de chaîne dans la même URL de flux
Si un flux YouTube est mal configuré, le plugin RSS Polling peut échouer silencieusement ou arrêter d’importer de nouveaux sujets.
Configurer la fréquence de sondage
Le paramètre de site rss polling frequency contrôle la fréquence à laquelle Discourse vérifie les flux RSS pour du nouveau contenu. La valeur par défaut est de 30 minutes, avec une valeur minimale autorisée de 10 minutes et maximale de 180 minutes (3 heures).
Sites auto-hébergés
Pour ajuster la fréquence de sondage :
- Allez sur
/admin/site_settings - Recherchez « rss polling frequency »
- Définissez votre intervalle souhaité en minutes
Sites hébergés
Contactez l’équipe de support pour demander un ajustement du paramètre de site rss_polling_frequency.
Gérer les paramètres de flux
Changer l’auteur du flux
Vous pouvez changer l’auteur de tous les sujets associés à un flux RSS spécifique en mettant à jour le champ « Auteur » sur la page de paramètres de RSS Polling. Cela mettra automatiquement à jour tous les sujets existants de ce flux avec le nouvel auteur. Ces modifications apparaissent en tant qu’événements de modification de post système dans vos journaux d’administration.
Changer la catégorie ou les tags du flux
La modification de la catégorie ou des tags d’une URL de flux RSS ne mettra pas automatiquement à jour les sujets existants. Vous devrez :
- Utiliser les Opérations groupées administratives pour déplacer manuellement les sujets existants vers la nouvelle catégorie ou mettre à jour les tags
- Mettre à jour les paramètres du flux RSS afin que les nouveaux sujets utilisent la bonne catégorie et les bons tags
Limitations de l’URL de flux
Chaque URL de flux RSS unique ne sera importée qu’une seule fois dans Discourse. Lorsque vous configurez un flux RSS pour la première fois, Discourse importe l’intégralité du flux. La suppression et la réajout de la même URL de flux ne provoqueront pas de réimport des éléments déjà traités.
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. Ce comportement n’a pas de sens pour les sujets importés via RSS. Pour empêcher les sujets RSS d’être non listés :
- Allez sur
/admin/site_settings - Recherchez « embed unlisted »
- Désactivez ce paramètre
Afficher le contenu complet du post
Si le paramètre de site embed truncate est activé (par défaut), les sujets de flux n’afficheront qu’un extrait. Les utilisateurs peuvent voir le contenu complet en cliquant sur le bouton « Afficher le post complet ».
Pour toujours afficher le contenu complet :
- Allez dans Admin > Paramètres du site
- Recherchez « embed truncate »
- Désactivez ce paramètre
Si le contenu complet du post ne s’affiche pas correctement, configurez le paramètre de site embed whitelist selector pour spécifier quels éléments HTML doivent être importés.
Problèmes courants et solutions
Le flux ne se met pas à jour
Vérifiez que :
- L’URL du flux RSS est valide et accessible
- La fréquence de sondage n’a pas été définie trop haut
- Il y a réellement de nouveaux éléments dans le flux RSS depuis le dernier sondage
L’interface du plugin ne répond pas
Certains utilisateurs signalent des problèmes avec l’interface de configuration de RSS Polling qui ne répond pas. Cela est souvent causé par des bloqueurs de publicités dans le navigateur qui interfèrent avec l’interface d’administration. Essayez :
- De désactiver les bloqueurs de publicités pour votre site Discourse
- D’utiliser un navigateur différent
- De forcer l’actualisation de la page
Création de sujets avec de mauvaises dates
Par défaut, les sujets RSS utilisent la date actuelle lors de l’importation. Si vous souhaitez utiliser la date de publication originale du flux RSS, activez le paramètre rss polling use pubdate.
FAQ
À quelle fréquence puis-je sonder les flux RSS ?
La fréquence minimale de sondage est de 10 minutes, le maximum est de 180 minutes (3 heures).
Puis-je importer des réponses depuis des flux RSS ?
Non, le plugin RSS Polling n’importe que les éléments principaux du flux en tant que sujets individuels. Il n’importe pas les commentaires ou les réponses.
La suppression et la réajout d’un flux provoqueront-ils des sujets en double ?
Non, chaque élément de flux RSS n’est importé qu’une seule fois. Réajouter un flux ne créera pas de doublons.
Comment puis-je déboguer les problèmes de sondage RSS ?
Actuellement, le plugin dispose d’un journal limité. Vérifiez vos journaux Discourse dans Admins > Sécurité > Panneau des journaux pour tout message d’erreur lié au sondage RSS.