Validador de links para TYPO3

Links quebrados custam rankings e confiança, e a maioria dos sites TYPO3 tem mais deles do que o esperado

Um site TYPO3 com 500 páginas tem em média 3.000 a 5.000 links. Destes, a experiência mostra que 2 a 5% estão defeituosos: páginas excluídas, URLs alteradas de sites externos, erros de digitação em links inseridos manualmente. São 60 a 250 links quebrados que enviam visitantes a páginas 404 e sinalizam ao Google que o site é mal mantido. Uma verificação automática de links examina links internos e externos e reporta problemas antes que afetem rankings e experiência do usuário.

O TYPO3 traz um validador de links próprio no Core (EXT:linkvalidator). dreipc_linkvalidator não está publicado nem no TER, nem no Packagist, nem no GitHub; por isso, não é possível verificar o que a extensão oferece além do Core. Para sites com mais de 200 páginas, uma verificação automatizada de links não é luxo, mas obrigação.

Cenários típicos de uso

Sites corporativos com links externos. Sites de empresas vinculam a parceiros, fornecedores, associações setoriais, textos legais e artigos de imprensa. URLs externas mudam sem aviso prévio. Um link para uma regulamentação funciona hoje, mas na próxima semana é movido. O Linkvalidator Core verifica links externos via requisição HTTP e reporta endereços que retornam erro ou não respondem.

Universidades e instituições educacionais. Sites de universidades estão entre as páginas mais intensivas em links: regulamentos de curso, formulários, catálogos de disciplinas, diretórios de pessoal, universidades parceiras. Em um site universitário com 12.000 páginas, a verificação de links encontrou 1.400 links defeituosos, dos quais 800 internos (páginas excluídas, áreas reestruturadas) e 600 externos.

Portais editoriais com conteúdo de arquivo. Portais de notícias e revistas com milhares de artigos vinculam entre si e a fontes externas. Ao longo dos anos, links quebrados se acumulam, especialmente em artigos mais antigos. Uma verificação mensal de links identifica novos problemas antes que se acumulem.

Arquitetura técnica

A base de toda verificação de links no TYPO3 é o Linkvalidator Core. Ele verifica links no nível do banco de dados: analisa os campos bodytext, header_link e outros campos configurados na tabela de conteúdo, identifica links para páginas ou arquivos excluídos e verifica URLs externas via requisição HTTP.

A verificação roda como tarefa Scheduler do TYPO3. Configuração típica: uma vez por semana à noite. A tarefa percorre todas as tabelas e campos configurados em busca de links, distingue entre links internos (t3://page?uid=123), links de arquivo (t3://file?uid=456) e links externos (https://…), e verifica a acessibilidade de cada link.

Links internos são verificados contra o banco de dados TYPO3: a página vinculada ainda existe? Não está oculta, não excluída, não expirada? Links de arquivo verificam se o arquivo referenciado ainda existe no FAL. Links externos são verificados via requisição HTTP HEAD (mais rápido que GET, pois nenhum body é transferido). Em caso de erro no HEAD, segue um GET como fallback.

Os resultados aparecem no módulo de backend “Check Links”: em tabela, filtráveis por tipo de link (interno, externo, arquivo) e por profundidade na árvore de páginas. Cada entrada contém o elemento, o caminho da página, o destino do link, a mensagem de erro e um ícone de lápis que leva direto ao formulário de edição.

Problemas frequentes e soluções

Falsos positivos em links externos. Alguns sites bloqueiam requisições automatizadas (proteção contra bots, Cloudflare Challenge). O link funciona no navegador, mas o validador reporta 403 ou timeout. Solução: definir um header User-Agent descritivo, escolher um timeout generoso (ambos via TSconfig) e excluir domínios com falsos positivos conhecidos, com uma classe de verificação própria ou com o brofix (veja abaixo). Em um cliente, esses ajustes reduziram a taxa de falsos positivos de 12% para menos de 2%.

Verificação demora muito em sites grandes. Verificar 10.000 links externos sequencialmente leva várias horas. Solução: rodar a verificação à noite pelo Scheduler, em vez do botão no módulo, dividi-la em várias tarefas para áreas da árvore de páginas e ajustar a frequência (links externos semanalmente, internos diariamente; links internos são rapidamente verificáveis via consulta ao banco).

Editores ignoram os relatórios. A razão mais frequente para listas crescentes de links quebrados: ninguém se sente responsável. Solução: ativar notificações por e-mail para os editores responsáveis. O próprio Linkvalidator Core já envia, a partir da tarefa do Scheduler, um relatório por e-mail, cada tarefa para um ponto de partida na árvore de páginas. Com uma tarefa por área, cada editor recebe apenas os links quebrados em “sua” área.

Migração e compatibilidade de versões

O Linkvalidator Core do TYPO3 (EXT:linkvalidator) faz parte do Core desde o TYPO3 4.5 e é continuamente desenvolvido. No TYPO3 v12 e v13, o validador Core foi significativamente melhorado: melhor performance, nova UI no backend, integração com Scheduler reformulada. dreipc_linkvalidator não está publicado nem no TER nem no Packagist, então também não há ali versão oficial para v12 e v13.

Para projetos em TYPO3 v12/v13, surge a questão se dreipc_linkvalidator ainda é necessário. O validador Core traz o necessário desde o TYPO3 4.5: verificação HTTP de links externos, integração Scheduler, relatórios por e-mail e visualização backend com filtragem. Desde a v13, porém, a verificação de links externos precisa ser ativada explicitamente. O que falta é uma whitelist para falsos positivos.

A alternativa: substituir no validador Core a classe que verifica links externos por uma própria que ignore domínios conhecidos por falsos positivos, ou usar a extensão brofix, que traz essa lista de exclusão. Alternativamente, existem ferramentas externas (Screaming Frog, Ahrefs, Semrush) que verificam links quebrados como parte de sua auditoria SEO, mas não são integradas ao TYPO3. A Gosign recomenda o validador Core em combinação com um crawl externo mensal para máxima cobertura.