sf_event_mgt para TYPO3

sf_event_mgt resolve o problema de que eventos sem inscrição não são eventos

Assim que um site TYPO3 passa a gerenciar mais de dois eventos por ano e precisa receber participantes, qualquer solução improvisada com listas de páginas, plugins de calendário e formulários Powermail atinge seus limites. O sf_event_mgt é a extensão que reúne esses blocos em um sistema de eventos de verdade: gestão de participantes com transições de status, listas de espera com preenchimento automático, pagamento via vários provedores e comunicação por email automatizada ao longo de todo o ciclo de vida da participação. Quem organiza regularmente eventos com vagas limitadas em TYPO3 dificilmente escapa dessa extensão. Torben Hansen construiu o sf_event_mgt desde o início como ferramenta Extbase nativa que se encaixa perfeitamente em instalações TYPO3 existentes e pode ser sobrescrita em qualquer ponto sem fazer fork da extensão principal.

Cenários típicos vão de feiras a programas acadêmicos

Universidades brasileiras usam o sf_event_mgt para dias abertos, aulas experimentais e programas de educação continuada. Na prática, isso significa frequentemente: 30 cursos paralelos, cada um com capacidade própria, faixa de preço e cadeia de emails para interessados, participantes e organizadores. A extensão administra isso via uma única estrutura de dados, incluindo multilinguismo para estudantes internacionais. Em uma universidade típica, usamos o sf_event_mgt com cerca de 400 eventos individuais por ano, entre cursos preparatórios, dias abertos de laboratório e encontros de ex-alunos.

Associações e conselhos profissionais organizam com ele congressos técnicos e seminários em que os participantes pagam preços diferentes conforme o status de associado. Uma instalação típica trabalha com 40 a 80 eventos por ano, muitos pagos e com várias classes de preço. Associados pagam o preço regular, não associados uma sobretaxa, early birds um desconto. A extensão mapeia isso via categorias de preço configuráveis por evento, sem que um desenvolvedor precise intervir.

Empresas, por sua vez, usam o sf_event_mgt para treinamentos internos, eventos com clientes e webinars. Especialmente no B2B, a exportação em CSV é importante: a lista de participantes depois vai ao CRM ou à impressora de crachás no local. Em um conglomerado industrial com 12.000 colaboradores, conectamos a extensão ao sistema interno de Learning Management, de forma que inscrições em treinamentos chegam automaticamente ao sistema de RH e a participação é documentada como comprovante de educação continuada.

Arquitetura técnica baseada em Extbase e FAL

O sf_event_mgt é uma extensão Extbase clássica e segue o padrão MVC do TYPO3. Os models centrais são Event, Registration, Location e Organisator, a configuração vai via TypoScript e templates Fluid. Quase tudo pode ser ajustado via constants.typoscript ou TSconfig, sem fazer fork. A variante plugin oferece mais de uma dezena de actions de controller, da visão de lista e detalhe passando pelo fluxo de inscrição até o filtro de busca e categoria.

Para pagamento, a extensão traz uma abstração que cobre fatura e transferência; Stripe e PayPal existem como extensões adicionais pagas do autor. Provedores próprios podem ser conectados implementando uma classe derivada de AbstractPayment junto com event listeners PSR-14. O status do pagamento fica no registro da inscrição, com forma de pagamento, marcação de pago e referência de pagamento. Pagamentos com falha são documentados e podem ser acompanhados pelo backend, sem que redatores precisem entrar no console do provedor de pagamento.

O sistema de emails se baseia em templates Fluid no diretório EXT. Para cada inscrição, várias mensagens são disparadas: confirmação ao participante e notificação ao organizador; lembretes antes do evento ou mensagens de follow-up depois dele são enviados pelos redatores como notificação própria pelo módulo de backend. Cada um desses emails é um template Fluid que pode ser sobrescrito via SiteSet ou PageTS. Os emails são enviados via TYPO3 Mailer e respeitam as configurações SMTP globais, incluindo SPF e DKIM. Para participantes em lista de espera há templates separados, disparados quando alguém é chamado da lista.

Problemas frequentes envolvem listas de espera, export iCal e ReCaptcha

O tema mais frequente de suporte é a lógica de lista de espera. Quando um participante cancela, o primeiro inscrito na lista de espera é chamado, mas só se o evento tiver ativada, além da lista de espera e do cancelamento, a promoção automática (“Automatic waitlist move up”) e o cancelamento vier pelo frontend. Muitas instalações esqueceram essa opção e estranham por que vagas continuam vazias. A configuração leva cinco minutos, mas sem essa opção a extensão fica em modo manual.

Um segundo tema constante é o export iCal. Participantes querem um clique em “Adicionar ao calendário” que funcione no Outlook, Apple Calendar e Google Calendar. O sf_event_mgt entrega um arquivo ICS com início e fim em UTC, que os calendários convertem para o horário local; para isso, o fuso horário da instalação TYPO3 precisa estar correto. Caso contrário, o evento aparece no Outlook com uma hora de diferença, crítico em mudanças de horário de verão. Em eventos internacionais recomendamos verificar o fuso horário da instalação antes da primeira exportação.

O terceiro tema é proteção contra spam. Formulários públicos de inscrição atraem bots que inundam listas de espera. O sf_event_mgt traz campos honeypot, verificação de links, verificação challenge/response e suporte próprio a reCAPTCHA e hCaptcha. Em instalações produtivas, recomendamos combinar os dois mecanismos e, adicionalmente, um rate limit por endereço IP, para que bots isolados não criem centenas de inscrições falsas.

Migração para TYPO3 v12, v13 e v14

O sf_event_mgt é mantido continuamente por Torben Hansen e está disponível para TYPO3 v10 a v14. O salto de v10 para v12 passa pela versão 6.0.0, que exige alterações no banco de dados e um upgrade wizard para os plugins divididos; a versão 7.0.0 para v12 não precisa de atualização do banco. ViewHelpers próprios da extensão foram atualizados para a nova versão do Fluid, e templates próprios precisam de uma revisão curta após o update. Principalmente templates próprios de notificação e templates de backend sobrescritos precisam ser verificados, porque a versão 7.0.0 exige f:format.raw em vez de f:format.html no backend e templates de backend são sobrescritos via PageTS.

Em versões mais antigas (sf_event_mgt 4.x e anteriores) vale um olhar na configuração de pagamento, porque o núcleo da extensão continua trazendo apenas fatura e transferência. Stripe e PayPal chegam pelas extensões adicionais sf_event_mgt_stripe e sf_event_mgt_paypal, que também precisam ser verificadas no upgrade. A Gosign migra instalações sf_event_mgt existentes tipicamente em um único passo junto com o upgrade do core TYPO3. Templates Fluid são unificados para identificadores consistentes, e chamadas de ViewHelper desatualizadas são identificadas e substituídas automaticamente. No mesmo passo, verificamos se a marcação Schema.org/Event no JSON-LD está em dia e se o template de detalhe do evento contém todos os campos para rich snippets de evento do Google.