[ CIP ~ Informações ~ Acesso Discado ~ WebCIP ~ Procurar ]
Copyright © 1996 para CentroIn Internet Provider. Todos os direitos reservados.
webmaster@centroin.com.br
<form action="/cgi-bin/fm" method=GET>
<input type=hidden name="recipient" value="<nome>@centroin.com.br">
Campo 1: <input type=text name="campo1">
Campo 2: <input type=text name="campo2">
...
<input type=submit value="Enviar">
<input type=reset value="Limpar">
</form>
Não esqueça, porém, de trocar (na segunda linha) o
"<nome>" pelo seu endereço no CIP (ou trocar o
"<nome>@centroin.com.br" por qualquer endereço de
e-mail para qual você quer que o resultado do
formulário seja enviado).
Seu uso possibilita a qualquer um, mesmo sem conhecimento de programação ou CGI, incluir formulários em suas páginas que, quando preenchidos, enviarão mensagens a qualquer endereço de e-mail na Internet.
De todos os campos, apenas um é obrigatório para que o FormMail funcione: o campo recipient.
<form action="<script>" method=GET>
...
</form>
O <script> deve ser substituído pelo
endereço onde o script CGI se encontra e method
pode ser GET ou POST (em maiúsculas!). No caso do
FormMail do WebCIP, action deve ser "/cgi-bin/fm". O
method pode ser GET ou POST.
Todas as informações contidas nos campos entre o <form>...</form> serão enviadas para o script especificado no atributo action. Assim, é possível definir vários formulários, via múltiplos <form>...</form>, numa mesma página HTML, cada um deles enviando seus dados para um script - ou um FormMail - diferente.
<input type=<tipo> name=<nome> value=<valor>>
Onde <tipo> é o tipo do campo propriamente dito,
<name> é seu nome e <value> seu valor.
Dos tipos existentes, alguns são de especial interesse aos usuários do FormMail, a saber:
Exemplo:
<input type=hidden name="recipient" value="webmaster@cip.com.br">
Este exemplo, se usado num formulário destinado ao FormMail, fará com que os resultados sejam enviados, via e-mail, para o endereço "webmaster@cip.com.br". Note que isto foi definido pelo criador da página; ao usuário não será dada a opção de mudar o destinatário e o valor do campo sequer será mostrado.
Assunto: <input type=text name="subject" size=40>
Idade: <input type=text name="idade" maxlength=2>
Aqui, será fornecida ao usuário a oportunidade de preencher os dois campos, nomeados "subject" e "idade". O campo "subject" aparecerá com espaço para visualização de 40 caracteres e o campo "idade" não permitirá a digitação de mais que 2 caracteres.
Area de interesse: <input type=text name="area"
value="Programacao de computadores">
Neste exemplo, o usuário estará digitando no campo "area". Como parte da inicialização do formulário, o campo receberá o valor "Programação de computadores".
Por quê?
Porque é a escolha deste campo que finaliza o preenchimento do formulário. Normalmente, os browsers (programas de visualização de páginas HTML, o programa que você está - deve estar - usando no momento) apresentam campos submit como um "botão pressionável". Pois a "pressão" deste "botão" indica que o formulário já está devidamente preenchido e deve ser enviado.
Exemplo:
<form action="/cgi-bin/fm" action=GET>
<input type=hidden name="recipient"
value="webmaster@cip.com.br">
<p>
Formulário de teste, enviado para webmaster@cip.com.br
<br><br>
Nome: <input type=text name="nome"><br>
Idade: <input type=text name="idade" size=2 maxlength=2><br>
Sexo: <input type=text name="sexo" value="f" size=1 maxlength=1><br>
<input type=submit value="Vai!">
Este exemplo, um fragmento completo de HTML pronto para funcionar com o FormMail, seria apresentado como:
Experimente!
Seguimos com os campos reconhecidos.
este campo que especifica o destinatário para a mensagem com os dados do formulário. Normalmente este campo é definido como um campo hidden mas pode ser permitido que o usuário o informe, o que, definitivamente, não é uma boa idéia.
Muito provavelmente você definirá este campo como hidden, tendo como valor seu endereço de e-mail.
Se você não especificar um campo subject, a mensagem será enviado com o subject "Resultado do formulário no WebCIP".
Se você definir este campo como hidden, todas as mensagens serão enviadas com o subject especificado. Se for um campo text, quem preencher o formulário poderá especificar o subject.
Adicionalmente, a mensagem que você receberá terá este endereço no campo "from:", facilitando uma possivel correspondência com quem preencheu o formulário.
Não há sentido em definir este campo com outro tipo a não ser text.
Não há sentido em definir este campo com outro tipo a não ser text.
Se você preferir, você pode informar ao FormMail que não envie o usuário para a página default, mas sim para a página que você especificar no campo redirect.
Atenção: o FormMail espera uma referência completa ao endereço a ser redirecionado. Além disso, só é possível especificar o redirecionamento para documentos obtidos via HTTP. Em outras palavras, é necessário especificar "http://" ("http://web.cip.com.br/" se o documento estiver no WebCIP, por exemplo) no endereço para onde o usuário será redirecionado.
Veja a página de exemplos.
Se o usuário não preencher todos os campos obrigatórios, o FormMail o notificará sobre o que ele precisa preencher e apresentará um link para página que contém o formulário incompleto.
Veja a página de exemplos.
As variáveis de ambiente devem estar separadas por "," (vírgula).
Definitivamente, variáveis de ambiente não acrescentam nada à funcionalidade do FormMail mas pode lhe dar dados importantes sobre quem preenche seus formulários.
De todas a váriaveis de ambiente - ou, se você não está entendendo nada, de todos os valores possíveis para o campo env_report - possíveis, as mais (senão únicas) úteis são:
Você pode especificar que o FormMail lhe envie os campos ordenados em ordem alfabética ou especificar, manualmente, a ordem desejada.
Se você não especificar este campo, a ordem em que os campos aparecerão na mensagem dependerá do browser utilizado pelo usuário e não será, necessáriamente, a mesma ordem em que os campos aparecem na sua página.
Para ordenar os campos alfabeticamente, use "alphabetic" como valor para este campo. Para escolher sua própria ordem, especifique os campos na ordem desejada, separados por "," (vírgula) e precedidos por "order:" (i.e. "order:campo1,campo2,campo3&qupt;).
Veja a página de exemplos.
Contudo, o campo print_config serve para que você especifique quais campos-chave quer que tenham seus valores listados na mensagem. Os campos devem estar separados por vírgulas.
Veja a página de exemplos.
Esta opção não tem sentido - e será ignorada - se você especificar o campo redirect.
Esta opção não tem sentido - e será ignorada - se você especificar o campo redirect.
Esta opção não tem sentido - e será ignorada - se você especificar o campo redirect.
Esta opção não tem sentido - e será ignorada - se você especificar o campo redirect.
webmaster@centroin.com.br