tt_news Migration para TYPO3

Quem ainda usa tt_news bloqueia qualquer upgrade TYPO3 a partir da versão 10

tt_news foi por mais de uma década a extensão padrão para notícias, comunicados de imprensa e posts de blog no TYPO3. Milhares de sites foram construídos com ela, alguns com centenas ou milhares de artigos. O problema: tt_news foi oficialmente suportado pela última vez para TYPO3 v7. Desde TYPO3 v8 (2017) não existe release compatível. Quem ainda tem tt_news em uso está preso a uma versão TYPO3 desatualizada e não pode usar atualizações de segurança nem novos recursos.

A substituição oficial é GeorgRinger/news (abreviado: EXT:news), desenvolvida desde 2012 como sucessora. news é a extensão TYPO3 mais instalada de todas (mais de 250.000 instalações ativas, dados 2026) e suporta TYPO3 v11, v12 e v13. news_ttnewsimport é a extensão de migração que automatiza a transição: artigos, categorias, imagens, Related News e referências de página são transferidos de tt_news para EXT:news.

Cenários típicos de uso

Upgrade TYPO3 de v7/v8/v9 para v12 ou v13. O caso mais frequente: uma empresa opera um site TYPO3 em v7 ou v9, com 500 a 5.000 artigos de notícias em tt_news. O upgrade planejado para v12 LTS falha por causa do tt_news, pois a extensão não é compatível. news_ttnewsimport transfere todos os dados para a estrutura EXT:news, permitindo a continuação do upgrade.

Relançamento com dados existentes. Em um relançamento de site, o design deve ser completamente novo, mas os artigos existentes devem ser preservados. Os artigos construíram valor SEO ao longo dos anos (backlinks, indexação, rankings). Um recomeço sem migração destruiria esse valor.

Ambientes multi-site com banco de dados de notícias compartilhado. Corporações com 5 a 20 instâncias TYPO3 que mantêm notícias centralmente e as distribuem em todos os sites. A migração deve ocorrer de forma coordenada.

Arquitetura técnica

news_ttnewsimport é uma extensão baseada em CLI que roda via TYPO3 Command Controller. O processo de migração funciona em cinco etapas. Primeiro, categorias tt_news (tt_news_cat) são convertidas em entradas sys_category. A hierarquia de categorias (pai-filho) é mantida. Depois, os registros de notícias são migrados: título, teaser, bodytext, autor, data, tipo, data de arquivo e status. Na terceira etapa, imagens e mídias são convertidas para referências FAL. A quarta etapa migra Related News como relações. Na última etapa, elementos de conteúdo nas páginas de notícias são atualizados: plugins tt_news são substituídos por plugins EXT:news.

Problemas frequentes e soluções

Imagens faltam após a migração. tt_news armazenava imagens como nomes de arquivo em um campo de texto, os arquivos ficavam em uploads/pics/. EXT:news usa FAL. Se os arquivos físicos não estão mais no diretório esperado, a migração de imagens falha. Solução: verificar antes da migração se todas as imagens referenciadas estão fisicamente presentes.

Atribuições de categoria se perdem. tt_news usava tabelas de categoria próprias, EXT:news usa sys_category. Se a migração não mapeia corretamente os IDs de categoria, artigos perdem sua atribuição. Solução: news_ttnewsimport cria um mapeamento (ID antigo para novo ID) e atualiza todas as referências.

Estrutura de URL muda, rankings SEO caem. Artigos tt_news tinham URLs como /news/detail/titulo-do-artigo/. EXT:news gera por padrão /news/titulo-do-artigo/. Solução: configurar redirects 301 das URLs antigas para as novas. Com 1.000 artigos, isso não é viável manualmente. A Gosign gera o mapa de redirects automaticamente a partir das estruturas de URL antigas e novas.

Migração e compatibilidade de versões

news_ttnewsimport suporta a migração para EXT:news no TYPO3 v11 e v12. O procedimento recomendado: primeiro fazer upgrade do TYPO3 para v11, depois executar news_ttnewsimport, depois fazer upgrade para v12 ou v13.

Para acervos muito grandes (mais de 10.000 artigos), a Gosign recomenda realizar a migração em um sistema staging e verificar o resultado antes de converter a produção. A migração em si leva entre 30 minutos (500 artigos) e 4 horas (10.000 artigos com imagens). A adaptação de templates (templates Fluid para a nova saída EXT:news) vem como esforço separado e fica tipicamente entre 2 e 5 dias.

Um aspecto frequentemente subestimado da migração tt_news é a comunicação com motores de busca. O Google indexou e avaliou as URLs antigas. Se após a migração 500 URLs retornam 404, o site perde posições no ranking. A Gosign configura após cada migração um monitoramento de redirects: uma semana após o go-live, dados do Google Search Console são verificados para erros 404, redirects ausentes são adicionados e a indexação das novas URLs é acelerada via IndexNow.