#################################################
						#
Formulário HPo - Versão 2.0			#
Home Page Online				#
Autor: Alexandre Pina				#
Criado em 18 de abril de 2002			#
Email do autor: webmaster@hponline.pro.br	#
Site do autor: www.hponline.pro.br		#
						#
#########################################################
							#
Dedico este script à minha esposa e minhas filhas...	#
Meus grandes amores...					#
							#
#########################################################
							#
O arquivo formhpo.zip e composto de três arquivos:	#
1) formhpo.cgi (o script)				#
2) formhpo.txt (este documento)				#
3) formhpo.htm (um exemplo de página)			#
							#
#########################################################################
									#
Nota do Autor								#
									#
Minha intenção ao criar este script foi de dar uma ferramenta prática	#
para todos aqueles que utilizam formulários. Sei que as variáveis	#
abaixo ficaram numerosas, mas foi o único jeito para fazer deste	#
script um instrumento universal, onde todos possam usar e adaptar as	#
suas necessidades.							#
									#
Você verá que praticamente toda a configuração do formulário fica na	#
página .html, e assim você podera configurar praticamente tudo pelo	#
formulário, só restando três variáveis no script			#
									#
#########################################################################
									#
Histórico do Script:							#
									#
01) Versão 1.0 - Em 18 de abril de 2002 criado o Script			#
02) Versão 1.1 - Em 20 de abril de 2002 foi inserida uma página	de	#
    confirmação								#
03) Versão 1.2 - Em 22 de abril de 2002 foram inseridas novas		#
    configurações de variáveis						#
04) Versão 1.3 - Em 23 de abril de 2002 inserida a função para checar	#
    se o domínio tem permissão para usar o Script			#
05) Versão 1.5 - Em 25 de abril de 2002 inserida a função para	checar	#
    campos requeridos							#
06) Versão 2.0 - Em 30 de abril de 2002 inserida função para checar 	#
    campos necessários ao funcionamento do script			#
									#
#########################################################################
									#
  Atribuições e funções deste script					#
									#
- Possibilitar total configuração em funções e layout;			#
- Verificar se o domínio tem permissão para usar o form;		#
- Gerar página de Não Autorizado para uso indevido;			#
- Verificar os campos do formulário (Requeridos);			#
- Gerar página de erro para a falta de informação;			#
- Verificar pela falta de campos necessários para o script;		#
- Gerar página de erro para avisar da falta desse campo;		#
- Processar as informações do formulário;				#
- Gerar página de confirmação das informações;				#
- Enviar por Email as informações;					#
- Enviar Email de confirmação para o visitante;				#
- Gerar página de agradecimento;					#
- Opção de retorno em todas as páginas					#
									#
#########################################################################
						#
Configurações na página do formulário...	#
						#
#################################################################################
										#
As primeiras linhas do formulário ficariam assim:				#
										#
<form method="POST" action="formhpo.cgi">					#
<input type="hidden" name="ordem" value="Nome,Email,Telefone,Comentarios">	#
<input type="hidden" name="requerido" value="Nome,Email">			#
<input type="hidden" name="nomesite" value="Nome do seu site">			#
<input type="hidden" name="emailsite" value="seu@email.com.br">			#
<input type="hidden" name="resposta" value="0">					#
<input type="hidden" name="retorno" value="url/da/pagina.htm">			#
<input type="hidden" name="webnome" value="Seu nome">				#
<input type="hidden" name="assunto" value="Contato pelo site">			#
<input type="hidden" name="bgcolor" value="FFFFFF">				#
<input type="hidden" name="text" value="000000">				#
<input type="hidden" name="fontface" value="Verdana,Arial">			#
<input type="hidden" name="size" value="2">					#
<input type="hidden" name="link" value="000000">				#
<input type="hidden" name="alink" value="000000">				#
<input type="hidden" name="vlink" value="000000">				#
<input type="hidden" name="border" value="2">					#
<input type="hidden" name="bordercolor" value="000000">				#
										#
obs: Não esqueça de fechar o form - </form>					#
Veja o exemplo de página em formhpo.htm (em anexo)				#
										#
Para ajudá-lo na configuração das cores, visite:				#
http://www.hponline.pro.br/scripts/cores.htm					#
										#
#################################################################################
					#
Agora vamos para o passo a passo ...	#
					#
#########################################

    Onde encontrar a observação '(Campo necessário)' significa que a informação
    é necessária para o script funcionar, por isso, são obrigatórios.

01- Na primeira linha (Campo necessário)
    Definir o método e a ação
    Exemplo: <form method="Post" action="formhpo.cgi">

02- No segunda linha: (Campo necessário)
    Você define a ordem em que os campos vão aparecer:
    Neste ítem, você deve colocar todos os nomes dos campos que compõe o seu
    formulário, caso contrário, eles não irão aparecer.
    Exemplo: <input type="hidden" name="ordem" value="Nome,Email,Telefone">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="ordem", coloque exatamente assim, isso vai informar ao script
       quais os campos fazem parte do seu formulário
    c) Em value="Nome dos campos separados por vírgulas", e isso vai definir
       a ordem em que as informações serão mostradas

03- Na terceira linha:
    Você define quais os campos são de preenchimento obrigatório
    Neste ítem, você coloca apenas os nomes dos campos que deseja que sejam
    preenchidos obrigatoriamente.
    Exemplo: <input type="hidden" name"requerido" value="Nome,Email">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="requerido", coloque exatamente assim, isso vai informar ao
       script que há campos obrigatórios no seu formulário
    c) Em value="Nome dos campos separados por vírgulas", e isso vai definir
       quais são os campos obrigatórios

04- Na quarta linha:
    Você define o nome do site
    Exemplo: <input type="hidden" name"nomesite" value="Nome do seu site">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="nomesite", coloque exatamente assim
    c) Em value="Nome do seu site"

05- Na quinta linha: (Campo necessário)
    Você define o Email de onde deseja receber as informações
    Exemplo: <input type="hidden" name"emailsite" value="seu@email.com.br">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="emailsite", coloque exatamente assim
    c) Em value="seu@email.com.br"

06- Na sexta linha:
    Você define o seu nome
    Exemplo: <input type="hidden" name"seunome" value="Seu Nome">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="seunome", coloque exatamente assim
    c) Em value="Seu Nome"

07- Na sétima linha:
    Você define o assunto do Email
    Exemplo: <input type="hidden" name"assunto" value="Assunto do Email (subject)">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="assunto", coloque exatamente assim
    c) Em value="Assunto do Email" (subject)

08- Na oitava linha:
    Você define se usará a resposta automática, ou seja, se o visitante receberá
    um email confirmando que sua mensagem foi enviada.
    Exemplo: <input type="hidden" name="resposta" value="0">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="resposta", coloque exatamente assim
    c) Em value="0" sendo 1 = Sim e 0 = Não

09- Na nona linha:
    Você define a url da página de retorno, sugiro o uso da página do form,
    pois nas páginas de erro geradas pelo script, será esta usada para retorno.
    Exemplo: <input type="hidden" name="retorno" value="url/da/pagina.htm">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="retorno", coloque exatamente assim
    c) Em value="url/da/pagina.htm"

10- Na décima linha:
    Você define o bgcolor, ou seja, a cor de fundo das páginas geradas pelo script
    Exemplo: <input type="hidden" name="bgcolor" value="FFFFFF">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="bgcolor", coloque exatamente assim
    c) Em value="FFFFFF" - Consulte a página de cores para ajuda, em:
    http://www.hponline.pro.br/scripts/cores.htm

11- Na décima primeira linha:
    Você define o text, ou seja, a cor do texto das páginas geradas pelo script
    Exemplo: <input type="hidden" name="text" value="000000">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="text", coloque exatamente assim
    c) Em value="000000" - Consulte a página de cores para ajuda, em:
    http://www.hponline.pro.br/scripts/cores.htm

12- Na décima segunda linha:
    Você define o tipo de font para os textos
    Exemplo: <input type="hidden" name="fontface" value="Verdana,Arial">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="fontface", coloque exatamente assim
    c) Em value="Verdana,Arial" (subject)

13- Na décima terceira linha:
    Você define o tamanho da font
    Exemplo: <input type="hidden" name="size" value="2">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="size", coloque exatamente assim
    c) Em value="2" (subject)

14- Na décima quarta linha:
    Você define a cor do link nas páginas geradas pelo script
    Exemplo: <input type="hidden" name="link" value="000000">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="link", coloque exatamente assim
    c) Em value="000000" - Consulte a página de cores para ajuda, em:
    http://www.hponline.pro.br/scripts/cores.htm

15- Na décima quinta linha:
    Você define a cor do link visitado nas páginas geradas pelo script
    Exemplo: <input type="hidden" name="alink" value="000000">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="alink", coloque exatamente assim
    c) Em value="000000" - Consulte a página de cores para ajuda, em:
    http://www.hponline.pro.br/scripts/cores.htm

16- Na décima sexta linha:
    Você define a cor do link clicado nas páginas geradas pelo script
    Exemplo: <input type="hidden" name="vlink" value="000000">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="vlink", coloque exatamente assim
    c) Em value="000000" - Consulte a página de cores para ajuda, em:
    http://www.hponline.pro.br/scripts/cores.htm

17- Na décima sétima linha:
    Você define o tamanho da borda da tabela, todas as página geradas pelo script
    estão dentro de uma tabela.
    Exemplo: <input type="hidden" name"border" value="1">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="border", coloque exatamente assim
    c) Em value="1" - Obs: Se não quer borde, colocar '0'

18- Na décima oitava linha:
    Você define a cor da borda da tabela
    Exemplo: <input type="hidden" name"bordercolor" value="000000">
    a) Não esqueça de colocar o type="hidden", senão os campos vão aparecer
    b) Em name="bordercolor", coloque exatamente assim
    c) Em value="000000" - Consulte a página de cores para ajuda, em:
    http://www.hponline.pro.br/scripts/cores.htm

#################################
				#
Fim do passo a passo...		#
				#
#################################

Uma observação muito importante:

No restante do formulário você define os campos que desejar, mas não coloque
nenhum campo com os seguintes nomes (name):
- ordem
- requerido
- nomesite
- emailsite
- seunome
- assunto
- resposta
- retorno
- bgcolor
- text
- fontface
- size
- link
- alink
- vlink
- border
- bordercolor

Exemplos: name="ordem" ou name="requerido" ou name="nomesite" ...

Lembre-se, esses nomes irão configurar o script, tanto nas suas informações
quanto no layout das páginas geradas pelo script

Obs: No nome dos campos você pode até usar acentuação, mas não use palavras
separadas por espaços. Se for usar palavras separadas, coloque um traço
inferior para separá-las.
Exemplo: Para 'Nome e Sobrenome' use 'Nome_e_Sobrenome'

Essas informações também podem ser acessadas no help online em:
http://www.hponline.pro.br/scripts/formhelp.htm

#################################################
						#
Mais um aviso Muito Importante e necessário:	#
						#
#########################################################################
									#
Certamente no seu formulário haverá um campo destinado ao email do	#
visitante, pois é essencial para manter o contato			#
									#
Neste campo você deve colocar o nome do campo como "Email"		#
Exemplo: <input type="text" size="XX" name="Email">			#
Lembre-se: 'Email' é diferente de 'email'				#
									#
É importante que o nome deste campo seja 'Email' - pois			#
assim o script saberá qual é o Email do visitante e poderá enviar	#
uma mensagem de confirmação						#
									#
Sugiro, naturalmente, que este campo conste entre os campos requeridos	#
									#
#########################################################################
						#
Configurando as variáveis no formhpo (script):	#
						#
#################################################

No script você encontra apenas três ítens para verificar e modificar

1- Certifique-se da localização do Perl (1ª linha do script)
   #!/usr/bin/perl
   Em caso de dúvida entre em contato com o Administrador do Servidor

2- $sendmail = '/usr/sbin/sendmail';
   Localização do programa de Email no Servidor
   Em caso de dúvida entre em contato com o Administrador do Servidor

3- @dominios = ("www.seusite.com.br","seusite.com.br");
   Informar o(s) domínio(s) que podem usar este script, isso é para
   evitar que outros sites usem o seu script sem a sua autorização.

#########################
			#
Fim das variáveis	#
			#
#########################################################
							#
E finalmente ...					#
							#
#########################################################
							#
Enviar os arquivos no modo ASCII			#
Após o upload não esqueça de dar permissão 755(chmod)	#
para o script, também funciona com chmod 711.		#
							#
#########################################################
					#
Críticas, sugestões e/ou elogios	#
Escreva para mim...			#
alexandre@hponline.pro.br		#
					#
Muito obrigado por usar este script	#
Alexandre Pina				#
www.hponline.pro.br			#
					#
Fim do Documento			#
					#
#########################################