Esta es una guía que explica cómo mostrar feeds RSS de tu foro Discourse en tu servidor de Discord.
Necesitas un bot de Discord. Puedes usar un bot alojado con un cog RSS y añadirlo a tu servidor, o instalar un bot autoalojado y configurarlo.
Para esta guía, usaremos Red-DiscordBot porque es autoalojado. Puedes instalarlo en tu servidor. Es muy fácil de mantener, altamente personalizable y se mantiene activamente.
Configuración del bot
-
Sigue este tutorial para instalar y configurar Red.
-
Crea una nueva cuenta de bot en Discord y añade el bot a tu servidor de Discord.
Añadir los feeds RSS (cog personalizado)
Cuando el bot esté en línea en tu servidor, necesitas añadir un nuevo cog personalizado (RSS) desde los repositorios aprobados.
En tu canal de Discord, escribe los siguientes comandos (reemplaza ! con el prefijo de tu bot):
Permitir la instalación de cogs de terceros:
!load downloader
Añadir aikaterna-cogs:
!repo add aikaterna https://github.com/aikaterna/aikaterna-cogs
Sigue las instrucciones escribiendo I agree (Acepto).
Instalar el cog RSS:
!cog install aikaterna-cogs rss
Cargar el cog RSS:
!load rss
Ahora tienes un cog RSS para configurar. Elige el canal que quieras usar para mostrar tu feed RSS.
El feed RSS se añadirá al canal en el que te encuentras actualmente. Puedes añadir múltiples feeds RSS en un solo canal.
Los nombres de tus feeds RSS deben estar en minúsculas.
En el canal elegido, escribe:
!rss add discourse https://meta.discourse.org/latest.rss
donde “discourse” es el nombre que asignas a este feed RSS.
Cada feed RSS debe tener un nombre diferente.
Si usas más de una palabra en el nombre de tu feed, debes usar comillas dobles:
!rss add "discourse announcements" https://meta.discourse.org/c/announcements/67.rss
Puedes previsualizar el feed RSS escribiendo:
!rss force discourse
o, si el nombre de tu feed contiene espacios:
!rss force "discourse announcements"
Por defecto, no hay formato:
Podemos añadir una plantilla para mostrar información adicional (por ejemplo, el autor) en el orden que elijamos:
!rss template discourse $author:\n$title\n$link
\n crea un salto de línea. También puedes usar sintaxis de Markdown de Discord en tu plantilla.
(opcional) Podemos mostrar el feed en un bloque de incrustación. Lo haremos escribiendo:
!rss embed toggle discourse
Ten en cuenta que los enlaces no mostrarán una vista previa si el feed RSS está incrustado.
Como último toque, añadiremos el nombre del feed en la plantilla, para saber de dónde proviene el feed. Es útil cuando tenemos múltiples feeds en un solo canal, especialmente si provienen del mismo dominio.
!rss template discourse **Discourse**\n$author:\n$title\n$link
Para el feed de anuncios de Discourse:
!rss template "discourse support" **Discourse Announcements**\n$author:\n$title\n$link
Para mostrar ayuda sobre los comandos de rss, escribe:
!rss help
