 |
Resumo | Permite importar automaticamente conteúdo de feeds RSS/ATOM para o seu site Discourse como tópicos |
 |
Guia de Instalação | Este plugin vem embutido no núcleo do Discourse. Não há necessidade de instalar o plugin separadamente. |
Este guia explica como configurar e usar o plugin RSS Polling para importar automaticamente conteúdo de feeds RSS/ATOM para o seu site Discourse como tópicos.
Nível de usuário necessário: Administrador
Resumo
Esta documentação cobrirá a ativação do plugin RSS Polling, a configuração de URLs de feed, o gerenciamento de configurações e a resolução de problemas comuns. Você aprenderá como configurar feeds para postar em categorias específicas, atribuir autores e controlar como o conteúdo aparece no seu site.
Ativar o plugin RSS Polling
Sites auto-hospedados
Navegue até o seu painel de administração em Administração > Plugins e localize o plugin RSS Polling. Ative-o usando o interruptor:
Hospedados pelo Discourse
Se o 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 de hospedagem.
Configurar feeds RSS
Depois que o plugin for ativado, acesse a página de configuração do RSS Polling visitando Administração > Plugin > RSS Polling diretamente, 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 “URL do Feed”
- Selecione um usuário existente do seu site como “Autor” - este usuário será o proprietário 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 de feed para limitar quais itens do feed serão importados
Filtro de categoria de feed
A configuração do filtro de categoria de feed permite limitar quais itens do feed são publicados com base nos metadados de categoria do item. Ao inserir 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 tem 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 de configurar 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 do feed RSS correta 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 uma URL de canal, URL de nome de usuário ou URL de canal personalizado diretamente não funcionará. O plugin RSS Polling requer a URL de feed com o
channel_idexplícito.
Erros comuns a evitar
- Usar URLs de páginas padrão 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 pesquisa
A configuração do site rss polling frequency controla com que frequência o Discourse verifica os feeds RSS em busca de novo conteúdo. O valor padrão é de 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 pesquisa:
- Vá para
/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 postagem do sistema nos seus logs de administração.
Alterar categoria ou tags do feed
Alterar a categoria ou as 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 os novos tópicos usem a categoria e as tags corretas
Limitações da URL do feed
Cada URL de feed RSS exclusiva será importada apenas uma vez no Discourse. Quando você configura um feed RSS pela primeira vez, o Discourse importa todo o feed. Excluir e readicionar a mesma URL de feed não causará a reimportação dos itens processados anteriormente.
Controlar a visibilidade dos tópicos
Impedir que tópicos fiquem não listados
Por padrão, os 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 os tópicos do RSS fiquem não listados:
- Vá para
/admin/site_settings - Pesquise por “embed unlisted”
- Desative essa configuração
Mostrar conteúdo completo da postagem
Se a configuração do site embed truncate estiver habilitada (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:
- Vá para Administração > Configurações do Site
- Pesquise por “embed truncate”
- Desative essa 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 está atualizando
Verifique se:
- A URL do feed RSS é válida e acessível
- A frequência de pesquisa não foi definida como muito alta
- Existem realmente novos itens no feed RSS desde a última pesquisa
Interface do plugin não responde
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 administração. Tente:
- Desativar os bloqueadores de anúncios para o seu site Discourse
- Usar um navegador diferente
- Forçar a atualização da página
Tópicos sendo criados com datas incorretas
Por padrão, os tópicos do RSS usam a data atual quando são importados. Se você quiser usar a data de publicação original do feed RSS, habilite a configuração rss polling use pubdate.
Perguntas frequentes
Com que frequência posso pesquisar feeds RSS?
A frequência mínima de pesquisa é de 10 minutos, o máximo é 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.
A exclusão e readdição de um feed causará tópicos duplicados?
Não, cada item do feed RSS é importado apenas uma vez. Readicionar um feed não criará duplicatas.
Como depuro problemas de pesquisa RSS?
Atualmente, o plugin possui logs limitados. Verifique os logs do seu Discourse em Administração > Segurança > Painel de Logs para quaisquer mensagens de erro relacionadas à pesquisa RSS.