 |
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 à 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 via Admin > Plugins et localisez le plugin RSS Polling. Activez-le à l’aide de l’interrupteur :
Sites hébergés par Discourse
Si votre site est hébergé par Discourse, contactez l’équipe 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
- Saisissez l’URL du flux RSS ou ATOM dans le champ « URL du flux »
- Sélectionnez un utilisateur existant de votre site comme « Auteur » : cet utilisateur sera propriétaire de tous les messages créés à partir du flux
- Choisissez une catégorie Discourse dans laquelle les sujets du flux seront publiés
- Cliquez sur le bouton
sauvegarder.
Optionnel : Ajoutez des tags qui seront appliqués à tous les sujets de ce flux et/ou saisissez un filtre de catégorie de flux pour limiter les éléments du flux 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 saisissez 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 à l’adresse https://blog.discourse.org/feed.xml, vous verrez que chaque entrée contient des informations de catégorie. Vous devez saisir 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 également facile de mal le configurer. Voici 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 l’endpoint 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 du 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 l’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 avec
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 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 l’intervalle souhaité en minutes
Sites hébergés
Contactez l’équipe support pour demander un ajustement du paramètre 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 des 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 message système dans vos journaux d’administration.
Changer la catégorie ou les tags du flux
Le changement 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 des 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. Supprimer et réajouter la même URL de flux ne provoquera pas la réimportation 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 message
Si le paramètre 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 message 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 message ne s’affiche pas correctement, configurez le paramètre 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 élevée
- 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 autre navigateur
- De rafraîchir fortement 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 importe uniquement 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 déboguer les problèmes de sondage RSS ?
Actuellement, le plugin dispose d’un journal limité. Vérifiez vos journaux Discourse dans le panneau Admins > Sécurité > Journaux pour tout message d’erreur lié au sondage RSS.