Ce guide explique comment afficher les flux RSS de votre forum Discourse sur votre serveur Discord.
Vous avez besoin d’un bot Discord. Vous pouvez utiliser un bot hébergé avec un module RSS et l’ajouter à votre serveur, ou installer un bot auto-hébergé et le configurer.
Pour ce guide, nous utiliserons Red-DiscordBot car il est auto-hébergé. Vous pouvez l’installer sur votre serveur. Il est très facile à maintenir, hautement personnalisable et activement maintenu.
Configuration du bot
-
Suivez ce tutoriel pour installer et configurer Red.
-
Créez un nouveau compte de bot sur Discord et ajoutez le bot à votre serveur Discord.
Ajout des flux RSS (module personnalisé)
Lorsque le bot est en ligne sur votre serveur, vous devez ajouter un nouveau module personnalisé (RSS) depuis les dépôts approuvés.
Dans votre chaîne Discord, tapez les commandes suivantes (remplacez ! par votre préfixe de bot) :
Autoriser l’installation de modules tiers :
!load downloader
Ajouter aikaterna-cogs :
!repo add aikaterna https://github.com/aikaterna/aikaterna-cogs
Suivez les instructions en tapant I agree.
Installer le module RSS :
!cog install aikaterna-cogs rss
Charger le module RSS :
!load rss
Vous disposez maintenant d’un module RSS à configurer. Choisissez la chaîne que vous souhaitez utiliser pour afficher votre flux RSS.
Le flux RSS sera ajouté à la chaîne dans laquelle vous vous trouvez actuellement. Vous pouvez ajouter plusieurs flux RSS dans une seule chaîne.
Les noms de vos flux RSS doivent être en minuscules.
Dans la chaîne choisie, tapez :
!rss add discourse https://meta.discourse.org/latest.rss
où « discourse » est le nom que vous attribuez à ce flux RSS.
Chaque flux RSS doit avoir un nom différent.
Si vous utilisez plus d’un mot dans le nom de votre flux, vous devez utiliser des guillemets doubles :
!rss add "discourse announcements" https://meta.discourse.org/c/announcements/67.rss
Vous pouvez prévisualiser le flux RSS en tapant :
!rss force discourse
ou, si le nom de votre flux contient des espaces :
!rss force "discourse announcements"
Par défaut, il n’y a aucun formatage :
Nous pouvons ajouter un modèle pour afficher des informations supplémentaires (par exemple, l’auteur) dans l’ordre de notre choix :
!rss template discourse $author:\n$title\n$link
\n crée un saut de ligne. Vous pouvez également utiliser la syntaxe Markdown de Discord dans votre modèle.
(optionnel) Nous pouvons afficher le flux dans un bloc intégré. Nous le ferons en tapant :
!rss embed toggle discourse
Notez que les liens n’afficheront pas d’aperçu si le flux RSS est intégré.
En guise de touche finale, nous ajouterons le nom du flux dans le modèle, afin que nous sachions d’où provient le flux. C’est pratique lorsque nous avons plusieurs flux dans une seule chaîne, surtout s’ils proviennent du même domaine.
!rss template discourse **Discourse**\n$author:\n$title\n$link
Pour le flux d’annonces de Discourse :
!rss template "discourse support" **Discourse Announcements**\n$author:\n$title\n$link
Pour afficher l’aide concernant les commandes rss, tapez :
!rss help
