newscanonical para TYPO3

Conteúdo duplicado por falta de tags canonical custa posições às páginas de notícias do TYPO3

Um artigo do tx_news costuma ficar acessível por três URLs ou mais: pelo caminho da categoria (/noticias/marketing/titulo-do-artigo), pelo arquivo (/noticias/2025/03/titulo-do-artigo) e por um link direto (/noticias/titulo-do-artigo). Para o visitante, tanto faz; para o Google, é um problema. O Google enxerga três páginas separadas com conteúdo idêntico e precisa decidir qual é a “certa”. Sem uma tag canonical apontando para a URL preferida, o Google distribui os sinais de ranking entre todas as variantes e enfraquece cada uma delas. O newscanonical resolve esse problema para o tx_news: em cada página de detalhe de notícia, gera uma tag canonical que aponta para a URL definitiva.

A extensão é uma ferramenta de SEO focada, que faz exatamente uma coisa: evitar conteúdo duplicado no tx_news. Em sites com mais de 100 notícias, isso pode ser a diferença entre a primeira e a terceira página do Google.

Os cenários típicos são sites de notícias, revistas e salas de imprensa

O cenário padrão é o site corporativo com uma área de notícias ou blog. A empresa publica artigos toda semana, organizados em categorias (produtos, setores, eventos). Cada artigo aparece na lista da categoria e no arquivo geral. Sem o newscanonical, o Google indexa cada variante de URL separadamente, o que, com 500 artigos, pode resultar em 1.500 páginas indexadas com conteúdo duplicado. No relatório de indexação do Google Search Console, o caso aparece como “Duplicate, Google chose different canonical than user” (na interface em inglês): o Google escolheu uma URL canônica diferente da indicada pelo site.

Segundo cenário: revistas online com listas baseadas em tags e categorias. Uma revista tem 20 categorias e 50 tags. Cada artigo tem pelo menos uma categoria e duas ou três tags. A combinação gera dezenas de caminhos de URL possíveis por artigo. O newscanonical consolida todas as variantes numa única URL canônica.

Terceiro cenário: salas de imprensa de empresas de capital aberto. Comunicados obrigatórios precisam ficar disponíveis de forma permanente e não podem sumir dos resultados de busca por causa de conteúdo duplicado. Uma tag canonical correta garante que o Google indexe a versão definitiva.

A arquitetura técnica insere uma tag link no cabeçalho HTML de cada página de detalhe

O newscanonical se registra no pipeline de renderização do tx_news e insere no cabeçalho HTML da página de detalhe uma tag <link rel="canonical" href="...">. A URL canônica é calculada a partir do PID configurado da página de detalhe e do UID da notícia, independentemente do caminho pelo qual o visitante chegou à página.

A configuração é feita em TypoScript: o PID da página de detalhe é definido como base da URL canônica. Parâmetros opcionais, como a estrutura de URL (RealURL ou TYPO3 Site Handling) e a inclusão de segmentos de categoria na URL canônica, são controlados por constantes.

A extensão atua como hook no pipeline de renderização do tx_news, não como plugin independente. Ou seja: não tem saída própria no frontend nem elemento de conteúdo próprio. O único efeito visível é a tag canonical no código-fonte HTML, que os buscadores leem e os visitantes nunca veem.

Para funcionar corretamente, o PID da página de detalhe precisa ser o mesmo na configuração do tx_news e na do newscanonical. Se o tx_news usa várias páginas de detalhe (por exemplo, uma por categoria), o newscanonical precisa ser configurado de acordo, para que a URL canônica aponte para a página de detalhe certa.

Os problemas frequentes são PID errado, conflito com o canonical do core e loops de redirecionamento

Primeiro problema: PID da página de detalhe errado. Se o PID na configuração do newscanonical não bate com o do tx_news, a tag canonical aponta para uma página que nem consegue exibir o artigo. O Google então ignora a tag e escolhe sozinho uma variante. A solução: conferir a consistência dos PIDs e comparar, no Google Search Console, as URLs canônicas indexadas com as URLs configuradas.

Segundo problema: conflito com o canonical do core do TYPO3. Desde o TYPO3 v9.5, o core gera URLs canônicas por conta própria, por meio da extensão de sistema seo. Se as duas soluções estiverem ativas, podem aparecer duas tags canonical concorrentes no cabeçalho HTML. A solução: verificar se o canonical do core funciona corretamente nas páginas de detalhe de notícias. Se funcionar, o newscanonical é dispensável e pode ser desativado. Se o canonical do core não incluir corretamente os parâmetros do news na URL, o newscanonical continua necessário.

Terceiro problema: loops de redirecionamento por configuração de URL incorreta. Se a URL canônica aponta para uma página que, por sua vez, redireciona para outra URL, forma-se um loop. Isso acontece tipicamente depois de uma reestruturação de URLs em que os redirecionamentos antigos não foram limpos. A solução: revisar todos os redirecionamentos de URLs de notícias e remover as entradas inconsistentes.

A partir do TYPO3 v12, a Gosign verifica se o canonical do core é suficiente

Com o TYPO3 v12, o comportamento do canonical no core mudou: a extensão de sistema seo gera URLs canônicas com base no Site Handling e só aproveita os parâmetros de query que o routing resolve, por exemplo por meio de um Route Enhancer para o tx_news. Para muitas configurações do tx_news com routing bem configurado, o canonical do core basta, e o newscanonical deixa de ser necessário. A cada upgrade do TYPO3, a Gosign verifica se a solução do core gera corretamente as URLs canônicas de notícias. Se gerar, recomendamos desativar o newscanonical, para eliminar um potencial ponto de conflito. Se as URLs de notícias contêm parâmetros complexos ou caminhos de categoria que o core não resolve, a extensão continua sendo uma solução válida. Em qualquer caso, recomendamos após o upgrade um crawl sistemático com o Screaming Frog ou uma ferramenta equivalente, para verificar o comportamento do canonical em todas as páginas de detalhe. Uma única tag canonical mal configurada pode tirar dezenas de páginas do índice do Google, o que, em salas de imprensa ou posts de blog relevantes para SEO, significa perda direta de tráfego.