 |
Resumen | Te permite importar automáticamente contenido de fuentes RSS/ATOM a tu sitio de Discourse como temas |
 |
Guía de instalación | Este plugin viene integrado con el núcleo de Discourse. No es necesario instalar el plugin por separado. |
Esta guía explica cómo configurar y usar el plugin RSS Polling para importar automáticamente contenido de fuentes RSS/ATOM a tu sitio de Discourse como temas.
Nivel de usuario requerido: Administrador
Resumen
Esta documentación cubrirá la habilitación del plugin RSS Polling, la configuración de las URLs de las fuentes, la gestión de ajustes y la resolución de problemas comunes. Aprenderás cómo configurar fuentes para publicar en categorías específicas, asignar autores y controlar cómo aparece el contenido en tu sitio.
Habilitar el plugin RSS Polling
Sitios autoalojados
Navega a tu panel de administración en Admin > Plugins y localiza el plugin RSS Polling. Habilítalo usando el interruptor:
Sitios alojados por Discourse
Si tu sitio está alojado por Discourse, contacta al equipo de soporte para solicitar la activación del plugin RSS Polling. El plugin está disponible en todos los planes de alojamiento.
Configurar fuentes RSS
Una vez habilitado el plugin, accede a la página de configuración de RSS Polling visitando Admin > Plugin > Panel RSS Polling directamente, o navegando a /admin/plugins y seleccionando “RSS Polling” en el menú lateral.
Añadir una nueva fuente RSS
- Introduce la URL de la fuente RSS o ATOM en el campo “URL de la fuente”
- Selecciona un usuario existente de tu sitio como “Autor” - este usuario será el propietario de todas las publicaciones creadas a partir de la fuente
- Elige una categoría de Discourse donde se publicarán los temas de la fuente
- Haz clic en el botón
guardar.
Opcional: Añade etiquetas que se aplicarán a todos los temas de esta fuente y/o introduce un filtro de categoría de fuente para limitar qué elementos de la fuente se importan
Filtro de categoría de fuente
El ajuste del filtro de categoría de fuente te permite limitar qué elementos de la fuente se publican basándose en los metadatos de categoría del elemento. Cuando introduces un término de categoría en este campo, solo se importarán a Discourse los elementos de la fuente que coincidan con esa categoría específica.
Por ejemplo, si examinas la fuente en https://blog.discourse.org/feed.xml, verás que cada entrada tiene información de categoría. Deberías introducir el valor de la propiedad term de la categoría para filtrar por categorías específicas.
Configuración de fuentes de YouTube
ejemplos comunes
YouTube es una de las plataformas más comunes utilizadas con RSS Polling, pero también es fácil de configurar incorrectamente. A continuación se muestran los formatos de URL de fuente recomendados y compatibles para los casos de uso más comunes de YouTube.
Importar una lista de reproducción de YouTube
Para importar vídeos de una lista de reproducción de YouTube, debes utilizar el punto final de fuente RSS de YouTube para listas de reproducción.
El formato correcto es:
https://www.youtube.com/feeds/videos.xml?playlist_id=<ID-LISTA>
Donde <ID-LISTA> 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 de la fuente RSS correcta sería:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importar un canal de YouTube
Para importar vídeos de un canal de YouTube, utiliza el formato de fuente RSS del canal:
https://www.youtube.com/feeds/videos.xml?channel_id=ID_DE_TU_CANAL
Puedes encontrar el channel_id en YouTube bajo Configuración avanzada para el canal.
El uso de una URL de canal, una URL de nombre de usuario o una URL de canal personalizada directamente no funcionará. El plugin RSS Polling requiere la URL de fuente con el
channel_idexplícito.
Errores comunes a evitar
- Uso de URLs de páginas estándar de YouTube en lugar de URLs de fuentes RSS
- Uso de URLs de listas de reproducción o canales sin extraer el ID correcto
- Mezcla de parámetros de lista de reproducción y canal en la misma URL de fuente
Si una fuente de YouTube está configurada incorrectamente, el plugin RSS Polling puede fallar en silencio o dejar de importar nuevos temas.
Configurar la frecuencia de sondeo
El ajuste de sitio rss polling frequency controla con qué frecuencia Discourse verifica las fuentes RSS en busca de nuevo contenido. El valor predeterminado es de 30 minutos, con un valor mínimo permitido de 10 minutos y un máximo de 180 minutos (3 horas).
Sitios autoalojados
Para ajustar la frecuencia de sondeo:
- Ve a
/admin/site_settings - Busca “rss polling frequency”
- Establece tu intervalo deseado en minutos
Sitios alojados
Contacta al equipo de soporte para solicitar un ajuste del ajuste de sitio rss_polling_frequency.
Gestionar los ajustes de la fuente
Cambiar el autor de la fuente
Puedes cambiar el autor de todos los temas asociados con una fuente RSS específica actualizando el campo “Autor” en la página de ajustes de RSS Polling. Esto actualizará automáticamente todos los temas existentes de esa fuente con el nuevo autor. Estos cambios aparecen como eventos de edición de publicación del sistema en tus registros de administración.
Cambiar la categoría o etiquetas de la fuente
Cambiar la categoría o las etiquetas de una URL de fuente RSS no actualizará automáticamente los temas existentes. Necesitarás:
- Usar Operaciones Masivas de Administración para mover manualmente los temas existentes a la nueva categoría o actualizar las etiquetas
- Actualizar los ajustes de la fuente RSS para que los nuevos temas utilicen la categoría y las etiquetas correctas
Limitaciones de la URL de la fuente
Cada URL de fuente RSS única solo se importará una vez en Discourse. Cuando configuras una fuente RSS por primera vez, Discourse importa toda la fuente. Eliminar y volver a añadir la misma URL de fuente no provocará la reimportación de los elementos procesados previamente.
Controlar la visibilidad de los temas
Evitar que los temas no se listen
Por defecto, los temas incrustados no se listan hasta que reciben una respuesta. Este comportamiento no tiene sentido para los temas importados por RSS. Para evitar que los temas de RSS no se listen:
- Ve a
/admin/site_settings - Busca “embed unlisted”
- Deshabilita este ajuste
Mostrar el contenido completo de la publicación
Si el ajuste de sitio embed truncate está habilitado (predeterminado), los temas de la fuente solo mostrarán un extracto. Los usuarios pueden ver el contenido completo haciendo clic en el botón “Mostrar publicación completa”.
Para mostrar siempre el contenido completo:
- Ve a Admin > Ajustes del sitio
- Busca “embed truncate”
- Deshabilita este ajuste
Si el contenido completo de la publicación no se muestra correctamente, configura el ajuste de sitio embed whitelist selector para especificar qué elementos HTML deben importarse.
Problemas comunes y soluciones
La fuente no se actualiza
Verifica que:
- La URL de la fuente RSS es válida y accesible
- La frecuencia de sondeo no se haya establecido demasiado alta
- Realmente haya elementos nuevos en la fuente RSS desde la última verificación
La interfaz del plugin no responde
Algunos usuarios informan de problemas con la interfaz de configuración de RSS Polling que no responde. Esto a menudo es causado por bloqueadores de anuncios del navegador que interfieren con la interfaz de administración. Prueba:
- Deshabilitar los bloqueadores de anuncios para tu sitio de Discourse
- Usar un navegador diferente
- Actualizar forzosamente la página
Creación de temas con fechas incorrectas
Por defecto, los temas de RSS utilizan la fecha actual cuando se importan. Si deseas utilizar la fecha de publicación original de la fuente RSS, habilita el ajuste rss polling use pubdate.
Preguntas frecuentes
¿Con qué frecuencia puedo sondear fuentes RSS?
La frecuencia mínima de sondeo es de 10 minutos, el máximo es de 180 minutos (3 horas).
¿Puedo importar respuestas desde fuentes RSS?
No, el plugin RSS Polling solo importa los elementos principales de la fuente como temas individuales. No importa comentarios ni respuestas.
¿Eliminar y volver a añadir una fuente causará temas duplicados?
No, cada elemento de la fuente RSS solo se importa una vez. Volver a añadir una fuente no creará duplicados.
¿Cómo depuro problemas de sondeo RSS?
Actualmente, el plugin tiene un registro limitado. Revisa tus registros de Discourse en Admins > Seguridad > Panel de registros para buscar mensajes de error relacionados con el sondeo RSS.