sg_forms para TYPO3

Três sistemas de formulários no TYPO3 geram mais confusão do que liberdade de escolha

Na hora de implementar formulários, projetos TYPO3 enfrentam um problema de luxo incomum: existem três opções sérias. O Form Framework nativo do TYPO3 (ext:form), o powermail, da in2code, e o sg_forms, da SGalinski. Cada solução tem pontos fortes e limites próprios. O sg_forms se posiciona como meio-termo: mais leve que o powermail, mas com mais conforto no backend do que o ext:form. A extensão vem da prestadora de serviços TYPO3 SGalinski e é usada ativamente nos projetos dos clientes dela.

Quem já usa extensões da SGalinski (sgalinski_base, sg_cookie_optin) encontra no sg_forms uma solução que se encaixa sem atrito no ecossistema SGalinski.

Os cenários típicos são formulários de contato, pedidos de orçamento e candidaturas simples

O cenário padrão é o formulário de contato num site corporativo: nome, e-mail, assunto, mensagem, checkbox de consentimento da LGPD (PT: RGPD), enviar. O sg_forms entrega esse setup como template pré-configurado, que os redatores ativam e ajustam no backend. É possível adicionar, remover e reordenar campos, marcar campos obrigatórios e definir validações. O e-mail vai para um ou mais destinatários configuráveis.

Um segundo cenário são formulários de solicitação em várias etapas. Uma empresa de reformas pede, na etapa 1, os dados de contato; na etapa 2, o tipo de serviço (dropdown); e, na etapa 3, fotos do imóvel (upload de arquivos). O sg_forms suporta formulários em várias etapas, com indicador de progresso e botão de voltar. Depois do envio, os dados seguem por e-mail e, opcionalmente, são gravados no banco de dados.

Terceiro cenário: formulários simples de candidatura. Uma pequena ou média empresa com três vagas abertas não precisa de um sistema de recrutamento, e sim de um formulário que receba currículo e carta de apresentação em PDF e os encaminhe ao RH. Para isso, o sg_forms oferece upload de arquivos com validação de tipo e tamanho, combinado com um e-mail de confirmação para o candidato.

A arquitetura técnica se baseia em Extbase, com definição de formulários em YAML

O sg_forms registra um plugin Extbase que renderiza formulários a partir de uma configuração. A definição do formulário é criada no backend por uma interface gráfica ou, alternativamente, escrita como arquivo YAML. Cada campo tem um tipo (texto, e-mail, área de texto, select, radio, checkbox, arquivo, oculto), regras de validação e condições opcionais.

A arquitetura de finishers segue o mesmo padrão do powermail: depois do envio, ações são executadas em sequência. Os finishers padrão são envio de e-mail, gravação no banco de dados e redirecionamento para uma página de agradecimento. Finishers customizados podem ser implementados como classes PHP, por exemplo para integrações com CRM ou chamadas de webhook.

A renderização no frontend usa templates Fluid, que podem ser sobrescritos via SiteSet ou TypoScript. A extensão traz um template padrão que funciona sem ajustes, mas que em sites de produção costuma ser adaptado à identidade visual. A proteção contra spam está disponível com campos honeypot e integração opcional de CAPTCHA.

Os problemas frequentes envolvem a escolha entre sg_forms e powermail e a licença da SGalinski

A pergunta mais comum é: sg_forms ou powermail? A resposta depende do porte do projeto. O powermail tem a comunidade maior, mais documentação, mais finishers de terceiros e um leque de funções mais amplo (exportação em PDF, lógica em várias etapas de qualquer complexidade). O sg_forms é mais enxuto, tem menos overhead e é o padrão nos projetos da SGalinski. Para a maioria dos sites corporativos, o powermail é a escolha mais segura. Para clientes da SGalinski que já estão no ecossistema, o sg_forms é a mais coerente.

Segundo tema: o licenciamento. O sg_forms não está disponível no TER (TYPO3 Extension Repository) como extensão gratuita; ele é entregue por meio de projetos da SGalinski. Isso significa que equipes que queiram usar a extensão sem relação com a SGalinski precisam esclarecer diretamente com ela a disponibilidade e as condições de licença.

Terceiro problema: migração. Quem troca o powermail pelo sg_forms (ou o contrário) precisa recriar todas as definições de formulário existentes, porque as estruturas de dados são incompatíveis. Os registros de formulário já gravados no banco de dados não podem ser migrados automaticamente.

O sg_forms segue o ciclo de releases da SGalinski e já suporta a v14

A SGalinski mantém o sg_forms num ciclo de releases próprio, atrelado às versões LTS do TYPO3. A série 6 cobre o TYPO3 v12, a série 7 o v13 e a série 8 já o v14 (setembro de 2026). Na escolha do sistema de formulários, a Gosign recomenda pesar a manutenção de longo prazo e o tamanho da comunidade como fatores de decisão: o powermail, com mais de 2,7 milhões de downloads via Composer (Packagist, setembro de 2026), tem uma base muito mais ampla do que o sg_forms.