 |
Resumo | Permite importar um sitemap, para mapear automaticamente os títulos das páginas para links do fórum, de forma semelhante ao funcionamento das ‘Palavras Monitoradas’. |
 |
Link do Repositório | GitHub - multidimension-al/discourse-sitemap-autolink: Turn sitemaps into automatic links in discourse. · GitHub |
 |
Guia de Instalação | Como instalar plugins no Discourse |
Recursos
Esta é uma alternativa ao uso do recurso ‘Palavras Monitoradas’. Ele permite que você pegue o sitemap do seu site externo e o importe, atribua as palavras para correspondência automática e, em seguida, as vincule durante o próximo rebake. Muito semelhante ao funcionamento das Palavras Monitoradas, mas adiciona a etapa de ingestão de sitemaps e extração de palavras-chave.
Ideal para fóruns técnicos com uma seção de Wiki separada, por exemplo, ou para um fórum com uma loja de notícias ou e-commerce associada.
Você pega o sitemap da sua Wiki:
<?xml version="1.0" encoding="UTF-8"?>
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url><loc>https://www.example.com/wiki/soldering-iron-maintenance</loc><lastmod>2026-07-02</lastmod></url>
<url><loc>https://www.example.com/wiki/mosfet-driver-board</loc><lastmod>2026-07-05</lastmod></url>
<url><loc>https://www.example.com/wiki/li-ion-battery-pack</loc><lastmod>2026-07-11</lastmod></url>
<url><loc>https://www.example.com/wiki/pcb-etching</loc><lastmod>2026-07-19</lastmod></url>
<url><loc>https://www.example.com/wiki/flux</loc><lastmod>2026-07-23</lastmod></url>
</urlset>
O plugin baixará o sitemap, obterá o título da página e, em seguida, gerará as palavras para correspondência. Essas palavras serão autolinkadas da próxima vez que qualquer postagem com essas palavras for processada (baked), ou o plugin procurará essas postagens e as reprocessará automaticamente.
<title> Obtido |
Título Armazenado |
|---|---|
| Manutenção de Ferro de Solda - Wiki Exemplo | Manutenção de Ferro de Solda |
| Placa Driver MOSFET - Wiki Exemplo | Placa Driver MOSFET |
| Bateria de Íon-Lítio - Wiki Exemplo | Bateria de Íon-Lítio |
| Gravação de PCB - Wiki Exemplo | Gravação de PCB |
| Fluxo - Wiki Exemplo | Fluxo |
Cada um dos títulos se torna a frase de correspondência, com mecanismos de segurança.
| Título Armazenado | Frases Geradas | Estado |
|---|---|---|
| Manutenção de Ferro de Solda | manutenção de ferro de solda(s) | ativo |
| Placa Driver MOSFET | placa driver mosfet(s) | ativo |
| Bateria de Íon-Lítio | bateria de íon-lítio(s) | ativo |
| Gravação de PCB | gravação de pcb(s) | ativo |
| Fluxo | fluxo, fluxos | pendente de revisão — palavra curta e única |
Em seguida, qualquer postagem com algo que corresponda à frase vinculará automaticamente de volta à wiki do seu site, no máximo 1 vez por postagem.
Então, se eu tiver uma postagem que diz:
Estava lendo a página Manutenção de Ferro de Solda e notei um problema com o que dizia…
A palavra ‘Manutenção de Ferro de Solda’ será vinculada à página associada a ela no sitemap.
Configuração
Depois de instalado, há muitos configurações que podem ser ajustadas, além de uma página de Catálogo dedicada que mostra seus sitemaps sendo importados e a lista de frases que serão correspondidas junto com a URL.
Encontre o arquivo XML do sitemap que você planeja importar e certifique-se de que é possível conectar-se a esse servidor sem limitações da sua instalação do Discourse. Localize o prefixo ou sufixo comum do site e defina os sufixos de título do autolink do sitemap com a parte do campo que você não deseja. Um exemplo seria “- Discourse Meta” se você quisesse que ele não correspondesse a esse título de página. Você também pode especificar para pular certas palavras comuns que podem aparecer frequentemente em seu site. A maioria das configurações não precisa ser ativada, mas permite ajustar o tempo e o atraso, quanto tempo é permitido para verificar o sitemap e quanto tempo atrasar entre cada URL.
Depois que a URL for importada, ela salva o tempo de última modificação e não verifica novamente, a menos que o campo de última modificação mude. Você pode atribuir ou excluir frases de correspondência manualmente, e ele solicitará automaticamente sua opinião sobre correspondências de palavra única.
Configurações
Vinculação
| Configuração | Padrão | Finalidade |
|---|---|---|
sitemap_autolink_enabled |
desligado | Interruptor principal. |
sitemap_autolink_max_links_per_destination_per_post |
1 | Vezes que cada destino pode ser vinculado por postagem (as primeiras menções vencem). 0 = ilimitado. |
sitemap_autolink_max_links_per_post |
0 | Total de links automáticos por postagem. 0 = ilimitado. |
sitemap_autolink_skip_quotes |
ligado | Nunca vincular dentro de material citado. |
sitemap_autolink_include_private_messages |
desligado | Também vincular em mensagens pessoais. |
sitemap_autolink_excluded_categories |
– | Nunca vincular nessas categorias (subcategorias incluídas). |
sitemap_autolink_enabled_types |
– (todos) | Restringir quais tipos de conteúdo podem vincular. |
sitemap_autolink_type_priority |
manual |
Ordem de prioridade de colisão, do mais forte para o mais fraco; tipos não listados ficam por último. |
Catálogo e frases
| Configuração | Padrão | Finalidade |
|---|---|---|
sitemap_autolink_sources |
– | Sitemaps para ingestão, um por entrada: https://example.com/sitemap.xml,content_type. Os índices se expandem automaticamente. |
sitemap_autolink_manual_mappings |
– | Regras manuais frase,url,tipo. URLs relativas são resolvidas em relação ao fórum. |
sitemap_autolink_min_phrase_length |
5 | Frases geradas mais curtas vão para revisão. |
sitemap_autolink_min_phrase_words |
2 | Frases geradas com menos palavras vão para revisão (tokens de modelo de letra+dígito estão isentos). |
sitemap_autolink_generate_plurals |
ligado | Também gera variantes plurais simples. |
sitemap_autolink_title_suffixes |
– | Texto padrão removido do final dos títulos obtidos. Uma entrada não pode conter o ` |
sitemap_autolink_excluded_url_patterns |
– | Nunca ingerir URLs de sitemap correspondentes (substring ou curinga *, por exemplo, */checkout*). |
sitemap_autolink_excluded_terms |
– | Frases exatas que nunca devem ser geradas automaticamente. Aliases manuais substituem. |
Sincronização
| Configuração | Padrão | Finalidade |
|---|---|---|
sitemap_autolink_sync_enabled |
desligado | Executar o trabalho diário de sitemap→catálogo. |
sitemap_autolink_page_fetch_delay_ms |
500 | Pausa de educação entre buscas de título (apenas URLs novas/alteradas). |
sitemap_autolink_sync_time_budget_minutes |
30 | Minutos máximos por execução; a execução para limpa como Parcial e a próxima execução retoma o trabalho restante. |
sitemap_autolink_fetch_host_rewrites |
– | Buscar um host público por meio de um destino interno (veja abaixo). |
Rebake
| Configuração | Padrão | Finalidade |
|---|---|---|
sitemap_autolink_auto_rebake_on_changes |
desligado | Após uma sincronização, reprocessar postagens provavelmente afetadas por alterações de frase — um trabalho em lote de segundo plano por sincronização. |
sitemap_autolink_auto_rebake_max_phrases |
50 | Se uma sincronização alterar mais frases do que isso, pular o rebake automático inteiramente (para que uma importação inicial nunca acione um rebake quase total do fórum). |
sitemap_autolink_auto_rebake_max_posts |
500 | Maior número de postagens que uma onda de rebake de sincronização pode tocar. |
sitemap_autolink_max_rebakes_per_job_run |
200 | Tamanho do lote por execução de trabalho; ondas maiores continuam em trabalhos de acompanhamento a um minuto de distância. |
Análise
| Configuração | Padrão | Finalidade |
|---|---|---|
sitemap_autolink_analytics_enabled |
ligado | Enviar eventos internal_auto_link_click para o Google Analytics via gtag ou dataLayer quando os links gerados são clicados. Sem efeito se nenhum existir. |
Eu uso isso para ajudar a vincular meu site principal ao meu fórum Discourse. Então, um tópico em nossa Wiki ou Loja pode gerar automaticamente um link.
Se alguém estiver falando sobre um produto específico, desde que mencione uma palavra-chave que você atribua ou o próprio nome do produto, o link será adicionado automaticamente no momento do processamento (bake time).
Da mesma forma, se você tiver um site de Wiki, pode pegar os títulos das páginas da Wiki e vinculá-los automaticamente. Digamos que você tenha um site de história e alguém mencione ‘A Guerra de 1812’, que coincide com um artigo da Wiki com o mesmo nome, ele será vinculado automaticamente.
Espero que gostem!