Formlog para TYPO3

Por que uma em cada três consultas de contato no TYPO3 se perde sem logging

Formulários de contato são o canal de leads mais importante em sites corporativos. Mas o Form Framework do TYPO3 por padrão não armazena entradas no banco de dados - apenas envia e-mails. Se o servidor de e-mail cai, o registro SPF está mal configurado ou o timeout SMTP dispara, a consulta está perdida. Sem backup, sem rastreamento, sem análise. Formlog fecha essa lacuna registrando cada entrada de formulário no banco de dados TYPO3 - independentemente de o envio do e-mail ter sido bem-sucedido.

Na prática, isso afeta mais empresas do que se imagina: taxas de entrega de e-mail de servidores web ficam segundo estudos entre 85% e 95%. Com 100 consultas de contato por mês, isso significa 5 a 15 leads perdidos. Com um valor médio de lead de 500 EUR no B2B, soma-se 2.500 a 7.500 EUR de faturamento perdido por mês.

Cenários típicos de uso

Proteção contra falhas de e-mail. Uma empresa de médio porte opera 3 formulários de contato em seu site TYPO3. O servidor SMTP do provedor tem timeout por 6 horas no fim de semana. Sem Formlog, todas as consultas nesse período estão perdidas. Com Formlog, a equipe de marketing encontra todas as entradas no backend TYPO3 na segunda-feira e pode dar seguimento manualmente.

Comprovação de conformidade para LGPD e ISO 27001. Empresas precisam comprovar quando quais dados pessoais foram recebidos e quando foram excluídos. Formlog armazena entradas com timestamp e oferece exclusão automática configurável após X dias. Para auditorias ISO 27001, isso fornece documentação completa do processamento de dados.

Análise do comportamento de entrada. Quais campos são frequentemente deixados em branco? Em qual etapa do formulário os usuários desistem? Formlog torna esses dados visíveis no backend. Um integrador TYPO3 pode derivar otimizações sem usar uma ferramenta de analytics externa para formulários.

Arquitetura técnica

Formlog se integra como Finisher no TYPO3 Form Framework (EXT:form). Cada formulário que tem um Finisher Formlog configurado escreve suas entradas após o submit em uma tabela de banco de dados própria (tx_formlog_entries).

A arquitetura em detalhe: o Finisher roda após a validação e antes do Finisher de e-mail. Cada entrada é armazenada como array serializado em JSON, junto com metadados (timestamp, identificador do formulário, idioma, página). O módulo de backend permite que editores e administradores filtrem, pesquisem e exportem as entradas registradas como CSV. A exclusão conforme LGPD ocorre via tarefa scheduler após um número configurável de dias (padrão: 90 dias).

Dependências: Formlog requer o TYPO3 Form Framework (EXT:form), que faz parte do Core desde TYPO3 v8. Extensões de formulário mais antigas como Powermail ou Formhandler não são suportadas - lá o logging é integrado nativamente.

Problemas frequentes e soluções

Formlog não registra todos os campos do formulário. Causa: o Finisher Formlog deve ser configurado após a etapa de validação, mas antes do Finisher de redirect. Se o redirect atua primeiro, o Finisher Formlog não é mais executado. Solução: na configuração YAML, verificar a ordem dos Finishers - Formlog deve estar na posição 1.

Módulo de backend não mostra entradas. Frequentemente um problema de permissões: o usuário ou grupo de backend não tem acesso ao módulo Formlog. Solução: nas configurações de grupo de backend, ativar o módulo formlog em “Módulos permitidos”.

Exclusão automática não funciona. O TYPO3 Scheduler deve estar corretamente configurado e rodando regularmente (cronjob a cada 5 a 15 minutos). Sem scheduler funcionando, a tarefa de exclusão nunca é acionada.

Migração e compatibilidade de versões

Formlog foi desenvolvido pela Pagemachine e está disponível como pacote Composer (pagemachine/typo3-formlog). A extensão suporta TYPO3 v10 a v12 LTS. Para TYPO3 v13 ainda não há release oficial, mas a base de código usa APIs TYPO3 estáveis.

Quem migra de Powermail para o TYPO3 Form Framework perde o logging integrado do Powermail. Formlog é o substituto recomendado. A Gosign migra formulários incluindo configuração de logging.

Um aspecto que muitas equipes de projeto negligenciam: Formlog não é apenas uma ferramenta de backup, mas também uma ferramenta de auditoria. Quando um cliente alega ter enviado uma consulta há 3 semanas que nunca foi respondida, Formlog fornece a prova - ou a entrada existe com timestamp, ou nunca foi enviada. Para empresas com acordos de nível de serviço e gestão de reclamações, essa é uma vantagem mensurável que justifica a instalação em 10 minutos.