Como configurar o FormMail?

ATENÇÃO!: esta funcionalidade foi desativada já que é obsoleta atualmente. Em seu lugar, pode-se usar qualquer ferramenta externa de envio de emails via formulário, como por exemplo MailThisTo, FormsPark ou MailSlurp

Configuração do Formulário:

A ação do seu formulário precisa apontar para este script, e o método deve ser POST ou GET em letras maiúsculas. A versão 1.5 do FormMail oferece muitos novos caminhos para codificar seu formulário para adaptar a página HTML que resulta e a forma como os scripts atuam. A seguir há uma lista de campos de formulário que você pode utilizar e a forma de implementá-los.

Endereço para o CGI FormMail: /cgi-sys/form-mail.cgi

Campos de formulário necessários:

Só há um campo que você deve ter em seu formulário para que o FormMail funcione corretamente. Este é o campo recipient.

Campo: recipient

• Descrição: Este campo de formulário permite especificar para quem você deseja que sejam enviados por e-mail os resultados de seu formulário. Provavelmente você deseja configurar esta opção como um campo de formulário oculto com um valor igual ao seu endereço de e-mail.
• Sintaxe: <input type=hidden name="recipient" value="email@your.host.com" />

Campos de formulário opcionais:

Campo: subject

• Descrição: O campo subject permitirá especificar o assunto que deseja que apareça no e-mail que é enviado a você quando alguém preenche o formulário. Se não desejar ter esta opção ativada, o script enviará a mensagem com um assunto padrão: WWW Form Submission.
• Sintaxe: Se desejar indicar o assunto: <input type=hidden name="subject" value="Your Subject" />
  Para permitir ao usuário que escolha o assunto: <input type=text name="subject" />

Campo: email

• Descrição: Este campo de formulário permitirá ao usuário especificar seu endereço de e-mail. Se desejar poder enviar respostas de e-mail ao usuário, é muito recomendável incluir este campo de formulário e permitir que ele o preencha. Este campo será indicado no campo From: da mensagem que você receber. Se desejar verificar a Sintaxe do endereço de email para obrigar que este seja válido, é necessário adicionar este nome de campo aos campos '\''required'\''.
• Sintaxe: <input type=text name="email" />

Campo: realname

• Descrição: O campo de formulário realname permitirá ao usuário introduzir seu nome real. Este campo é útil para propósitos de identificação e também será incluído na From: linha do cabeçalho da sua mensagem.
• Sintaxe: <input type=text name="realname" />

Campo: redirect

• Descrição: Se desejar redirecionar o usuário para uma URL diferente, em vez de deixá-lo ver a resposta padrão do formulário preenchido, você pode utilizar esta variável oculta para enviá-lo a uma página HTML previamente criada.
• Sintaxe: Para escolher o endereço URL para o qual serão redirecionados: <input type=hidden name="redirect" value="http://your.host.com/to/file.html" />
  Para permitir que ele especifique uma URL para acessar assim que o formulário estiver preenchido: <input type=text name="redirect" />

Campo: required

• Versão: 1.3 & superiores
• Descrição: Você pode exigir que certos campos do formulário sejam preenchidos antes que o usuário possa enviar o formulário com sucesso. Simplesmente você deve indicar dentro deste campo, todos aqueles campos que deseja que sejam obrigatórios. Se os campos obrigatórios não forem preenchidos, será notificado ao usuário que ele deve preenchê-los, e um link o levará de volta ao formulário que estava preenchendo. Para utilizar uma página de erro personalizada, veja missing_fields_redirect
• Sintaxe: Se desejar que os campos email e telefone sejam obrigatórios, de forma que você possa contatá-los quando receber o e-mail, use uma Sintaxe como: <input type=hidden name="required" value="email,phone" />

Campo: env_report

• Versão: 1.3 & superiores
• Descrição: Permite ter variáveis de Environment incluídas na mensagem de e-mail que você recebe após um usuário ter preenchido o formulário. É útil se você deseja saber qual navegador estão utilizando, de qual domínio acessaram ou qualquer outro atributo associado às variáveis de ambiente. A seguir está uma lista curta de variáveis de ambiente válidas e que podem ser úteis: - REMOTE_HOST Envia o hostname fazendo uma pergunta. - REMOTE_ADDR Envia o endereço IP do host remoto fazendo uma pergunta. - REMOTE_USER Se o servidor utiliza autenticação e o script está protegido, este é o username com que se identificaram. Normalmente não é mostrado. - HTTP_USER_AGENT O navegador que o cliente utiliza para enviar o formulário. e outros, mas estes são alguns dos mais úteis. Para mais informações sobre variáveis de ambiente, veja: Environment_Variables
• Sintaxe: Se quiser encontrar o remote host e o navegador que enviam o formulário, deve indicar o seguinte: <input type=hidden name="env_report" value="REMOTE_HOST, HTTP_USER_AGENT" />

Campo: sort

• Versão: 1.4 & superiores
• Descrição: Este campo permite escolher a ordem em que deseja que suas variáveis apareçam no e-mail gerado pelo FormMail. Pode obter os campos ordenados alfabeticamente ou estabelecer a ordem em que deseja que os campos apareçam em sua mensagem de e-mail. Deixando este campo vazio, a ordem será apenas a ordem em que por padrão os navegadores enviam a informação para o script (habitualmente é a mesma ordem em que aparecem no formulário.) Para estabelecer uma ordem dos campos, deve incluir a frase "order:" como a primeira parte do valor do campo escolhido, e então continuar com os nomes dos campos que deseja que sejam listados na mensagem de e-mail, separados por vírgulas. A versão 1.6 permite um pouco mais de flexibilidade ao listar os campos a serem ordenados, permitindo incluir espaços e quebras de linha no campo sem que estes interfiram na ordem. Isso é útil quando há muitos campos de formulário e é necessário inserir uma linha de separação.
• Sintaxe: Para ordenar alfabeticamente: <input type=hidden name="sort" value="alphabetic" /> Para ordenar por um conjunto de campos: <input type=hidden name="sort" value="order:name1,name2, name3,etc..." />

Campo: print_config

• Versão: 1.5 & superiores
• Descrição: print_config permite especificar as variáveis config que deseja que sejam impressas em sua mensagem de e-mail. Por padrão, nenhum campo config é impresso no e-mail. Isto é assim, já que os campos de formulário importantes, como email, subject, etc. são incluídos no cabeçalho da mensagem. De toda forma, alguns usuários pediram por esta opção, de maneira que podem ter esses campos impressos no corpo da mensagem. Os campos config que você pode ter impressos estarão no atributo value da tag de entrada, separados por vírgulas.
• Sintaxe: Se desejar imprimir os campos email e subject no corpo da mensagem, deve colocar a seguinte tag de formulário: <input type=hidden name="print_config" value="email,subject" />

Campo: print_blank_fields

• Versão: 1.6
• Descripción: print_blank_fields permite assegurar que todos os campos de formulário estejam impressos no HTML de retorno, a menos que não tenham sido preenchidos. Por padrão, o FormMail deixa essa propriedade off, de modo que os campos de formulário não usados não são enviados.
• Sintaxe: Se desejar imprimir todos os campos em branco: <input type=hidden name="print_blank_fields" value="1" />

Campo: title

• Versão: 1.3 & superiores
• Descrição: Este campo de formulário permite especificar o título e cabeçalho que aparecerá na página de resultado caso não especifique uma URL no campo redirect.
• Sintaxe: Se desejar um título de '\''Feedback Form Results'\'': <input type=hidden name="title" value="Feedback Form Results" />

Campo: return_link_url

• Versão: 1.3 & superiores
• Descrição: Este campo permite especificar uma URL que aparecerá, como return_link_title, na próxima página de relatório. Este campo não será utilizado se indicar o campo redirect, mas é útil se permite ao usuário receber o relatório na próxima página, e quer oferecer um caminho para voltar à página principal.
• Sintaxe: <input type=hidden name="return_link_url" value="http://your.host.com/main.html" />

Campo: return_link_title

• Versão: 1.3 & superiores
• Descrição: Este é o título que será utilizado para enviar de novo o usuário à página que especificar com return_link_url. Os dois campos serão mostrados na página de formulário resultante como: return_link_title
• Sintaxe: <input type=hidden name="return_link_title" value="Back to Main Page" />

Campo: missing_fields_redirect

• Versão: 1.6
• Descrição: Este campo de formulário permite especificar uma URL para a qual os usuários serão redirecionados se houver campos obrigatórios que não foram preenchidos. Assim você pode personalizar uma página de erro, em vez de mostrar a página padrão.
• Sintaxe: <input type=hidden name="missing_fields_redirect" value="http://your.host.com/error.html" />

Campo: background

• Versão: 1.3 & superiores
• Descrição: Este campo de formulário permite especificar uma imagem de fundo que aparecerá se não tiver o campo redirect. Esta imagem aparecerá como um fundo para a página de resultados do formulário.
• Sintaxe: <input type=hidden name="background" value="http://your.host.com/image.gif" />

Campo: bgcolor

• Versão: 1.3 & superiores
• Descrição: Este campo de formulário permite especificar um bgcolor para a página de resultados do formulário da mesma forma que especifica uma imagem de fundo. Este campo não funcionará se o campo redirect for indicado.
• Sintaxe: Para uma cor de fundo branca: <input type=hidden name="bgcolor" value="#FFFFFF" />

Campo: text_color

• Versão: 1.3 & superiores
• Descrição: Este campo funciona da mesma forma que bgcolor, e altera a cor do texto.
• Sintaxe: Para uma cor de texto preto: <input type=hidden name="text_color" value="#000000" />

Campo: link_color

• Versão: 1.3 & superiores
• Descrição: Altera a cor dos links na página de resultados. Funciona de maneira semelhante ao text_color. Não será utilizado se o campo redirect estiver definido.
• Sintaxe: Para uma cor de link vermelha: <input type=hidden name="link_color" value="#FF0000" />

Campo: vlink_color

• Versão: 1.3 & superiores
• Descrição: Altera a cor dos links visitados na página de resultados. Funciona de forma semelhante ao link_color. Não será utilizado se o campo redirect estiver definido.
• Sintaxe: Para um link visitado de cor azul: <input type=hidden name="vlink_color" value="#0000FF" />

Campo: alink_color

• Versão: 1.4 & superiores
• Descrição: Altera a cor dos links ativos na página de resultados. Funciona da mesma forma que o link_color. Não será utilizado se o campo redirect estiver definido.
• Sintaxe: Para um link ativo de cor azul: <input type=hidden name="alink_color" value="#0000FF" />

Qualquer outro campo de formulário que aparecer em seu script será enviado de volta e mostrado na página de resultados se não tiver o conjunto de campos redirecionado. Não há limite sobre outros campos de formulário que você pode utilizar com este formulário, salvo os limites impostos pelos navegadores e por seus próprios servidores.

Código de exemplo:

<html>
<head>
     <title>Formulário de exemplo</title>
</head>
<body>
<form action="/cgi-sys/form-mail.cgi" method="post">
     <p style="text-align: center;">
          Nome: <input name="nombre" size="20" /><br />
          Empresa: <input name="empresa" size="20" />
     </p>
     <input type="submit" value="Enviar" name="B1" />

     <input type="hidden" value="direccion@destino.com" name="recipient" />
     <input type="hidden" value="http://www.dominio.com/formok.htm" name="redirect" />
     <input type="hidden" value="Formulário enviado por WEB" name="subject" />
</form>
</body>
</html>