News-Sync para TYPO3

Quando as notícias precisam aparecer em várias instâncias TYPO3, copiar e colar não basta

Organizações com vários sites enfrentam um problema concreto: uma confederação nacional publica um comunicado de imprensa, e 15 federações estaduais precisam exibi-lo em suas próprias instalações TYPO3. Ou um grupo empresarial mantém um site corporativo e cinco sites de marca, e determinadas notícias devem aparecer nos seis. Copiar à mão é propenso a erros, toma tempo e gera inconsistências. O newssync resolve o problema sincronizando automaticamente artigos de notícias entre instâncias TYPO3 ou a partir de fontes externas. Importação de RSS, sincronização via API e detecção de duplicatas são as funções centrais.

Para organizações com estratégia multisite, a sindicação de conteúdo não é um nice-to-have, e sim uma necessidade operacional. Sem sincronização automatizada, surgem silos de conteúdo que a redação central não consegue controlar.

Os cenários típicos são redes de entidades, sites corporativos e agregação de notícias

O cenário mais comum é a rede de entidades de classe. Uma confederação nacional publica notícias do setor, atualizações regulatórias e comunicados de imprensa no seu site TYPO3. As 16 federações estaduais mantêm instalações TYPO3 próprias e querem incorporar automaticamente artigos selecionados. O newssync importa os artigos marcados via feed RSS ou API, cria registros locais do tx_news e permite que cada federação ajuste localmente teasers e categorias.

Segundo cenário: sites corporativos com estratégia de content hub. A matriz mantém um hub de notícias do qual os sites de marca e os sites de cada país puxam conteúdo de forma seletiva. A sincronização é feita por categoria: um site de marca assina apenas artigos de duas categorias, “Produto X” e “Inovação”, e não o feed completo.

Terceiro cenário: agregação de notícias de fontes externas. Um portal setorial importa automaticamente comunicados de imprensa de empresas associadas pelos respectivos feeds RSS. O newssync consulta os feeds em intervalos configuráveis, importa artigos novos e reconhece duplicatas pelo título e pela data de publicação.

A arquitetura técnica usa parsing de RSS e o pipeline do Scheduler do TYPO3

O newssync trabalha com dois modos de importação: importação de feeds RSS/Atom e sincronização via API. No modo RSS, o administrador configura a URL de um feed, e a tarefa do Scheduler faz o parsing do feed, extrai título, teaser, corpo, data e URLs de mídia e cria registros do tx_news no banco de dados local. As imagens são baixadas e salvas localmente como arquivos FAL, para que a fonte não precise ficar acessível o tempo todo.

No modo API, o newssync se comunica com um endpoint REST na instância de origem. Isso permite uma importação mais seletiva: em vez de importar o feed inteiro, é possível filtrar artigos por categorias, tags ou data. O modo API também transfere campos customizados que o formato RSS não consegue representar.

A detecção de duplicatas se baseia numa chave configurável: por padrão, um hash do título e da data de publicação. Se já existe um artigo com a mesma chave, ele é ignorado ou atualizado, conforme a configuração. Isso evita que o mesmo artigo seja importado várias vezes quando o job de sincronização roda com mais frequência do que o feed é atualizado.

A sincronização roda como tarefa do Scheduler do TYPO3, tipicamente a cada 15 a 60 minutos. O resultado de cada execução é registrado: quantidade de artigos importados, atualizados e ignorados. Em caso de erro (feed inacessível, falha no parser), um aviso é gravado no log do TYPO3.

Os problemas frequentes são importação de mídia, limpeza de HTML e mapeamento de categorias

Primeiro problema: a importação de mídia falha. Imagens e documentos referenciados no feed de origem nem sempre podem ser baixados diretamente. Proteção contra hotlinking, autenticação ou URLs servidas por CDN podem impedir o download. A solução: testar as URLs de mídia antes da importação e implementar um mecanismo de fallback que substitua imagens ausentes por uma imagem de placeholder.

Segundo problema: HTML sujo no conteúdo importado. Feeds RSS muitas vezes trazem HTML fora do padrão do sistema de destino: estilos inline, tags obsoletas, parágrafos ausentes. A solução: uma limpeza de HTML (sanitizing) depois da importação, que remova tags e estilos desnecessários e leve o conteúdo ao formato esperado. O TYPO3 oferece para isso a classe RteHtmlParser.

Terceiro problema: mapeamento de categorias entre origem e destino. As categorias do feed de origem não coincidem com as categorias locais. O que na confederação se chama “Comunicado de imprensa”, na federação estadual se chama “Imprensa”. A solução: uma tabela de mapeamento na configuração do newssync, que associe as categorias de origem às sys_categories locais do TYPO3.

Um quarto problema diz respeito ao controle editorial: se uma federação estadual altera localmente um artigo sincronizado e a confederação também atualiza o original, a próxima sincronização sobrescreve a alteração local. A solução: marcar os artigos sincronizados como “read-only” e permitir ajustes locais apenas em campos dedicados (por exemplo, teaser local, complemento regional), que a sincronização não toca.

A extensão não tem suporte garantido ao v12, e soluções sob medida são mais robustas

O newssync foi desenvolvido para versões mais antigas do TYPO3 e não tem suporte oficial ao v12 nem ao v13. Para organizações que precisam da sindicação de conteúdo como função central, a Gosign recomenda uma solução sob medida: um importador próprio, rodando como tarefa do Scheduler, que consome feeds RSS ou uma API REST e cria registros do tx_news. O esforço para uma implementação básica com importação de feeds, detecção de duplicatas e download de mídia fica entre 3 e 5 dias úteis. A geração de código apoiada por IA acelera bastante o desenvolvimento do parser de feeds e da camada de mapeamento.

A vantagem de uma solução sob medida: o mapeamento entre categorias de origem e de destino, o tratamento de mídia e o tratamento de erros podem ser ajustados exatamente às necessidades da organização. Uma confederação com 16 federações estaduais tem requisitos de sincronização diferentes dos de um grupo com 5 sites de marca. A Gosign implementa soluções de sindicação de conteúdo com base em APIs modernas do TYPO3 (eventos PSR-14, Symfony Messenger para processamento em filas), que continuam compatíveis também nos upgrades para o v13.