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 pública 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 é um complemento da extensão de calendário calendarize, do mesmo autor (Tim Lochmüller). Ele anexa aos registros de notícias, no campo calendarize, configurações de datas: data de início, data de término, flag de dia inteiro, regra de repetição e exceções. A partir delas, o calendarize grava ao salvar uma entrada por compromisso individual na sua tabela de índice.

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 registra as notícias como tipo de evento no calendarize; as visualizações de calendário vêm do plugin do calendarize, ao qual o calendarize_news acrescenta um campo para a página de notícias. 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 as datas ficam em configurações do calendarize, que primeiro precisam ser acrescentadas aos registros de notícias existentes no campo calendarize. Solução: um script de migração que cria, a partir de datetime, uma configuração do calendarize por notícia leva 30 minutos de desenvolvimento.

Problemas de performance com muitos eventos recorrentes. Quando 50 eventos recorrentes geram 52 compromissos cada, o índice do calendário tem 2.600 entradas que a visualização mensal precisa filtrar. Isso é perceptível em cada carregamento de página sem cache. Solução: entregar as visualizações de lista e mensal com cache, como o calendarize faz por padrão, e limitar o intervalo de tempo para o qual o calendarize grava compromissos no índice (configuração tillDays). Eventos com mais de 12 meses no futuro não precisam estar no índice.

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 de tx_news e do calendarize. A versão atual 9.0.0 exige TYPO3 13.4, tx_news a partir da versão 12 e calendarize 13 ou 14; para TYPO3 v12 existe a versão 8.0.1.

calendarize (sem sufixo _news) de lochmueller é uma extensão de calendário independente, com modelo de dados próprio, e ao mesmo tempo a base sobre a qual o calendarize_news se apoia: as datas das notícias já ficam nas tabelas do calendarize. A versão atual 15 suporta TYPO3 13.4 e 14.

Para projetos que migram para TYPO3 v13 e querem manter tx_news, o caminho mais pragmático é: usar o calendarize_news na versão 9 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.