quarta-feira, fevereiro 11, 2009

Formmail

Posintãum, fui a cata de informações para configurar um formmail do meu último trabalho; hehe, é to colocando um site no ar, em breve posto aqui o endereço do mesmo; e achei um tutorial muito interessante com todas as boas dicas de formmail, para configurar tudo;

retirei o conteúdo do site:
http://www.hospedarsite.com.br/forum/viewtopic.php?t=35

normalmente os hospedeiros de site fornecem algumas informações sobre a configuração, mas nem sempre eles são especialistas e lhe dão todas as dicas, as vezes tens que cavocar em Google. :P



************** segue o texto original ***********

Formmail é um poderoso processador de formulário, que coleciona
as informações preenchidas num formulário numa página
do seu site e envia para um determinado lugar, normalmente é seu endereço
de e-mail, para receber as informações. Você pode usa-lo
para processar seus formulários sem tem conhecimento de programação.


Para usar o FormMail, precisa seguir as sintaxes e respeitar os nomes dos campos,
ou melhor, deveria configurar seu formulário do jeito que ele precisa.
A seguir são as informações e exemplos para a configuração.


a) Tag [b]form[/b]:


<FORM METHOD = “POST” ACTION = “linkParaFormMail">


O método tem que ser “POST” ou “GET”


Obs. Envie um email para solicitar o link do FormMail para sua conta de hospedagem.


b) Campo [b]recipient[/b]


De fato este é o único campo obrigatório, indicando para
onde vai enviar as informações, normalmente é seu endereço
de e-mail...


Exemplo:


<input type=hidden name="recipient" value=" seuemail@seudominio.com.br
">


vai enviar as informações do formulário para endereço
de e-mail: seuemail@seudominio.com.br


c) Campo [b]subject[/b]


Este é opcional, indicando o assunto das mensagens...


Exemplo:


<input type=hidden name="subject" value="Contato pelo site">


Se quiser seu cliente digitasse o assunto:


<input type=text name="subject">


d) Campo [b]email[/b]


Este permite que o visitante informe o endereço de e-mail de retorno.
Se você quiser responder as mensagens recebidas, será fortemente
recomendado incluir este campo no seu formulário. Ele aparece no lugar
de “DE: ” no e-mail recebido. Se você quiser o campo é
obrigado para ser preenchido, somente adiciona-lo nos campos requisitos.


Exemplo: <input type=text name="email">


e) Campo [b]realname[/b]


Este permite visitante entrar seu nome real, é útil para identificação
e aparecerá na linha de “DE: ” do e-mail recebido.


Exemplo: <input type=text name="realname">


f) Campo [b]redirect[/b]


Se quiser redirecionando os visitantes para outra página pessoalizada,
sem usar a página padrão depois que enviaram o formulário
preenchido, pode usar este para indicar a página.


Emeplo: <input type=hidden name="redirect" value="http://your.host.com/to/file.html">


g) Campo [b]required[/b]


Agora você pode definir os campos obrigatórios a ser preenchido
antes de enviar o formulário com sucesso, simplesmente colocar os nomes
dos campos aqui. Se os visitantes não preenchesse os campos obrigatórios,
receberam os avisos para preencher os campos obrigatórios.


Exemplo:


<input type=hidden name="required" value="email,phone">


h) Campo [b]env_report[/b]


Este campo permite que você inclue as informações de ambiente
dos visitantes junto ao e-mail recebido.


A seguir são uns exemplo de informações de ambiente dos
visitantes:


REMOTE_HOST – nome do servidor do visitante.

REMOTE_ADDR – endereço IP do visitante.

REMOTE_USER – se o servidor suportasse a autenticação e codigo
protegido, este será o nome de usuario autenticado. (Este ainda não
é comum que os servidores suportam disso).

HTTP_USER_AGENT – Navegador do visitante.


Existem outros, maiores informações:

http://cgi.resourceindex.com/Documentation/Environment_Variables/


Syntax: :

<input type=hidden name="env_report" value="REMOTE_HOST,HTTP_USER_AGENT">


i) Campo [b]sort[/b]


Este permite você definir a ordem in que os campos aparecem no e-mail.
A ordem pode ser em alfabética, ou ordem personalizado (neste caso, incluindo
os nomes dos campos depois da palavra chave: “ORDEM”).


Se não tiver este campo, a ordem de aparecimento no e-mail será
a ordem in formulário.


Exemplo:

Para ordenar os campos em alfabética:

<input type=hidden name="sort" value="alphabetic">


Para ordenar os campos em ordem personalizada:

<input type=hidden name="sort" value="order:campo1, campo2,etc...">


j) Campo [b]print_config[/b]


Este permite que você especifique quais variáveis de configuração
do e-mail serão incluindo na massagem de e-mail.


Pelo padrão, os variáveis de configuração do e-mail,
tais como “email”, “subject”, etc., são incluído
nas linhas de “DE:”, “ASSUNTO”, etc., não serão
incluídos na mensagem do e-mail.


Exemplo:


Para incluir endereço de e-mail do visitante e assunto no corpo do e-mail:


<input type=hidden name="print_config" value="email,subject">


k) Campo [b]print_blank_fields[/b]


Permite que todo os campos do formulário serão incluídos
no e-mail, mesmo estão em branco. Pelo padrão, os campos não
foram preenchidos (em branco) não serão enviados no e-mail.


Exemplo: Para enviar junto os campos do formulário em branco:

<input type=hidden name="print_blank_fields" value="1">


l) Campo [b]title[/b]


Este permite você define o título e cabeçalho da página
de resultado padrão (caso não redirecionou para uma página
pessoalizada).


Exemplo:


<input type=hidden name="title" value="Informações
enviadas">


m) Campo [b]return_link_url[/b]


Este permite você especifica um endereço de página para
retorno (caso não redirecionou para páginas personalizada).


Exemplo:


<input type=hidden name="return_link_url" value="http://www.hospedarsite.com.br/">


n) Campos [b]return_link_title[/b]


Este é a descrição que será usado para o link de
retorno que está especificado no campo “return_link_url”.


Exemplo:


<input type=hidden name="return_link_title" value="Voltar
para página principal">


o) Campo [b]missing_fields_redirect[/b]


Este permite você redireciona os visitantes para uma página de
erro personalizada quando alguns campos obrigatórios não foram
preenchidos.


Exemplo:


<input type=hidden name="missing_fields_redirect" value="http://seudominio.com.br/error.html">


p) Campo [b]background[/b]


Este permite você coloca uma imagem no fundo da página padrão
de resultados.


Exemplo:


<input type=hidden name="background" value="http://seudominio.com.br/seuimagem.gif">


q) Campo [b]bgcolor[/b]


Este permite você especifica uma cor no fundo da página padrão
de resultados.


Exemplo:


<input type=hidden name="bgcolor" value="#FFFFFF">


r) Campo [b]text_color[/b]


Este permite você especifica uma cor para os textos da página
padrão de resultados.


Exemplo:


<input type=hidden name="text_color" value="#000000">


s) Campo [b]link_color[/b]


Este permite você muda a cor para o link da página padrão
de resultados.


Exemplo:


<input type=hidden name="link_color" value="#FF0000">


t) Campo [b]vlink_color[/b]


Este permite você muda a cor para o link visitado da página padrão
de resultados.


Exemplo:


<input type=hidden name="vlink_color" value="#FF0000">


u) Campo [b]alink_color[/b]


Este permite você muda a cor para o link ativo da página padrão
de resultados.


Exemplo:


<input type=hidden name="alink_color" value="#FF0000">

Nenhum comentário: