||||
-|-|
| Resumen | Permite importar automáticamente contenido desde canales RSS/ATOM a tu sitio de Discourse como temas
| Guía de instalación | Este plugin está integrado en 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 desde canales 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 URL de los canales, la gestión de ajustes y la resolución de problemas comunes. Aprenderás a configurar canales 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 alojados por uno mismo
Navega al 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 canales RSS
Una vez habilitado el plugin, accede a la página de configuración de RSS Polling visitando directamente el panel Admin > Plugin > RSS Polling, o navegando a /admin/plugins y seleccionando “RSS Polling” en el menú lateral.
Añadir un nuevo canal RSS
- Introduce la URL del canal RSS o ATOM en el campo “URL del canal”
- Selecciona un usuario existente de tu sitio como “Autor” - este usuario será el propietario de todas las publicaciones creadas a partir del canal
- Elige una categoría de Discourse donde se publicarán los temas del canal
- Haz clic en el botón
guardar.
Opcional: Añadir etiquetas que se aplicarán a todos los temas de este canal y/o introducir un filtro de categoría del canal para limitar qué elementos del canal se importan
Filtro de categoría del canal
El ajuste del filtro de categoría del canal te permite limitar qué elementos del canal 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 del canal que coincidan con esa categoría específica.
Por ejemplo, si examinas el canal 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 categorías específicas.
Configuración de canales 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 canal 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 del canal 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 del canal 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 del canal RSS del canal:
https://www.youtube.com/feeds/videos.xml?channel_id=ID_TU_CANAL
Puedes encontrar el channel_id en YouTube bajo Configuración avanzada del 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 del canal explícita con
channel_id.
Errores comunes a evitar
- Uso de URLs de páginas estándar de YouTube en lugar de URLs de canales RSS
- Uso de URLs de listas de reproducción o canales sin extraer el ID correcto
- Mezclar parámetros de lista de reproducción y de canal en la misma URL del canal
Si un canal de YouTube está configurado incorrectamente, el plugin RSS Polling puede fallar silenciosamente o dejar de importar nuevos temas.
Configurar la frecuencia de sondeo
El ajuste del sitio rss polling frequency controla con qué frecuencia Discourse verifica los canales 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 alojados por uno mismo
Para ajustar la frecuencia de sondeo:
- Ve a
/admin/site_settings - Busca “rss polling frequency”
- Establece tu intervalo deseado en minutos
Sitios alojados por Discourse
Contacta al equipo de soporte para solicitar un ajuste del ajuste del sitio rss_polling_frequency.
Gestionar los ajustes del canal
Cambiar el autor del canal
Puedes cambiar el autor de todos los temas asociados con un canal RSS específico actualizando el campo “Autor” en la página de ajustes de RSS Polling. Esto actualizará automáticamente todos los temas existentes de ese canal 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 las etiquetas del canal
Cambiar la categoría o las etiquetas de una URL de canal 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 del canal RSS para que los nuevos temas utilicen la categoría y las etiquetas correctas
Limitaciones de la URL del canal
Cada URL de canal RSS única solo se importará una vez a Discourse. Cuando configuras por primera vez un canal RSS, Discourse importa todo el canal. Eliminar y volver a añadir la misma URL de canal no causará la reimportación de elementos previamente procesados.
Controlar la visibilidad de los temas
Evitar que los temas queden sin listar
Por defecto, los temas incrustados quedan sin listar hasta que reciben una respuesta. Este comportamiento no tiene sentido para los temas importados por RSS. Para evitar que los temas de RSS queden sin listar:
- Ve a
/admin/site_settings - Busca “embed unlisted”
- Deshabilita este ajuste
Mostrar el contenido completo de la publicación
Si el ajuste del sitio embed truncate está habilitado (predeterminado), los temas del canal 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 > Site Settings
- Busca “embed truncate”
- Deshabilita este ajuste
Si el contenido completo de la publicación no se muestra correctamente, configura el ajuste del sitio embed whitelist selector para especificar qué elementos HTML deben importarse.
Problemas comunes y soluciones
El canal no se actualiza
Comprueba que:
- La URL del canal RSS es válida y accesible
- La frecuencia de sondeo no se ha establecido demasiado alta
- Hay realmente nuevos elementos en el canal 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 suele ser causado por bloqueadores de anuncios del navegador que interfieren con la interfaz de administración. Prueba:
- Desactivar los bloqueadores de anuncios para tu sitio de Discourse
- Usar un navegador diferente
- Actualizar forzosamente la página
Temas creados con fechas incorrectas
Por defecto, los temas de RSS utilizan la fecha actual cuando se importan. Si quieres utilizar la fecha de publicación original del canal RSS, habilita el ajuste rss polling use pubdate.
Preguntas frecuentes
¿Con qué frecuencia puedo sondear canales RSS?
La frecuencia mínima de sondeo es de 10 minutos, el máximo es de 180 minutos (3 horas).
¿Puedo importar respuestas desde canales RSS?
No, el plugin RSS Polling solo importa los elementos principales del canal como temas individuales. No importa comentarios ni respuestas.
¿Causará eliminar y volver a añadir un canal temas duplicados?
No, cada elemento del canal RSS solo se importa una vez. Volver a añadir un canal no creará duplicados.
¿Cómo depuro problemas de sondeo RSS?
Actualmente, el plugin tiene un registro limitado. Comprueba tus registros de Discourse en el panel Admins > Security > Logs en busca de mensajes de error relacionados con el sondeo RSS.