O MiniForm permite que você envie o conteúdo de um formulário HTML para um ou mais endereços de e-mail.

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 miniform.cgi devem constar em seu código. Estes comandos são definidos em variáveis tipo hidden, e iniciam com o caracter "_" (underline/sub-linha). Algumas variáveis são obrigatórias e outras são opcionais.

Poderá ser utilizado qualquer nome para as variáveis personalizadas e qualquer formato para os campos do formulário, porém não inicie o nome de uma variável com o caracter "_" ou "#", pois estes caracteres são utilizados para comandos específicos do MiniForm.

Todas as variáveis definidas no formulário serão listadas (na ordem especificada) com seus respectivos valores, no e-mail que será enviado ao(s) destinatário(s).

OBS: nos exmplos abaixo, onde aparece "seudominio.xxx" substitua pelo seu domínio.

CONFIGURAÇÃO DO FORMULÁRIO

- Início do formulário (obrigatório)

O comando abaixo inicia o formulário e a utilização do miniform.cgi (o método de envio do formulário poderá ser do tipo "post" ou "get"):

- Variável "_to" (obrigatório)

Esta variável define o e-mail do(s) destinatário(s) que receberá(ão) as informações do formulário. Caso haja mais de um destinatário, os endereços de e-mail destes deverão estar separados por vírgula e sem espaço.

Exemplo:

Note que neste exemplo foi definido 2 destinatários.

- Variável "_from" (obrigatório)

Esta varável define o e-mail que aparecerá no campo "From:" da mensagem.

Exemplo:

- Variável "_subject" (obrigatório)

Esta variável define o assunto que aparecerá no campo "Subject:" da mensagem.

Exemplo:

- Variável "_message" (opcional)

Esta variável permite personalizar o corpo da mensagem. Pode-se escrever qualquer texto bem como inserir informações de data, hora, IP do usuário que preencheu o formulário e as informações do próprio formulário.

Utilize os seguintes tags especiais para inserir informações de data, hora e IP:

{#dia}- dia
{#mes} - mês
{#ano} - ano
{#hor} - hora
{#min} - minuto
{#seg} - segundo
{#dsem} - dia da semana
{#nmes} - nome do mês
{#ip} - IP do usuário.

Para inserir as informações do formulário utilize o tag {=nome_da_variável}.

Exemplo:

- Variável "_vars" (opcional)

Caso você não tenha definido a variável "_message" você poderá definir quais variáveis do formulário aparecerão na mensagem. Neste caso o MiniForm irá montar a mensagem com os dados automaticamente, com as variáveis definidas. As variáveis deverão estar separadas por vírgula.

Exemplo:

- Variável "_check" (opcional)

O MiniForm poderá verificar se os campos obrigatórios de um formulário foram preenchidos. Utilize a variável "_check" para defir quais são as variáveis obrigatórias do formulário. As variáveis obrigatórias deverão estar separadas por vírgula.

Exemplo:

Neste exemplo, o MiniForm verificará se foram preenchidos os campos "nome" e "email". Caso algum dos campos obrigatórios não tenham sido preenchidos, será carregada a página definida pela variável "_errpage", que será vista a seguir.

- Variável "_errpage" (opcional)

Caso a variável "_check" tenha sido utilizada, e caso algum campo obrigatório não tenha sido preenchido será carregado a página definida na variável "_errpage". Caso a variável "_check" tenha sido utilizada, mas "_errpage" não tenha sido definido, então será carregada uma página de erro padrão do MiniForm, no caso de algum campo obrigatório não ter sido preenchido. O endereço da página poderá ser um URL absoluto ou relativo.

Exemplo:

OBS: Caso a variável "_check" não tenha sido utilizado, também não será necessário definir a variável "_errpage".

- Variável "_dstpage" (opcional)

Esta variável define a página que será carregada após o envio da mensagem com os dados do formulário. Caso esta variável não seja definida, então será carregada uma página padrão do MiniForm. O endereço da página poderá ser um URL absoluto ou relativo.

Exemplo:

EXEMPLO DE UM FORMULÁRIO COM CONFIGURAÇÃO MÍNIMA

Neste exemplo não foram utilizadas as seguintes variáveis opcionais do MiniForm:

_message
_check
_errpage
_dstpage

Se a variável opcional "_vars" não for definida será enviado uma mensagem em branco, pois a variável "_message" também não foi definida.

Note que neste exemplo não

EXEMPLO DE UM FORMULÁRIO COM CONFIGURAÇÃO COMPLETA

Neste exemplo foram utilizadas todas as variáveis do MiniForm, exceto "_vars", pois os dados do formulário serão inseridos na mensagem definida em "_message".