Central do Cliente Onda

Central do Cliente / Suporte Online / Configurações de Hospedagem / Formulários

Forms_Web.cgi é um programa que ajuda você a trabalhar com formulários em seu site. Você preenche o endereço de e-mail que irá receber os dados, quais os campos que não poderão ser enviados em branco, a página de retorno do formulário, a página de agradecimentos, entre outros.

form action

Você deve incluir na primeira linha de seu formulário o endereço do programa que irá gerenciar os seus dados. O código deve ser idêntico ao descrito abaixo:

<FORM ACTION="http://www.onda.com.br/cgi-bin/Formulario/Forms_Web.cgi" METHOD="POST">

email_target

É o endereço de e-mail que receberá os dados enviados pelo seu formulário. É essencial que você coloque esta linha em seu formulário, pois sem ela não será executado o programa e os dados não serão enviados. A linha de comando inserida em seu formulário deve ser idêntica à descrita abaixo:(lembre de informar o seu endereço de e-mail no campo VALUE)

<INPUT TYPE="hidden" NAME=".email_target" VALUE="noname@onda.com.br">

environment

O .environment é opcional. Ele mostra uma lista de variáveis ambiente quando os dados são enviados pelo browser do internauta. Esta linha de comando mostra entre outros, o tipo de browser que o internauta possui, o endereço remoto, etc. A linha de comando inserida em seu formulário, se você deseja receber esses dados, deve ser idêntica à descrita abaixo:

<INPUT TYPE="hidden" NAME=".environment" VALUE="1">

remove_indexing

Quando você tem uma série de dados a serem trabalhados, geralmente você pode preferir recebê-los ordenadamente. Por exemplo, você gostaria de receber o campo |Nome| antes do campo |Endereço|. O programa Forms_Web.cgi recebe todos os campos do formulário e os ordena alfabeticamente, então você receberia o campo |Endereço| antes do campo |Nome|. Para resolver este pequeno probleminha, você pode colocar antes do nome de cada campo uma sequência alfabética de 2 caracteres. Usando o exemplo acima, seria aaNome e abEndereço. Aí, então, os dados seriam recebidos conforme a ordem que você especificasse nestas duas primeiras letras. A linha de comando .remove_indexing, remove estas duas letras do seu campo, recebendo somente os campos Nome e Endereço, sem as letras. A linha de comando inserida em seu formulário deve ser idêntica à descrita abaixo:

<INPUT TYPE="hidden" NAME=".remove_indexing" VALUE="1">

mail_subject

A linha de comando .mail_subject é usada para alterar o conteúdo do campo |assunto| quando você recebe um e-mail. O valor padrão do programa Forms_Web.cgi é retornar a frase |Retorno de Formulário|. A linha de comando inserida em seu formulário deve ser idêntica à descrita abaixo:(lembrando de informar a frase que deseja ser recebida no campo assunto do seu e-mail.)

<INPUT TYPE="hidden" NAME=".mail_subject" VALUE="Frase de Assunto para o meu Formulário">

mail_intro

A linha de comando do .mail_intro é similar ao .mail_subject descrita acima, só que, ao invés de mudar o conteúdo do campo |assunto|, ela muda a |frase| que aparece na primeira linha do formulário quando você abre o e-mail. O valor padrão do programa Forms_Web.cgi é retornar a frase |Formulário enviado por:|. A linha de comando inserida em seu formulário deve ser idêntica à descrita abaixo:(lembrando de informar a |frase| que deseja ser recebida no topo, ao ler seu e-mail.)

<INPUT TYPE="hidden" NAME=".mail_intro" VALUE="Frase que aparecerá na primeira linha, ao abrir o e-mail">

required_data

A linha de comando do .required_data é utilizada quando você deseja que determinados campos não sejam enviados em branco. Por exemplo, você top quatro campos em seu formulário, aaNome, abEndereço, acEmail e adTelefone, e prefere que o campo Nome e o campo Email não sejam enviados em branco, então, deve-se colocar os campos separados por |::| (para forçar o preenchimento, basta incluir |::| após os campos que forme de preenchimento obrigatório) como na linha de comando abaixo:

<INPUT TYPE="hidden" NAME=".required_data" VALUE="aaNome::abEmail">

back_to_url

Após o internauta enviar o e-mail, o programa Forms_Web.cgi retorna uma página simples de agradecimento. Se você deseja inserir nesta página, um link de retorno para uma página sua, então, a linha de comando do .back_to_url é necessária, e deve ser inserida como descrito abaixo, não esquecendo de informar no campo VALUE o endereço absoluto de seu link:

<INPUT TYPE="hidden" NAME=".back_to_url" VALUE="http://www.meu_LINK_PARA_RETORNO.com.br">

thanks_url

Similar ao .back_to_url a linha de comando .thanks_url é utilizada quando você deseja retornar ao internauta, após o envio do e-mail, uma página criada por você e não somente um link na página criada pelo Forms_Web.cgi. A linha de comando inserida em seu formulário, se você deseja retornar uma página pré-definida, deve ser idêntica à descrita abaixo, não esquecendo de informar no campo VALUE o endereço absoluto de sua página:

<INPUT TYPE="hidden" NAME=".thanks_url" VALUE="http://www.minha_PAGINA_DE_RETORNO.com.br">

test

A linha de comando .test é opcional. Ela é utilizada para testar o seu formulário antes de colocá-lo em sua página. Você pode testar todas as linhas de comando mencionadas acima e verificar se o resultado está de acordo com o esperado (sem precisar ficar resgatando os e-mails de teste). Para isso, insira a linha de comando abaixo e o programa Forms_Web.cgi não irá enviar os dados para o e-mail informado na linha de comando .email_target, e sim, abrirá uma nova página para você, simulando o recebimento em seu correio eletrônico.

<INPUT TYPE="hidden" NAME=".test" VALUE="1">

© 2007 Onda - Você sempre à frente