Formlog para TYPO3

Por que consultas de contato no TYPO3 podem se perder 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 (PT: RGPD) e ISO 27001. Empresas precisam comprovar que cumprem as normas de proteção de dados, inclusive a eliminação após o fim do tratamento (arts. 6 e 16 da LGPD). Formlog armazena entradas com timestamp e oferece exclusão automática configurável após X dias. Para auditorias ISO 27001, isso documenta quais dados de formulário chegaram e quando.

Análise do comportamento de entrada. Quais campos são frequentemente deixados em branco? Formlog torna visíveis no backend as entradas enviadas; desistências antes do envio ele não registra. 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 na posição em que está na lista de Finishers; antes do Finisher de e-mail, ele registra mesmo quando o envio falha. 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 ou Excel (XLSX). A exclusão conforme LGPD ocorre via tarefa scheduler “Table garbage collection” do Core após um número configurável de dias (padrão: 180 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 versão atual 2.6.0 suporta TYPO3 v13 e v14; séries anteriores vão até a v8. 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.