 |
Resumen | Te permite importar automáticamente contenido de feeds RSS/ATOM a tu sitio de Discourse como temas |
 |
Guía de instalación | Este plugin viene incluido en el núcleo de Discourse. No es necesario instalar el plugin por separado. |
Esta documentación cubre cómo configurar y usar el plugin de consulta RSS para importar automáticamente contenido de feeds RSS a tu comunidad de Discourse como temas.
Configurar feeds RSS
Para activar el plugin, ve a Admins → Plugins instalados, busca el plugin Consulta RSS y activa el interruptor.
Una vez habilitado, haz clic en Configuración y luego en el botón Añadir feed para configurar tu primer feed.
Necesitarás añadir la siguiente información:
- URL del feed: La URL del feed RSS o Atom a importar.
- Filtro de categoría (opcional): Limita qué elementos del feed se importan según los metadatos de categoría del elemento. Solo se importarán a Discourse los elementos cuya categoría de feed coincida con el valor que introduzcas. Por ejemplo, si un feed incluye elementos etiquetados con varias categorías, puedes introducir un término de categoría específico para importar solo esos elementos.
- Autor: Un usuario existente de Discourse que aparecerá como autor de todos los temas importados desde este feed.
- Categoría: La categoría de Discourse donde se publicarán los temas importados.
- Etiquetas: Una o más etiquetas que se aplicarán a todos los temas de este feed.
Haz clic en Guardar para añadir el feed.
🎥 Ejemplo común: Feeds de YouTube
Importar una lista de reproducción de YouTube
Usa el punto final del feed RSS de YouTube para listas de reproducción:
https://www.youtube.com/feeds/videos.xml?playlist_id=<ID-LISTA-REPRODUCCION>
Donde <ID-LISTA-REPRODUCCION> es el token encontrado en la URL de la lista de reproducción. Por ejemplo, dada esta URL de lista de reproducción:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
La URL del feed correcta es:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importar un canal de YouTube
Usa el formato de feed RSS del canal:
https://www.youtube.com/feeds/videos.xml?channel_id=<ID-CANAL>
Puedes encontrar el channel_id en YouTube bajo Configuración avanzadas para el canal.
Usar una URL de canal estándar, una URL de nombre de usuario o una URL de canal personalizada directamente no funcionará. El plugin de consulta RSS requiere el formato explícito de URL de feed
channel_id.
Probar feeds
Antes de guardar un nuevo feed o uno editado, haz clic en Probar feed para obtener y analizar el feed sin importar nada. Verás:
- Un recuento resumen de cuántos elementos se importarían, ya están importados o se omitirían.
- Un desglose línea por línea de los primeros elementos del feed, cada uno con una explicación en lenguaje claro de por qué se importaría o se omitiría.
Esto es útil para verificar tu configuración, especialmente el filtro de categoría, antes de que afecte a tu comunidad.
Consultas recientes
En la página de edición de cualquier feed existente, el área Consultas recientes muestra los últimos intentos de consulta. Cada intento muestra recuentos de elementos importados, actualizados, omitidos y fallidos. Puedes expandir cualquier intento para ver detalles por elemento, incluidos enlaces a los temas que se crearon o actualizaron.
Cuando haces clic en Consultar ahora, los resultados aparecen en tiempo real sin actualizar la página.
Configuración
La pestaña Configuración enlaza a la configuración del sitio relevante para la consulta RSS.
| Nombre | Descripción |
|---|---|
rss polling feed request timeout |
Tiempo (en segundos) que se espera antes de renunciar a una solicitud de feed lenta. El valor predeterminado es de 30 segundos. |
rss polling verbose logging |
Habilita el registro detallado por elemento para cada intento de consulta. Desactivado por defecto; útil para solucionar problemas. |
rss polling use pubdate |
Usa la fecha de publicación original del elemento del feed como fecha del tema, en lugar de la fecha en que se importó. |
rss polling update tags |
Actualiza las etiquetas del tema cuando se actualiza un tema; cuando está desactivado, solo extrae las etiquetas iniciales. |
Controlar la visibilidad de los temas
Evitar que los temas queden sin listar
De forma predeterminada, los temas incrustados no se listan hasta que reciben una respuesta. Para evitar que los temas importados por RSS queden sin listar:
- Ve a Admin → Todos los ajustes del sitio.
- Busca
embed unlisted. - Desactiva esta configuración.
Mostrar el contenido completo de la publicación
Si la configuración embed truncate está habilitada (el valor predeterminado), los temas del feed solo mostrarán un extracto. Para mostrar el contenido completo:
- Ve a Admin → Todos los ajustes del sitio.
- Busca
embed truncate. - Desactiva esta configuración.
Si el contenido completo de la publicación aún no se muestra correctamente, configura la configuración embed whitelist selector para especificar qué elementos HTML deben importarse.
Problemas comunes
El feed no se actualiza
- Confirma que la URL del feed es válida y accesible públicamente.
- Comprueba que
rss polling frequencyno esté configurada demasiado alta. - Verifica que haya nuevos elementos en el feed desde la última consulta.
- Usa el botón Probar feed para ver qué ve el plugin en el feed sin realizar una consulta completa.
- Habilita
rss polling verbose loggingpara obtener más detalles sobre lo que sucede durante cada consulta.
Temas creados con fechas incorrectas
Habilita la configuración rss polling use pubdate para usar la fecha de publicación original del elemento del feed en lugar de la fecha de importación.
Cada URL de feed se importa solo una vez
Eliminar y volver a añadir la misma URL de feed no volverá a importar los elementos procesados previamente. Cada elemento RSS se importa solo una vez.