Este tutorial explica como adicionar campos extra ao formulário de contato nativo do Joomla utilizando os Campos Personalizados (Custom Fields). Este processo utiliza funcionalidades core do Joomla, não requer extensões de terceiros e é totalmente seguro para futuras atualizações.
Passo 1: Criar um Campo Personalizado
Vamos começar por criar um Campo de Lista Personalizado que permita ao visitante do site selecionar o tipo de pedido que está a fazer.
- Vai a Componentes → Contatos → Campos (Fields).
- No menu suspenso de contexto (filtro lateral ou superior), seleciona Mail.
- Clica em Novo.
- No separador Geral, configura o campo:
- Título: ex: Tipo de Pedido
- Tipo: Lista (escolha este primeiro para carregar as opções certas).
- Obrigatório: Sim/Não, conforme a tua preferência.
- Valores da Lista: Adiciona pares de Texto e Valor (ex.: Suporte Técnico, Comercial, Outros).
Passo 2: Alterar Permissões do Campo (Crítico)
Por defeito, os campos personalizados não permitem que utilizadores públicos enviem dados. Esta é a razão mais comum para o campo não funcionar.
- Edita o campo que acabaste de criar.
- Abre o separador Permissões.
- Localiza a linha Editar Valor do Campo Personalizado (Edit Custom Field Value).
- Para o grupo Public, altera para Permitido (Allowed).
- Guarda as alterações.
Se ignorares este passo, o campo poderá ser visível, mas os visitantes não conseguirão submeter a informação.
Passo 3: Posicionamento no Formulário
No separador Opções do campo personalizado, podes definir onde ele será renderizado:
- Após a exibição (After Display): Geralmente aparece no final do formulário, antes do botão de envio.
- Antes da exibição (Before Display): Aparece no topo dos campos de ontato.
Passo 4: Integração no E-mail
Para garantir que recebes estes dados no teu e-mail, o Joomla utiliza o sistema de Modelos de E-mail (Mail Templates).
- Vai a Sistema → Modelos de E-mail.
- Procura por ontatos: E-mail do Formulário de contato.
- Verifica se o corpo da mensagem contém o marcador
{CUSTOMFIELDS}. Este marcador é responsável por listar todos os teus campos extra no e-mail recebido.
Problemas Comuns & Soluções
- O campo não aparece: Verifica se o contexto selecionado no Passo 1 foi "Mail" e não "ontato".
- Dados vazios no e-mail: Revisa as permissões do grupo "Public" (Passo 2).
- Posicionamento errado: Para controlo total, terás de criar um Template Override do componente de ontatos.
Resumo Rápido
- Contexto: Mail.
- Permissão Public: Permitido.
- Template de e-mail: conter
{CUSTOMFIELDS}.