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. dreipc_linkvalidator verifica todos os links internos e externos automaticamente 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 estende este com verificações adicionais, melhores relatórios e uma interface de backend mais intuitiva. 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. dreipc_linkvalidator verifica links externos via requisição HTTP e reporta 404, cadeias de 301 (mais de 2 redirects) e timeouts.

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

dreipc_linkvalidator estende o Linkvalidator Core do TYPO3 com mecanismos de verificação adicionais. O validador Core verifica links no nível do banco de dados: analisa os campos bodytext, header_link e outros campos configurados na tabela de conteúdo e identifica links para páginas ou arquivos excluídos. dreipc_linkvalidator complementa com verificações baseadas em HTTP para URLs externas.

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 são exibidos em uma visualização de backend: tabular, filtrável por tipo de erro (404, 301, timeout, erro SSL), por página e por editor. Cada entrada contém o link, a causa do erro, a página onde ocorre e um link direto para o editor de backend TYPO3.

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 realístico, aumentar timeouts para 15 segundos e colocar domínios com falsos positivos conhecidos em uma whitelist. 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: configurar verificação paralela (5 a 10 requisições simultâneas), restringir a verificação a links externos (links internos são rapidamente verificáveis via consulta ao banco) e ajustar a frequência (links externos semanalmente, internos diariamente).

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. dreipc_linkvalidator pode enviar relatórios por e-mail, detalhados por área da árvore de páginas. O 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 v7 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 como extensão suporta TYPO3 v10 e v11. Para v12 e v13 não existe versão oficial.

Para projetos em TYPO3 v12/v13, surge a questão se dreipc_linkvalidator ainda é necessário. O validador Core na v12 cobre muitas funcionalidades que antes só estavam disponíveis via dreipc: verificação HTTP de links externos, integração Scheduler, visualização backend com filtragem. O que falta: relatórios por e-mail e função whitelist para falsos positivos.

A alternativa: complementar o validador Core com um Command customizado que gera relatórios por e-mail. O esforço é de aproximadamente um dia de desenvolvimento. 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.