Existe apenas dois campos que devem, obrigatoriamente, serem preenchidos para que o seu formulário FormMail-clone.cgi (mecanismo auditado e utilizado pela PlaneStone para processamento de formulário on-line) funcione corretamente. Estes campos são:
1) o campo Form:
<form method="POST" action="http://www.dominio.com.br/cgi-sys/FormMail-clone.cgi"
2) o campo Recipient:
Descrição: Este campo permite-lhe especificar para quem deseja que os resultados do seu formulário sejam enviados por e-mail. Provavelmente vai desejar configurar este campo como "hidden" (campo não visível) com um valor igual ao seu endereço de e-mail.
Sintaxe:
<input type="hidden" name="recipient" value="email@dominio.com.br">
Exemplo: Veja este examplo de código HTML -
<FORM METHOD=POST ACTION="http://www.seudominio.com.br/cgi-sys/FormMail-clone.cgi">
<input type=hidden name="recipient" value="seu_email@dominio.com">
<input type=hidden name="subject" value="Mensagem via website">
<input type=hidden name="return_link_url" value="http://www.seudominio.com">
<input type=hidden name="return_link_title" value="Voltar">
O arquivo FormMail-clone.cgi é hospedado em um diretório na raiz de nosso servidor, assim sendo você não conseguirá vê-lo em sua conta de hospedagem, apenas conseguirá utilizá-lo. Para total segurança de todos os clientes, a PlaneStone NÃO PERMITI A INSTALAÇÃO DE ARQUIVOS FORMMAIL SEM PRÉVIA AUTORIZAÇÃO.
--------------------------------------------------------------------------------
CAMPOS OPCIONAIS DO FORMULÁRIO:
Campo: subject
Descrição: O campo "subject" permite-lhe especificar o assunto que vai aparecer na mensagem que vai ser enviada para o "recipient" após o formulário ter sido submetido na web. Se não tiver esta campo definido no seu formulário, o assunto que irá aparecer por padrão é: WWW Form Submission.
Sintaxe: Se desejar escolher um assunto para a sua mensagem:
<input type="hidden" name="subject" value="Assunto desta mensagem...">
Para permitir que o utilizador escolha o assunto da mensagem:
<input type="text" name="subject">
Campo: email
Descrição: Este campo do formulário permite-lhe especificar o e-mail de retorno dos dados do seu formulário, ou seja, o e-mail da pessoa que submeteu o formulário online. Se deseja responder à pessoa que lhe enviou os dados deste formulário, deverá especificar este campo e permitir que o utilizador o preencha. Se desejar tornar este campo obrigatório deverá colocar este campo no campo "required".
Sintaxe: <input type="text" name="email">
Campo: realname
Descrição: O campo "realname" permite que o utilizador especifique o nome. Este campo é útil para uma melhor identificação de quem lhe envia a mensagem.
Sintaxe: <input type="text" name="realname">
Campo: redirect
Descrição: Se desejar redireccionar um utilizador para uma página diferente em vez da página exibida por defeito pelo script, por exemplo uma página de agradecimento por preencher o formulário, deverá utilizar este campo..
Sintaxe: Escolha do URL para onde o formulário será redireccionado:
<input type="hidden" name="redirect" value="http://www.dominio.com.br/obrigado.html">
Campo: required
Descrição: Pode utilizar este campo de forma a definir certos campos como de preenchimento obrigatório, antes de o utilizador poder submeter o formulário com sucesso. Ponha simplesmente todos os nomes dos campos obrigatórios neste campo. Se os campos requeridos não tiverem sido preenchidos, o utilizador será notificado que deverá preencher esses mesmos campos e um campo de volta ao formulário será exibido.
Para costumizar uma página de erro, veja 'missing_fields_redirect'
Sintaxe: Se desejar que os utilizadores preencham obrigatoriamente email, telefone e fax, use a seguinte sintaxe:
<input type="hidden" name="required" value="email,telefone,fax">
Campo: env_report
Descrição: Permite ter variáveis de sistema incluídas no e-mail que recebe.
Útil para se desejar saber que brower o utilizador está a utilizar, o IP ou domínio de origem, etc. Segue uma lista de variáveis válidas que poderá utilizar:
REMOTE_HOST
Envia o nome do host que fez o pedido.
REMOTE_ADDR
Envia o IP do host remoto que fez o pedido.
REMOTE_USER
Se o servidor suportar autenticação e o script estiver numa
zona este é o nome com que o utilizador se autenticou.
HTTP_USER_AGENT
O brower utilizado pelo cliente quando efectua o pedido.
Sintaxe: Se quiser ter uma variável de sistema no seu e-mail, utilize o seguinte:
<input type="hidden" name="env_report" value="1">
Campo: print_blank_fields
Descrição: "print_blank_fields" permite-lhe que todos os campos do seu formulário HTML sejam processados, independentemente de terem sido preenchidos ou não. Por defeito os campos não preenchidos não são enviados no e-mail.
Sintaxe: Se desejar receber os campos deixados em branco:
<input type="hidden" name="print_blank_fields" value="1">
Campo: title
Descrição: Este campo permite-lhe especificar o título da página que irá aparecer após submeter o formulário, caso não tenha especificado uma página de redireccionamento através do campo "redirect".
Sintaxe: Se desejar o título 'Retorno do formulário':
<input type="hidden" name="title" value="Retorno do formulário">
Campo: return_link_url
Descrição: Este campo permite-lhe defenir um URL que irá aparecer como link de retorno na página de saída do formulário. Este campo não será utilizado se tiver a utilizar o campo "redirect", mas é útil se não o utilizar para dar a possibilidade ao utilizador de retornar à página principal.
Sintaxe:
<input type="hidden" name="return_link_url" value="http://www.dominio.ext/principal.html">
Campo: return_link_title
Descrição: Este é o título ou texto que irá aparecer no link de retorno que foi especificado no campo "return_link_url".
Sintaxe: <input type="hidden" name="return_link_title" value="Voltar à página principal">
Campo: missing_fields_redirect
Descrição: Este campo permite-lhe especificar um URL para onde os utilizadores serão redireccionados, caso exista um campo em falta que esteja mencionado no campo "required". Este campo permite-lhe especificar uma página de erro em vez de exibir a página por defeito.
Sintaxe:
<input type="hidden" name="missing_fields_redirect" value="http://www.dominio.ext/erro.html">
Campo: background
Descrição: Este campo permite-lhe definir uma imagem para o fundo da página de saída do formulário, caso não tenha especificado um URL de redireccionamento através do campo "redirect". A imagem irá aparecer como background na página de resultados do formulário.
Sintaxe: <input type="hidden" name="background" value="http://www.dominio.ext/image.gif">
Campo: bgcolor
Descrição: Este campo permite-lhe definir o valor da variável "bgcolor" que define a cor do background, da página de resultados do formulário, muito à semelhança do campo "background" acima que permite especificar uma imagem.
Sintaxe: Para uma cor de background branca:
<input type="hidden" name="bgcolor" value="#FFFFFF">
Campo: text_color
Descrição: Este campo funciona da mesma forma que o campo "bgcolor", excepto que define a cor do texto.
Sintaxe: Para uma cor de texto preta:
<input type="hidden" name="text_color" value="#000000">
Campo: link_color
Descrição: Muda a cor dos links na página de resultado do formulário. Funciona da mesma forma que "text_color".
Sintaxe: Para definir a cor vermelha para os links:
<input type="hidden" name="link_color" value="#FF0000">
Campo: vlink_color
Descrição: Muda a cor dos links visitados na página de resultado do formulário, funciona da mesma forma que o campo "link_color".
Sintaxe: Para definir a cor azul para os links visitados:
<input type="hidden" name="vlink_color" value="#0000FF">
Campo: alink_color
Descrição: Muda a cor dos links activos na página de resultado do formulário, funciona da mesma forma que o campo "link_color".
Sintaxe: Para definir a cor azul para os links activos:
<input type="hidden" name="alink_color" value="#0000FF"> |
