 |
Resumo | Permite importar automaticamente conteúdo de feeds RSS/ATOM para seu site Discourse como tópicos |
 |
Guia de Instalação | Este plugin vem integrado ao núcleo do Discourse. Não é necessário instalar o plugin separadamente. |
Esta documentação aborda como configurar e usar o plugin RSS Polling para importar automaticamente conteúdo de feeds RSS para sua comunidade Discourse como tópicos.
Configurar feeds RSS
Para ativar o plugin, vá em Admins → Plugins instalados, encontre o plugin RSS Polling e ative a chave de alternância.
Uma vez ativado, clique em Configurações e depois no botão Adicionar feed para configurar seu primeiro feed.
Você precisará adicionar as seguintes informações:
- URL do feed: A URL do feed RSS ou Atom a ser importado.
- Filtro de categoria (opcional): Limita quais itens do feed são importados com base nos metadados de categoria do item. Apenas itens cuja categoria do feed corresponda ao valor inserido serão importados para o Discourse. Por exemplo, se um feed inclui itens marcados com várias categorias, você pode inserir um termo de categoria específico para importar apenas esses itens.
- Autor: Um usuário existente do Discourse que será listado como autor de todos os tópicos importados deste feed.
- Categoria: A categoria do Discourse onde os tópicos importados serão publicados.
- Tags: Uma ou mais tags que serão aplicadas a todos os tópicos deste feed.
Clique em Salvar para adicionar o feed.
🎥 Exemplo comum: Feeds do YouTube
Importar uma playlist do YouTube
Use o endpoint de feed RSS do YouTube para playlists:
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 é:
https://www.youtube.com/feeds/videos.xml?playlist_id=PLxYzA1B2C3D4E5F6G7H8I9JkLmNoPqR
Importar um canal do YouTube
Use o formato de feed RSS do canal:
https://www.youtube.com/feeds/videos.xml?channel_id=<ID-DO-CANAL>
Você pode encontrar o channel_id no YouTube em Configurações avançadas do canal.
Usar uma URL de canal padrão, URL de nome de usuário ou URL de canal personalizada diretamente não funcionará. O plugin RSS Polling requer o formato explícito de URL de feed
channel_id.
Testar feeds
Antes de salvar um feed novo ou editado, clique em Testar feed para buscar e analisar o feed sem importar nada. Você verá:
- Uma contagem resumida de quantos itens seriam importados, já estão importados ou seriam ignorados.
- Uma análise detalhada, linha por linha, dos primeiros itens do feed, cada um com uma explicação em linguagem simples do motivo pelo qual seria importado ou ignorado.
Isso é útil para verificar sua configuração — especialmente o filtro de categoria — antes que ela afete sua comunidade.
Verificações recentes
Na página de edição de qualquer feed existente, a área Verificações recentes mostra as últimas tentativas de verificação. Cada tentativa exibe contagens de itens importados, atualizados, ignorados e com falha. Você pode expandir qualquer tentativa para ver detalhes por item, incluindo links para os tópicos que foram criados ou atualizados.
Quando você clica em Verificar agora, os resultados aparecem em tempo real sem recarregar a página.
Configurações
A guia Configurações linka para as configurações de site relevantes para o RSS Polling.
| Nome | Descrição |
|---|---|
rss polling feed request timeout |
Por quanto tempo (em segundos) esperar antes de desistir de uma solicitação de feed lenta. O padrão é 30 segundos. |
rss polling verbose logging |
Ativa o registro detalhado por item para cada tentativa de verificação. Desativado por padrão; útil para solução de problemas. |
rss polling use pubdate |
Usa a data de publicação original do item do feed como a data do tópico, em vez da data em que foi importado. |
rss polling update tags |
Atualiza as tags do tópico quando um tópico é atualizado; quando desativado, busca apenas as tags iniciais. |
Controlar visibilidade de tópicos
Impedir que tópicos fiquem não listados
Por padrão, tópicos incorporados ficam não listados até receberem uma resposta. Para impedir que tópicos importados via RSS fiquem não listados:
- Vá em Admin → Todas as configurações do site.
- Pesquise por
embed unlisted. - Desative esta configuração.
Mostrar conteúdo completo da postagem
Se a configuração embed truncate estiver ativada (o padrão), os tópicos do feed mostrarão apenas um trecho. Para mostrar o conteúdo completo:
- Vá em Admin → Todas as configurações do site.
- Pesquise por
embed truncate. - Desative esta configuração.
Se o conteúdo completo da postagem ainda não estiver sendo exibido corretamente, configure a configuração embed whitelist selector para especificar quais elementos HTML devem ser importados.
Problemas comuns
Feed não está atualizando
- Confirme se a URL do feed é válida e acessível publicamente.
- Verifique se
rss polling frequencynão está definido muito alto. - Verifique se há novos itens no feed desde a última verificação.
- Use o botão Testar feed para verificar o que o plugin vê no feed sem comprometer uma verificação completa.
- Ative
rss polling verbose loggingpara mais detalhes sobre o que está acontecendo durante cada verificação.
Tópicos criados com datas incorretas
Ative a configuração rss polling use pubdate para usar a data de publicação original do item do feed em vez da data de importação.
Cada URL de feed é importada apenas uma vez
Excluir e readicionar a mesma URL de feed não reimportará itens processados anteriormente. Cada item RSS é importado apenas uma vez.