ARSAform

Você poderá criar formulários utilizando os comandos padrões da linguagem HTML; porêm, para que o mesmo seja processado, alguns comandos exclusivos do arsaform.cgi devem constar em seu código. Estes comandos são definidos em variáveis tipo hidden, e iniciam com o caracter "#". Algumas variáveis são obrigatórias e outras opcionais. Algumas das variáveis também podem conter comandos HTML; neste caso substitua as aspas duplas ( " ) pelo caracter de acento crase ( ` ); isto porquê as aspas são utilizadas para delimitar o valor do próprio campo.

<form method=post action="http://www.valehost.com.br/cgi-bin/arsaform/arsaform.cgi">

Configura as variáveis personalizadas que farão parte do formulário. Somente as variáveis aqui definidas serão reconhecidas pelo ARSAform. Cada variável deve estar em uma linha com o seguinte formato:

- Sempre separe as variáveis de configuração do campo com o caracter " | ".
- A primeira linha deve iniciar com aspas ( " ) logo abaixo de "value=".
- A última linha deve terminar com ">.

Note que a variável email é do tipo 2, e que os variáveis tel e obs, por não serem obrigatórios, não precisam conter a definição do tipo e o nome do campo.

Esta variável é obrigatória e define como sera a mensagem enviada por e-mail ao destinatário que receberá as informações do formulário.

Os valores dos campos do formulário são inseridos no texto da mensagem através de Tags especiais que referenciam o nome das variáveis do formulário, que foram definas em "#campos". Os Tags especiais são:

<=nome_da_variável> - insere o valor do campo exatamente como foi digitado;

<+nome_da_variável> - insere o valor do campo com todas as letras convertidas para maiúsculo;

<-nome_da_variável> - insere o valor do campo com todas as letras convertidas para minúsculo.

<=@nome_da_variável> - insere o valor do campo com as letras sem acentuação.

<+@nome_da_variável> - insere o valor do campo com as letras sem acentuação e convertidas para maúsculo.

<-nome_da_variável> - insere o valor do campo com as setras sem acentuação e convertidas para minúsculo.

O valor deste campo deverá sempre utilizar o seguinte padrão (o que aparece em azul não pode ser alterado):

"To: e-mail_do_destinatário
From: e-mail_do_remetente
Subject: assunto da mensagem
primeira linha da mensagem
demais linhas
última linha da mensagem">

<input type=hidden name="#msg_dst" value=
"To: <#dst>
From: <=email>
Subject: DADOS DO FORMULARIO

Data: <#dia>/<#mes>/<#ano>
Hora: <#hor>:<#min>:<#seg>

Nome: <=@nom>
E-mail: <-email>
Endereco: <=@end>
Cidade: <=@cid>
Estado: <+@est>
CEP: <+@cep>
Telefone: <+@tel>

Comentarios:
<=@obs>">

OBS: não esqueça de substituir as aspas ( " ) pelo caracter de acento crase ( ` ).

Define o endereço e-mail do destinatário que receberá os dados do formulário, para utilização através do tag especial <#dst>. Caso esta variável não seja definida, o tag <#dst> será vazio.

Esta variável permite ajustar a diferença de fuso-horário em relação ao horário do servidor onde está instalado o ARSAform. Seu valor deve ser um número inteiro entre -23 a +23. Caso esta variável não seja utilizada, seu valor default será 0 (zero). O valor desta variável afetará o valor dos tags especiais de data e hora.

Esta variável define o caracter ou texto para preenchimento dos campos vazios nas mensagens de e-mail e na página de confirmação.

Define a página que será carregada após o envio do formulário. O seu valor deve ser o URL completo da página de destino. Caso esta variável não seja utilizada, será carregada a página de confirmação default (arsaform.003).

Define o idioma para exibição dos tags especiais <#nmes> (nome do mês) e <#dsem> (dia da semana). Caso tenha valor igual a 1, o nome do mês e dia da semana aparecerão em Inglês. Caso a variável não seja utilizada ou tenha valor igual a 0 (zero), o idioma será o Português.

Define o código HTML da página de confirmação que poderá ser mostrada antes do envio do formulário. Junto ao código HTML poderão ser utilizados os mesmos tags especiais das variáveis "#msg_usr" e "#msg_dest", para inserir os valores dos campos do formulário. Obrigatoriamente também deverá ser inserido junto ao código HTML o tag especial <#formconf>, conforme exemplo abaixo:

<input type=hidden name="#pag_conf" value=
"<html>
<title>Confirmação</title>
<body bgcolor=`#FFFFFF`>
<center>
<h2>CONFIRMAÇÃO</h2>
<p>
Verifique se os dados digitados estão corretos<br>
e pressione o botão <b>`CONFIRMAR`</b> ou retorne<br>
à pagina anterior e corrija as informações.
<p>
<table border=0>
<tr><td>Nome:</td><td><=nom></td></tr>
<tr><td>E-mail:</td><td><-email></td></tr>
<tr><td>Endereço:</td><td><=end></td></tr>
<tr><td>Cidade:</td><td><=cid></td></tr>
<tr><td>Estado:</td><td><+est></td></tr>
<tr><td>CEP:</td><td><+cep></td></tr>
<tr><td>Telefone:</td><td><+tel></td></tr>
<tr><td valign=top>Comentários:</td><td><pre><=obs></pre></td></tr>
</table>

<p>
<#formconf>
<input type=submit value=`Confirmar`>
</form>
<p>
</center>
</body>
</html>">

OBS: não esqueça de substituir as aspas ( " ) pelo caracter de acento crase ( ` ).

Define o código HTML da página de erro personalizada. Os nomes dos campos vazios ou inválidos (definidos na variável "#campos") serão exibidos um abaixo do outro, no local onde houver o tag especial <#erros>, que é obrigatório. Caso esta variável não seja utilizada, será utilizada a página de erro default (arsaform.002).

<input type=hidden name="#pag_erro" value=
"<html>
<title>Erro no Formulário!</title>
<body bgcolor=`#FFFFFF`>
<center>
<h2>ERRO NO FORMULARIO!</h2>
<p>
Os seguintes campos estão vazios ou inválidos:
<p>
<table border=0><tr><td>
<#erros>
</td></tr></table>
<p>
Volte para a página anterior e corrija os erros.
</center>
</body>
</html>">

OBS: não esqueça de substituir as aspas ( " ) pelo caracter de acento crase ( ` ).

<html>
<title>ARSAform - Formulário Modelo</title>
<body bgcolor="#FFFFFF">

<h2>ARSAform - Formulário Modelo</h2>


<form method=post action="http://www.valehost.com.br/cgi-bin/arsaform/arsaform.cgi">

<input type=hidden name="#campos" value=
"nome|30|1|<li>Nome
email|30|2|<li>E-mail
texto|500|0|
opcao|7|1|<li>Opção
selecao1|11|0|
selecao2|11|0|
valor|7|1|<li>Valor">

<input type=hidden name="#dst" value="webmaster@seudominio.xxx">


<input type=hidden name="#fuso" value="-3">
<input type=hidden name="#nulo" value="-">
<input type=hidden name="#url_dest" value="http://www.seudominio.xxx/paginadestino.htm">
<input type=hidden name="#idioma" value="0">


<input type=hidden name="#pag_conf" value=
"<html>
<title>Confirmação</title>
<body bgcolor=`#FFFFFF`>
<center>
<h2>CONFIRMAÇÃO</h2>
<p>
Verifique se os dados digitados estão corretos<br>
e pressione o botão <b>`CONFIRMAR`</b> ou retorne<br>
à pagina anterior e corrija as informações.
<p>
<table border=0>
<tr><td>Seu nome:</td><td><=nome></td></tr>
<tr><td>Seu E-mail:</td><td><-email></td></tr>
<tr><td valign=top>Comentários:</td><td><pre><=texto></pre></td></tr>
<tr><td>Opção:</td><td><+opcao></td></tr>
<tr><td>Seleção 1:</td><td><=selecao1></td></tr>
<tr><td>Seleção 2:</td><td><=selecao2></td></tr>
<tr><td>Valor:</td><td><=valor></td></tr>
</table>

<p>
<#formconf>
<input type=submit value=`Confirmar`>
</form>
<p>
</center>
</body>
</html>">


<input type=hidden name="#pag_erro" value=
"<html>
<title>Erro no Formulário!</title>
<body bgcolor=`#FFFFFF`>
<center>
<h2>ERRO NO FORMULARIO!</h2>
<p>
Os seguintes campos estão vazios ou inválidos:
<p>
<table border=0><tr><td>
<#erros>
</td></tr></table>
<p>
Volte para a página anterior e corrija os erros.
</center>
</body>
</html>">


<input type=hidden name="#msg_dst" value=
"To: <#dst>
From: <=email>
Subject: DADOS DO FORMULARIO

Data: <#dia>/<#mes>/<#ano>
Hora: <#hor>:<#min>:<#seg>

Nome: <=@nome>
E-mail: <-@email>

Comentarios:
<=@texto>

Opcao: <+@opcao>

Selecao 1: <=@selecao1>
Selecao 2: <=@selecao2>

Valor: <=@valor>">


<pre>

Seu nome: <input type=text size=30 maxlength=30 name="nome">
Seu E-Mail: <input type=text size=30 maxlength=30 name="email">

Comentários:
<textarea rows=6 cols=25 name="texto">testando</textarea>

Opção:
<input type=radio name="opcao" value="opção 1">opção 1
<input type=radio name="opcao" value="opção 2">opção 2
<input type=radio name="opcao" value="opção 3">opção 3
<input type=radio name="opcao" value="opção 4">opção 4

Seleção:
<input type=checkbox name="selecao1" value="selecionado"> seleção 1
<input type=checkbox name="selecao2" value="selecionado"> seleção 2

Valor: <select name="valor" >
<option value="">Clique aqui
<option value="valor 1">valor 1
<option value="valor 2">valor 2
<option value="valor 3">valor 3
<option value="valor 4">valor 4
</select>

<input type=submit value="Enviar Formulário"> <input type=reset value="Limpar">
</pre>
</form>

</body>
</html>