Características do formmail
O formmail permite que você receba os dados de formulários
de páginas de seu site sem ter que realizar nenhuma programação
em CGI.
Para usar o formmail, carregue o arquivo formmail.pl para o diretório
cgi-bin dentro do seu site no diretório ( www ou public_html).
Para
baixar uma cópia do formmail.pl clique aqui.
Não mude o nome do arquivo, mantenha-o exatamente "formmail.pl".
Importante:
Lembre-se de fazer a transferência do script pelo modo ASCII/texto.
Se o arquivo for transmitido em modo binário, você
vai receber um erro 500 Internal server error do servidor web
ao enviar seu formulário. Nesse caso refaça a transmissão
em modo ASCII/texto. Outra causa comum desse erro é não
ter configurado as permissões de acesso com código
755. Veja detalhes a seguir.
Use o seu programa FTP para alterar as características
de permissão de acesso ao arquivo formmail.pl em seu diretório
cgi-bin para 755. Consulte a documentação de seu
programa FTP para saber como alterar as permissões de arquivos
de sua conta.
O seu arquivo formmail.pl está pronto para ser chamado
através de sua página HTML. Crie um formulário
usando qualquer ferramenta de criação de páginas
web (ex.: Hot Dog, Homesite, FrontPage, etc.). Um exemplo mínimo
de código HTML que chama o formmail é o seguinte:
<form method="post" action="/cgi-bin/formmail.pl">
<input type="hidden" name="recipient" value="seu.email@algum.domínio">
Escreva seu nome: <input type="text" name="nome">
<input type="submit" value="Enviar">
</form>
Você altera o comportamento do formmail ao usar campos
"hidden" no seu formulário. Existe um campo de
formulário que é obrigatório para que o formmail
funcione perfeitamente. É o campo "recipient".
Campo recipient (destinatário):
Esse campo permite que você especifique para que endereço
você deseja que os dados do formulário sejam enviados.
Geralmente você vai querer configurar esta opção
como um campo hidden que vai ter como valor o seu endereço
de e-mail.
Sintaxe:
<input type=hidden name="recipient"
value="nome@seuprovedor.com">
Campos opcionais
Campo subject (assunto):
O campo subject vai permitir que você especifique o assunto
do e-mail que lhe será enviado após o formulário
ser preenchido. Se você não tiver essa opção
configurada, o script irá enviar o e-mail com o título
padrão: WWW Form Submission.
Sintaxe:
Se você deseja escolher o assunto a ser enviado:
<input type=hidden name="subject"
value="seu assunto">
Se você deseja que o usuário defina o assunto:
<input type=text name="subject">
Campo email:
Este campo permite ao usuário especificar qual é
seu e-mail de retorno. Se você quiser retornar um e-mail
para o usuário, é recomendável que você
inclua esse campo no formulário e permita que o usuário
o preencha. O e-mail do usuário vai aparecer no "De:"
ou "From:" no seu programa de e-mail.
Sintaxe:
<input type=text name="email">
Campo realname (nome verdadeiro):
O campo realname possibilita o usuário entrar com o seu
próprio nome. Este campo é útil para a identificação
do usuário que enviou os dados do formulário. Este
dado também irá ser visível no "De:"
ou "From:" no seu programa de email.
Sintaxe:
<input type=text name="realname">
Campo sort (ordenação):
Este campo permite que você escolha a ordem em que as suas
variáveis vão aparecer no e-mail que o formmail
vai gerar. Você pode escolher ter os campos ordenados alfabeticamente
ou especificar uma série de campos que ditam como as variáveis
vão ser ordenadas no seu e-mail. Se você não
usar este campo, o formmail vai ordenar de acordo com a chegada
de informações que o browser enviou ao script, e
nem sempre isso significa a mesma ordem em que aparecem no formulário.
Se quiser você estabelecer a ordem dos campos, você
deve incluir o comando "order:" como a primeira coisa
da lista e depois segui-lo dos nomes das variáveis na ordem
em que você deseja que sejam apresentadas na sua mensagem
de e-mail, separados por vírgulas (veja exemplo):
Sintaxe:
Para ordenar alfabeticamente:
<input type=hidden name="sort"
value="alphabetic">
Para ordenar de acordo com uma série de variáveis:
<input type=hidden name="sort"
value="order:var1,var2,var3,etc.">"
Campo redirect (redirecionar):
Este comando se presta a redirecionar o usuário para uma
URL após feito o envio dos dados do formulário,
ao invés de lhe mostrar a resposta padrão.
Sintaxe:
Para escolher a URL à qual o usuário será
enviado:
<input type=hidden name="redirect"
value="http://seunome.com/obrigado.htm">
Para permitir que o usuário escolha a URL a que irá
após enviar o formulario:
<input type=text name="redirect">
Campo required (obrigatório):
Você pode agora exigir que certos campos do seu formulário
sejam preenchidos antes que o usuário possa enviar o formulário
com sucesso. Simplesmente liste neste campo todas as variáveis
que você quer que sejam obrigatórias. O usuário
será notificado a respeito das variáveis que ele
deixou de preencher e um link de retorno ao formulário
lhe será apresentado.
Sintaxe:
Se você deseja que o nome, telefone e e-mail sejam obrigatoriamente
preenchidos no seu formulário (por exemplo, para que você
possa entrar em contato com o usuário), use a seguinte
sintaxe:
<input type=hidden name="required"
value="email,telefone,nome">
Campo env_report (variáveis de ambiente):
Permite que você obtenha em seu e-mail o valor de variáveis
de ambiente de execução CGI. Muito útil se
você deseja que browser foi utilizado, de qual domínio
se acessou e outras variáveis de ambiente CGI. A seguir
uma pequena lista variáveis que podem ser úteis:
• REMOTE_HOST: nome do host que enviou a solicitação.
• REMOTE_ADDR: endereço IP do host remoto que fez
a solicitação.
• HTTP_USER_AGENT: o browser que o cliente está usando
para enviar a solicitação. Formato geral: software/versãodabiblioteca/versão.
Sintaxe:
Se você deseja descobrir qual o nome do host e o browser
pelos quais se fez o pedido, configure da seguinte forma:
<input type=hidden name="env_report"
value="REMOTE_HOST,HTTP_USER_AGENT">
Campo title (título):
Esse campo especifica o título e o cabeçalho da
página que aparece quando você não especifica
uma página para redirecionar (campo redirect).
Sintaxe:
se você quiser o título "Resultado do formulário
de pesquisa":
<input type=hidden name="title"
value="Resultado do formulário de pesquisa">
Campo return_link_url (URL do link de retorno)
Escreva a URL do link que parece no final da página de
resposta do envio do formulário. Pode ser, por exemplo,
a página principal de seu site.
Sintaxe:
<input type=hidden name="return_link_url"
value="http://seu.domínio/">
Campo return_link_title (texto do link de retorno):
Esse é o nome do link de retorno da página de confirmação
do envio do formulário. O campo return_link_url define
a URL do link.
Sintaxe:
<input type=hidden name="return_link_title"
value="Retornar à página principal">
Campo background (figura de fundo):
Aqui você diz qual o arquivo de figura de fundo da página
de resultado que aparece após o envio do formulário.
Só é preciso preencher este campo se você
não pediu para redirecionar (campo redirect).
Sintaxe:
<input type=hidden name="background"
value="http://seu.domínio/figuras/fundo.gif">
Campo bgcolor (cor de fundo):
É a cor do fundo da página de confirmação
de envio do formulário. Não use esse campo se você
pediu para redirecionar.
Sintaxe:
para fundo branco:
<input type=hidden name="bgcolor"
value="#FFFFFF">
Campo text_color (cor do texto):
Funciona como o bgcolor, com a diferença de que vai mudar
a cor do texto da página.
Sintaxe:
para cor do texto preta:
<input type=hidden name="text_color"
value="#000000">
Campo link_color (cor do link):
Muda a cor dos links da página de confirmação
do envio do formulário. Não é necessário
especificar se você pediu para redirecionar.
Sintaxe:
para link vermelho:
<input type=hidden name="link_color"
value="#FF0000">
Campo vlink_color (cor de link visitado):
Cor dos links já visitados da página de confirmação
de envio. Não preencha se você pediu para redirecionar.
Sintaxe:
para cor de link visitado azul:
<input type=hidden name="vlink_color"
value="#0000FF">
Campo alink_color (cor de link ativo):
Cor de link ativo (que está sendo clicado) da página
de confirmação de envio.
Sintaxe:
para cor de link ativo amarela:
<input type=hidden name="alink_color"
value="#00FFFF">
