calendarize_news para TYPO3

Eventos em tx_news pertencem a um calendário, não a uma lista cronológica

A maioria dos sites TYPO3 usa tx_news de Georg Ringer para tudo: notícias, artigos de blog, comunicados de imprensa e eventos. Para os três primeiros tipos, a listagem cronológica funciona. Para eventos, não. Visitantes esperam uma visualização em calendário com exibição mensal, semanal e diária. Querem clicar em uma data e ver o que acontece naquele dia. calendarize_news constrói exatamente essa ponte: pega registros tx_news existentes com campos de data e os renderiza como calendário.

A extensão evita a troca para um sistema de eventos independente. Quem já usa tx_news mantém sua estrutura de dados, seus templates e seus processos editoriais. Em vez de uma segunda extensão com armazenamento de dados separado, há uma visualização em calendário sobre dados existentes.

Cenários típicos de uso

Calendário de eventos em sites corporativos. Uma instituição educacional publica 150 seminários por ano via tx_news. Cada seminário tem data de início, data de término e horário. Sem calendarize_news, visitantes veem uma lista longa ordenada por data. Com calendarize_news, veem um calendário mensal, clicam no dia 15 de maio e encontram três seminários. A conversão da visualização em calendário para a página de detalhe foi 40% maior em um cliente do que da visualização em lista.

Eventos recorrentes sem duplicação de dados. Um encontro semanal, um webinar mensal, uma festa anual da empresa: sem funcionalidade de recorrência, o editor precisa criar 52 registros para o encontro semanal. calendarize_news suporta regras de repetição (diária, semanal, mensal, anual) com exceções. Um registro gera 52 entradas de calendário. Se um compromisso é cancelado, é marcado como exceção, não excluído.

Páginas combinadas de notícias e eventos. Muitas organizações mostram na página inicial “Novidades”, uma mistura de notícias e eventos futuros. calendarize_news permite exibir os mesmos registros cronologicamente na lista de notícias e por data no calendário. Duas visualizações, uma fonte de dados, sem esforço de sincronização.

Arquitetura técnica

calendarize_news estende tx_news com campos adicionais na tabela tx_news_domain_model_news: data de início, data de término, flag de dia inteiro, regra de repetição e datas de exceção. A lógica de repetição é implementada na extensão e gera compromissos virtuais em tempo de execução, sem criar um registro no banco de dados para cada compromisso individual.

A exibição do calendário é feita por templates Fluid que renderizam um grid mensal. Cada célula (dia) contém os eventos daquele dia. Os templates são completamente personalizáveis. Por padrão, a extensão fornece templates para visualização mensal, semanal e diária. A navegação entre meses funciona por AJAX ou carregamento de página clássico, configurável via TypoScript.

A integração com tx_news é profunda: calendarize_news se registra como plugin adicional (list type) e utiliza o padrão Repository de tx_news. Categorias, tags e restrições de acesso do tx_news são mantidos. Um evento atribuído à categoria “Interno” e visível apenas para usuários logados aparece no calendário também apenas após login.

A função de exportação iCal gera arquivos .ics para eventos individuais ou o calendário inteiro. Visitantes podem importar eventos diretamente no Outlook, Apple Calendar ou Google Calendar. A exportação usa o formato iCalendar (RFC 5545) e considera regras de repetição.

Problemas frequentes e soluções

Calendário não mostra eventos, embora haja notícias. Causa mais frequente: os campos de data dos registros de notícias não estão preenchidos. tx_news tem um campo datetime, mas calendarize_news usa campos próprios para data de início e término. Após a instalação, registros de notícias existentes devem ser complementados com os campos calendarize. Solução: um script de migração que copia datetime para os campos calendarize leva 30 minutos de desenvolvimento.

Problemas de performance com muitos eventos recorrentes. Quando 50 eventos recorrentes geram 52 compromissos virtuais cada, a extensão precisa filtrar 2.600 entradas para a visualização mensal. Isso é perceptível em cada carregamento de página sem cache. Solução: cachear o cálculo de recorrência (calendarize_news suporta o Caching Framework do TYPO3) e limitar o intervalo de tempo. Eventos com mais de 12 meses no futuro não precisam ser calculados a cada request.

Exibição responsiva do grid de calendário. Um grid de 7 colunas para dias da semana funciona no desktop, mas não em smartphones. Os templates padrão de calendarize_news não são otimizados para mobile. Solução: adaptar os templates Fluid e renderizar uma visualização em lista em dispositivos móveis em vez do grid. Um breakpoint CSS em 768px é suficiente para alternar entre grid e lista.

Migração e compatibilidade de versões

calendarize_news depende diretamente de tx_news e segue seu ciclo de versões com atraso. A versão estável atual suporta TYPO3 v11 e v12 com tx_news v10/v11. Para TYPO3 v13 existe uma versão beta no GitHub.

A alternativa calendarize (sem sufixo _news) de lochmueller é uma extensão de calendário independente que não se baseia em tx_news, mas traz um modelo de dados próprio. É mantida mais ativamente e suporta oficialmente TYPO3 v12 e v13. A mudança de calendarize_news para calendarize requer uma migração de dados: os dados de eventos devem ser transferidos da tabela tx_news para as tabelas calendarize.

Para projetos que migram para TYPO3 v13 e querem manter tx_news, o caminho mais pragmático é: usar a versão beta de calendarize_news ou construir a representação em calendário como template Fluid customizado diretamente em tx_news. O esforço para um template customizado é de 2 a 3 dias, o resultado é independente de manutenção de terceiros. A Gosign implementou ambos os caminhos e recomenda a variante adequada conforme a complexidade das regras de repetição.