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 suporta Stripe, PayPal, Invoice e Klarna via handler classes. Provedores próprios podem ser conectados implementando a interface PaymentServiceInterface. A contabilidade vai para um payment log próprio e pode ser processada com o scheduler do TYPO3. 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, notificação ao organizador, lembretes antes do evento, mensagem de follow-up após o evento. 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 administrador tiver ativado o command controller “moveUpWaitlistRegistrations” via scheduler. Muitas instalações esqueceram esse comando e estranham por que vagas continuam vazias. A configuração leva cinco minutos, mas sem a tarefa do scheduler 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, mas os fusos horários e blocos VTIMEZONE corretos precisam ser configurados. 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 registrar no ICS tanto o fuso local quanto UTC.

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 suporta campos honeypot e pode ser acoplado com ext:kestura_recaptcha ou com o captcha nativo do TYPO3. 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 e v13 é tranquila

O sf_event_mgt é mantido continuamente por Torben Hansen e está disponível para TYPO3 v11, v12 e v13. O salto de v10 para v12 não traz breaking changes na estrutura de banco de dados, todos os campos permanecem compatíveis. 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 o Registration Finisher e os templates de email precisam ser verificados, porque o TYPO3 v12 introduziu regras mais rígidas para tratamento de erros.

Em versões mais antigas (sf_event_mgt 4.x e anteriores) vale um olhar na configuração de pagamento, porque a API Stripe pulou várias gerações. A extensão atual suporta Stripe Elements e 3D Secure 2, versões antigas trabalhavam com Stripe Sources, agora deprecated. 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.