 |
Resumo | O RSS Polling Onebox renderiza as importações do RSS Polling como oneboxes do artigo original, com resumos de feed, descrições do YouTube e formatos de título opcionais |
 |
Link do Repositório | Peter-Petrik/discourse-rss-onebox |
 |
Guia de Instalação | Como instalar plugins no Discourse |
Funcionalidades
- Renderização de Onebox: As importações do RSS Polling nas categorias que você escolher se tornam uma onebox da URL do artigo - título, imagem e descrição da página do artigo - em vez do corpo do feed truncado no primeiro parágrafo. Importações em outras categorias permanecem inalteradas.
- “Mostrar Post Completo” oculto apenas nas categorias escolhidas.
- Resumos de feed (opcional): quando uma página de artigo não possui uma descrição própria, o resumo do feed aparece dentro da onebox, ou abaixo do link se não for possível criar uma onebox.
- Descrições do YouTube (opcional): a descrição completa do vídeo do feed do canal aparece abaixo do player, com quebras de linha e links clicáveis.
- Formatos de título (opcional): formatos separados para tópicos de blog e YouTube usando
%{title}e%{source}, por exemplo%{source} blog: %{title}. As renomeações são silenciosas - sem revisão, bump ou notificação - e os links antigos continuam funcionando. - Nomes de exibição: uma página de administrador lista todos os feeds do RSS Polling com seu nome publicado, onde você pode definir o nome usado para
%{source}. Salvar re-renderiza os títulos daquele feed. - Proteção contra atualizações de feed: um post de origem editado ou um formato de feed alterado não sobrescreve mais um tópico que já foi convertido em onebox.
- Tarefas Rake para tópicos existentes:
rss_onebox:convertconverte importações anteriores em oneboxes, erss_onebox:enhancepreenche resumos, descrições e títulos. Ambos têm execução simulada (dry run) por padrão.
Racional
Operamos um fórum que traz os blogs e canais do YouTube dos membros para uma única categoria. Os trechos do RSS Polling renderizavam muitos feeds de forma ruim - formatação quebrada, imagens faltando, um botão “Mostrar Post Completo” que refazia o scraping da página - enquanto a mesma URL colada em um post gerava uma onebox limpa. Este plugin faz com que cada importação pareça com aquele link colado, e preenche o que as páginas sozinhas não podiam fornecer.
Configuração
Após a instalação, vá em Admin → Plugins → RSS Polling Onebox:
- Configurações: ative o plugin, selecione as categorias cujas importações devem ser convertidas em onebox e ative os recursos opcionais.
- Nomes de exibição: defina o nome usado para
%{source}nos títulos, por feed, ou deixe em branco para usar o nome que o feed publica. Atualizar nomes publicados lê todos os feeds habilitados.
Para tópicos importados antes da instalação, execute rake rss_onebox:convert e depois rake rss_onebox:enhance dentro do contêiner (ambos em modo de execução simulada; adicione APPLY=1 para gravar). O README documenta todas as configurações e tarefas, e o CHANGELOG lista todas as versões.
Ressalvas
- Testado no Discourse 2026.7 ESR; a compatibilidade com o
mainaté setembro de 2026 é verificada no código. Versões mais antigas não foram testadas. - Requer o RSS Polling, que é incluído com o Discourse.
- Alguns recursos envolvem os internos do RSS Polling e do
TopicEmbedporque os ganchos documentados ainda não existem; veja RSS Polling: pontos de extensão para plugins. - A leitura nativa de descrições do YouTube no RSS Polling está em discussão em RSS Polling: ler a descrição do vídeo dos feeds de canais do YouTube; se for implementado no núcleo, este plugin o utilizará.
- A qualidade da onebox depende das tags Open Graph de cada página de artigo.
Perguntas e problemas: responda aqui, ou abra uma issue no GitHub.