 |
Resumo | Permite importar automaticamente conteúdo de feeds RSS/ATOM para seu site Discourse como tópicos |
 |
Guia de Instalação | Este plugin já vem incluído no núcleo do Discourse. Não é necessário instalá-lo separadamente. |
Este guia explica como configurar e usar o plugin RSS Polling para importar automaticamente conteúdo de feeds RSS/ATOM para seu site Discourse como tópicos.
Nível de usuário necessário: Administrador
Resumo
Esta documentação abordará a ativação do plugin RSS Polling, configuração de URLs de feed, gerenciamento de configurações e solução de problemas comuns. Você aprenderá como configurar feeds para postar em categorias específicas, atribuir autores e controlar como o conteúdo aparece em seu site.
Ativar o plugin RSS Polling
Sites auto-hospedados
Navegue até seu painel administrativo em Admin > Plugins e localize o plugin RSS Polling. Ative-o usando o interruptor:
Hospedado pelo Discourse
Se seu site for hospedado pelo Discourse, entre em contato com a equipe de suporte para solicitar a ativação do plugin RSS Polling. O plugin está disponível em todos os planos hospedados.
Configurar feeds RSS
Uma vez que o plugin esteja ativado, acesse a página de configuração do RSS Polling visitando diretamente Admin > Plugin > RSS Polling ou navegando até /admin/plugins e selecionando “RSS Polling” no menu lateral.
Adicionar um novo feed RSS
- Insira a URL do feed RSS ou ATOM no campo “Feed URL”
- Selecione um usuário existente do seu site como “Autor” — este usuário será o dono de todas as postagens criadas a partir do feed
- Escolha uma categoria do Discourse onde os tópicos do feed serão publicados
- Clique no botão
Salvar.
Opcional: Adicione tags que serão aplicadas a todos os tópicos deste feed e/ou insira um filtro de categoria do feed para limitar quais itens do feed serão importados
Filtro de categoria do feed
A configuração de filtro de categoria do feed permite limitar quais itens do feed serão publicados com base nos metadados de categoria do item. Quando você insere um termo de categoria neste campo, apenas os itens do feed que correspondem a essa categoria específica serão importados para o Discourse.
Por exemplo, se você examinar o feed em https://blog.discourse.org/feed.xml, verá que cada entrada possui informações de categoria. Você deve inserir o valor da propriedade term da categoria para filtrar categorias específicas.
Configuração de feeds do YouTube
exemplos comuns
O YouTube é uma das plataformas mais comuns usadas com o RSS Polling, mas também é fácil configurá-lo incorretamente. Abaixo estão os formatos de URL de feed recomendados e suportados para os casos de uso mais comuns do YouTube.
Importar uma playlist do YouTube
Para importar vídeos de uma playlist do YouTube, você deve usar o endpoint de feed RSS do YouTube para playlists.
O formato correto é:
https://www.youtube.com/feeds/videos.xml?playlist_id=<ID-DA-PLAYLIST>
Onde <ID-DA-PLAYLIST> é o token encontrado na URL da playlist.
Por exemplo, dada esta URL de playlist:
https://www.youtube.com/playlist?list=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
A URL correta do feed RSS seria:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importar um canal do YouTube
Para importar vídeos de um canal do YouTube, use o formato de feed RSS do canal:
https://www.youtube.com/feeds/videos.xml?channel_id=SEU_ID_DO_CANAL
Você pode encontrar o channel_id no YouTube em Configurações avançadas do canal.
Usar diretamente uma URL de canal, URL de nome de usuário ou URL de canal personalizado não funcionará. O plugin RSS Polling requer a URL de feed explícita com
channel_id.
Erros comuns a evitar
- Usar URLs padrão de páginas do YouTube em vez de URLs de feed RSS
- Usar URLs de playlist ou canal sem extrair o ID correto
- Misturar parâmetros de playlist e canal na mesma URL de feed
Se um feed do YouTube estiver configurado incorretamente, o plugin RSS Polling pode falhar silenciosamente ou parar de importar novos tópicos.
Configurar frequência de polling
A configuração do site rss polling frequency controla com que frequência o Discourse verifica feeds RSS por novo conteúdo. O valor padrão é 30 minutos, com um valor mínimo permitido de 10 minutos e máximo de 180 minutos (3 horas).
Sites auto-hospedados
Para ajustar a frequência de polling:
- Acesse
/admin/site_settings - Pesquise por “rss polling frequency”
- Defina o intervalo desejado em minutos
Sites hospedados
Entre em contato com a equipe de suporte para solicitar um ajuste na configuração do site rss_polling_frequency.
Gerenciar configurações de feed
Alterar autor do feed
Você pode alterar o autor de todos os tópicos associados a um feed RSS específico atualizando o campo “Autor” na página de configurações do RSS Polling. Isso atualizará automaticamente todos os tópicos existentes desse feed com o novo autor. Essas alterações aparecem como eventos de edição de post do sistema nos seus logs de administrador.
Alterar categoria ou tags do feed
Alterar a categoria ou tags de uma URL de feed RSS não atualizará automaticamente os tópicos existentes. Você precisará:
- Usar Operações em Massa Administrativas para mover manualmente os tópicos existentes para a nova categoria ou atualizar as tags
- Atualizar as configurações do feed RSS para que novos tópicos usem a categoria e tags corretas
Limitações da URL do feed
Cada URL de feed RSS única será importada apenas uma vez no Discourse. Quando você configura um feed RSS pela primeira vez, o Discourse importa todo o feed. Excluir e re-adicionar a mesma URL de feed não causará a reimportação de itens já processados.
Controlar visibilidade dos tópicos
Impedir que tópicos fiquem não listados
Por padrão, tópicos incorporados ficam não listados até receberem uma resposta. Esse comportamento não faz sentido para tópicos importados via RSS. Para impedir que tópicos RSS fiquem não listados:
- Acesse
/admin/site_settings - Pesquise por “embed unlisted”
- Desative esta configuração
Mostrar conteúdo completo da postagem
Se a configuração do site embed truncate estiver ativada (padrão), os tópicos do feed exibirão apenas um trecho. Os usuários podem visualizar o conteúdo completo clicando no botão “Mostrar Postagem Completa”.
Para sempre mostrar o conteúdo completo:
- Acesse Admin > Configurações do Site
- Pesquise por “embed truncate”
- Desative esta configuração
Se o conteúdo completo da postagem não estiver sendo exibido corretamente, configure a configuração do site embed whitelist selector para especificar quais elementos HTML devem ser importados.
Problemas comuns e soluções
Feed não atualizando
Verifique se:
- A URL do feed RSS é válida e acessível
- A frequência de polling não foi definida muito alta
- Existem realmente novos itens no feed RSS desde a última consulta
Interface do plugin não respondendo
Alguns usuários relatam problemas com a interface de configuração do RSS Polling não respondendo. Isso geralmente é causado por bloqueadores de anúncios do navegador interferindo na interface de administrador. Tente:
- Desativar bloqueadores de anúncios para seu site Discourse
- Usar um navegador diferente
- Atualizar a página forçadamente
Tópicos sendo criados com datas incorretas
Por padrão, tópicos RSS usam a data atual quando importados. Se você quiser usar a data de publicação original do feed RSS, ative a configuração rss polling use pubdate.
FAQ
Com que frequência posso consultar feeds RSS?
A frequência mínima de polling é de 10 minutos, e a máxima é de 180 minutos (3 horas).
Posso importar respostas de feeds RSS?
Não, o plugin RSS Polling importa apenas os itens principais do feed como tópicos individuais. Ele não importa comentários ou respostas.
Excluir e re-adicionar um feed causará tópicos duplicados?
Não, cada item do feed RSS é importado apenas uma vez. Re-adicionar um feed não criará duplicatas.
Como depurar problemas de polling RSS?
Atualmente, o plugin possui registro limitado. Verifique seus logs do Discourse em Administradores > Segurança > Painel de Logs para qualquer mensagem de erro relacionada ao polling RSS.
Este plugin agora está incluído no núcleo do Discourse como parte de 