 |
Résumé | RSS Polling Onebox affiche les imports RSS Polling sous forme de oneboxes de l’article d’origine, avec en option des résumés de flux, des descriptions YouTube et des formats de titre |
 |
Lien du dépôt | Peter-Petrik/discourse-rss-onebox |
 |
Guide d’installation | Comment installer des plugins dans Discourse |
Fonctionnalités
- Rendu en onebox : les imports RSS Polling dans les catégories de votre choix deviennent une onebox de l’URL de l’article - titre, image et description de la page de l’article - au lieu du corps du flux tronqué à son premier paragraphe. Les imports dans les autres catégories restent inchangés.
- « Afficher l’article complet » masqué uniquement dans les catégories sélectionnées.
- Résumés de flux (optionnel) : lorsqu’une page d’article n’a pas de description propre, le résumé du flux apparaît à l’intérieur de la onebox, ou sous le lien si aucune onebox ne peut être construite.
- Descriptions YouTube (optionnel) : la description complète de la vidéo depuis le flux de la chaîne apparaît sous le lecteur, avec les sauts de ligne et les liens cliquables.
- Formats de titre (optionnel) : des formats distincts pour les sujets de blogs et de YouTube utilisant
%{title}et%{source}, par exemple%{source} blog : %{title}. Les renommages sont silencieux - aucune révision, aucun relèvement, aucune notification - et les anciens liens continuent de fonctionner. - Noms d’affichage : une page d’administration liste tous les flux RSS Polling avec leur nom publié, où vous pouvez définir le nom utilisé pour
%{source}. L’enregistrement re-rend les titres de ce flux. - Protection contre les mises à jour de flux : un article source modifié ou un format de flux modifié ne remplace plus un sujet en onebox.
- Tâches Rake pour les sujets existants :
rss_onebox:converttransforme les imports antérieurs en oneboxes, etrss_onebox:enhanceremplit les résumés, descriptions et titres. Les deux fonctionnent par défaut en mode sec (dry run).
Justification
Nous exploitons un forum qui intègre les blogs et chaînes YouTube des membres dans une seule catégorie. Les extraits de RSS Polling affichaient mal de nombreux flux - formatage cassé, images manquantes, un bouton « Afficher l’article complet » qui re-scrapait la page - tandis que la même URL collée dans un post produisait une onebox propre. Ce plugin fait en sorte que chaque import ressemble à ce lien collé, et complète ce que les pages seules ne pouvaient pas fournir.
Configuration
Après l’installation, allez dans Administration → Plugins → RSS Polling Onebox :
- Paramètres : activez le plugin, sélectionnez les catégories dont les imports doivent être en onebox, et activez les fonctionnalités optionnelles.
- Noms d’affichage : définissez le nom utilisé pour
%{source}dans les titres, par flux, ou laissez vide pour utiliser le nom publié par le flux. Actualiser les noms publiés lit tous les flux activés.
Pour les sujets importés avant l’installation, exécutez rake rss_onebox:convert puis rake rss_onebox:enhance dans le conteneur (les deux en mode sec ; ajoutez APPLY=1 pour écrire). Le README documente chaque paramètre et tâche, et le CHANGELOG liste chaque version.
Limites
- Testé sur Discourse 2026.7 ESR ; la compatibilité avec
mainà partir de septembre 2026 est vérifiée dans le code. Les versions plus anciennes ne sont pas testées. - Nécessite RSS Polling, qui est inclus avec Discourse.
- Certaines fonctionnalités enveloppent les internals de RSS Polling et de
TopicEmbedcar les hooks documentés n’existent pas encore ; voir RSS Polling : points d’extension pour les plugins. - La lecture native des descriptions YouTube dans RSS Polling est en discussion dans RSS Polling : lire la description vidéo des flux de chaînes YouTube ; si cela est intégré au noyau, ce plugin l’utilisera.
- La qualité de la onebox dépend des balises Open Graph de chaque page d’article.
Questions et problèmes : répondez ici, ou ouvrez un ticket sur GitHub.