gb_events para TYPO3

Nem todo evento precisa de uma inscrição, mas todo evento precisa de uma apresentação adequada

sf_event_mgt é o padrão para gestão de eventos no TYPO3: inscrição, lista de espera, pagamento, gestão de participantes. Mas muitas organizações apenas exibem eventos, sem inscrição online. Um calendário de concertos, um programa de eventos de uma comunidade, os horários de uma escola popular - em todos esses cenários, sf_event_mgt seria exagero. gb_events preenche essa lacuna: apresentação simples de eventos com visualização em calendário, sem o overhead de um sistema completo de gestão de eventos.

A extensão é feita para organizações que querem publicar datas, mas não gerenciá-las. Sem formulário de inscrição, sem lista de participantes, sem processamento de pagamento. Em compensação, uma listagem limpa, uma visualização em calendário e uma página de detalhe por evento.

Cenários típicos de uso

Sites de comunidades e igrejas. Cultos, concertos, festas comunitárias, tardes para idosos - um calendário típico de comunidade tem 20 a 40 eventos por mês. Visitantes querem ver o que acontece quando, e talvez transferir as datas para seu calendário pessoal. Uma inscrição não é necessária, os eventos são públicos. gb_events mapeia isso com esforço mínimo de configuração.

Escolas populares e instituições educacionais (visão geral do programa). A inscrição para cursos roda por um sistema externo (Kufer, WebOpac), mas o programa deve ser pesquisável no site TYPO3. gb_events mostra os cursos como lista de eventos, filtrada por categoria (idiomas, criatividade, TI, saúde) e período. A página de detalhe vincula ao sistema externo de inscrição.

Séries de eventos com datas recorrentes. Um clube esportivo tem treino às segundas e quartas, um encontro todo primeiro quinta-feira. gb_events apresenta datas recorrentes sem que cada data individual precise ser criada manualmente. A recorrência é configurada, gb_events gera as datas automaticamente.

Arquitetura técnica

gb_events é baseada em Extbase/Fluid e usa uma tabela de banco de dados própria tx_gbevents_domain_model_event. Cada evento tem os campos: título, descrição, data de início, data de término, local, imagem, categoria e opcionalmente uma regra de repetição. As categorias usam as categorias de sistema do TYPO3, o que simplifica a integração com outras extensões.

O frontend consiste em três visualizações: visualização em lista (cronológica, filtrável por categoria e período), visualização em calendário (representação mensal com dias clicáveis) e visualização de detalhe (informações completas do evento). Todas as visualizações são templates Fluid e podem ser sobrescritas no sitepackage.

A visualização em calendário renderiza um grid de tabela HTML com 7 colunas (dias da semana) e 4 a 6 linhas (semanas). Cada célula contém os eventos do respectivo dia como títulos linkados. A navegação entre meses funciona por parâmetro de link (GET), não por AJAX. Isso é amigável ao SEO, porque cada mês tem uma URL própria e pode ser indexado pelo Google.

A lógica de repetição funciona similarmente ao calendarize: um registro com regra de repetição gera eventos virtuais. Estes são calculados em tempo de execução e não materializados no banco de dados. Isso economiza armazenamento, mas requer tempo de computação a cada carregamento de página. O framework de cache do TYPO3 neutraliza essa desvantagem para páginas cacheadas.

Problemas frequentes e soluções

Eventos não aparecem na visualização em lista. Causa frequente: a pasta de armazenamento (Storage PID) no plugin não corresponde à pasta onde os eventos foram criados. gb_events filtra eventos por Storage PID. Solução: selecionar a pasta de armazenamento correta no FlexForm do plugin ou remover a restrição via TypoScript (persistence.storagePid = 0 mostra eventos de todas as pastas).

Eventos passados desaparecem imediatamente. gb_events oculta eventos por padrão assim que a data de término é ultrapassada. Para alguns casos de uso (arquivo de eventos, referências), eventos passados devem permanecer visíveis. Solução: adaptar a query do Repository no controller (incluir eventos passados) ou configurar um modo separado de visualização em lista “Arquivo”.

Sem função de exportação iCal. Visitantes querem transferir eventos para seu calendário. gb_events não oferece download .ics por padrão. Solução: criar um Page-Type próprio para exportação iCal. O template Fluid gera output conforme iCalendar (VCALENDAR, VEVENT, DTSTART, DTEND, SUMMARY, LOCATION). O esforço é de aproximadamente 3 horas de desenvolvimento.

Migração e compatibilidade de versões

gb_events suporta TYPO3 v10 e v11. Para v12 existe uma versão comunitária no GitHub, mas a compatibilidade não é completamente verificada. Para v13, não há planejamento atual.

A alternativa para TYPO3 v12/v13 é sf_event_mgt, a extensão de eventos significativamente mais abrangente e melhor mantida. sf_event_mgt suporta oficialmente v12 e v13. Quem não precisa de funcionalidade de inscrição pode configurar sf_event_mgt sem inscrição e ainda usar a apresentação de eventos e visualização em calendário. O escopo de funcionalidades é maior, mas a complexidade também.

A migração de gb_events para sf_event_mgt requer uma migração de dados: os eventos de tx_gbevents_domain_model_event para tx_sfeventmgt_domain_model_event. Os campos são similares (título, descrição, data, local), mas não idênticos. Um script de migração baseado em SQL resolve isso em 1 a 2 horas. Os templates Fluid devem ser adaptados, pois sf_event_mgt usa ViewHelpers e variáveis diferentes.

Para projetos com poucos eventos (menos de 50 por ano), uma solução customizada baseada em tx_news também é viável: eventos como registros de notícias com campos de data e uma representação em calendário no template. A Gosign orienta sobre a solução mais econômica e assume a migração quando necessário.