cgifile - Online na nuvem

PROGRAMA:

NOME

cgiemail, cgiecho, cgifile - Ferramentas de conversão CGI Form-to-Mail

A cgiemail usuário guia

Este guia o ajudará a escrever um formulário WWW que enviará uma mensagem de e-mail para você. o
as seguintes etapas são necessárias:

· Crie um modelo de e-mail.

· Coloque um link para o modelo em sua página.

· Decida se um link mailto: serve.

· Crie o formulário HTML.

· Crie formulários HTML mais avançados.

· Certifique-se de que a AÇÃO está correta.

· Experimente seu formulário com cgiecho.

· Transmita ao vivo com cgiemail.

· Depure se você não receber e-mail

As etapas a seguir são opcionais.

· Adicione texto à página de sucesso.

· Use uma página de sucesso alternativa.

· Faça algumas entradas necessárias.

· Especifique a formatação para algumas entradas.

· Use variáveis ​​de ambiente CGI.

Crie an o email template.
Antes de começar a receber mensagens de e-mail pela web, você deve decidir quais
as mensagens devem ser semelhantes. Crie um arquivo ASCII, chamado de modelo de e-mail, que parece
algo assim:

Até: [email protegido] LINHAS DE CABEÇALHO
Assunto: questões três
linha em branco
Qual é o seu nome? [seu nome]
Qual é a sua missão? [missão] CORPO
Qual é a sua cor favorita? [cor]

Em certo sentido, esse modelo é de formato livre. As pessoas que desejam enviar e-mail para você podem fazer o download
este modelo, preencha-o e envie para você. No entanto, o modelo também será usado
pelo programa cgiemail, portanto, antes de enviar o arquivo para o seu servidor WWW, tome cuidado para
siga estas diretrizes:

· Sempre que você quiser que o usuário do seu formulário forneça informações, use uma única palavra
dentro de colchetes sem espaços, por exemplo, Seu nome: [seunome]. Não [Coloque seu nome
aqui].

· Certifique-se de que o endereço no campo Para: esteja correto.

· Se houver linhas em branco entre as linhas do cabeçalho, remova-as.

· Se houver linhas em branco antes das linhas do cabeçalho, remova-as.

· Certifique-se de que todas as suas linhas de cabeçalho sejam válidas. O primeiro caractere da linha deve ser um
carta. A maioria das informações deve estar no corpo da mensagem; não faça o seu próprio
cabeçalhos.

· Certifique-se de que haja uma linha em branco entre as linhas do cabeçalho e o corpo.

· Certifique-se de salvá-lo como texto ASCII. Por exemplo, se você estiver usando o Microsoft Word, use
"Salvar como" e escolha "Somente texto com quebras de linha".

· Se você criou o arquivo em um Mac, certifique-se de carregá-lo como texto, ou seja, CR's traduzido.
(Computadores Unix têm códigos diferentes denotando o fim de uma linha do que os Macs, então seu
pode parecer uma longa linha para o computador Unix.)

Dentro dessas diretrizes, há muita flexibilidade. Você pode colocar Bcc :, X-Face: ou qualquer
outro cabeçalho nos cabeçalhos. Você pode colocar coisas como Cc: [seunome] nos cabeçalhos. Ser
criativo. Só não coloque nada lá que você não gostaria que seu webmaster visse,
porque é para onde vão as mensagens devolvidas.

Agora vá em frente e carregue o seu modelo de e-mail para o servidor WWW e veja-o com o seu
Navegador WWW.

colocar a link para que o modelo on os Disputas de Comerciais.
Aqui está um exemplo:

Você gostaria de cruzar a ponte? Baixe meu formulário de "perguntas três" e envie para
<[email protegido]>.

Mesmo depois de criar seu formulário WWW, você vai querer deixar este link para aumentar
acessibilidade a usuários com deficiência.

Decide if a mailto: link precisarão fazer.
Sem nenhum HTML complicado, você já tem uma maneira de as pessoas na WWW lhe enviarem
as informações que você deseja. Antes de começar a fazer um formulário HTML, decida se
realmente vale a pena. Os formulários na WWW têm duas desvantagens específicas:

· Você receberá muitos e-mails frívolos de pessoas que estão apenas `` navegando na web ''.

· O endereço de e-mail do usuário é digitado manualmente e, muitas vezes, digitado incorretamente, de forma que você
nenhuma maneira de responder. Isso é menos problemático com links mailto:.

Crie que o HTML .
Se você decidiu criar um formulário HTML, você precisa dar às pessoas uma maneira de fornecer um
endereço de e-mail. Com o link mailto :, o remetente forneceria o endereço De: para
eles. Mas agora você precisa adicionar uma linha ao topo do seu modelo de e-mail como esta:

Do email]

Aqui está um exemplo de formulário HTML.

Seu endereço de email: ____________________

Seu nome: ____________________

Sua missão: ____________________

Sua cor favorita: ____________________

Enviar e-mail (este exemplo não envia e-mail).

Esta é a fonte HTML:

<FORM METHOD="POST"
AÇÃO = "http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

Seu endereço de email:
Seu nome:
Sua missão:
Sua cor favorita:



Este é um exemplo muito simples. Observe que o NOME de cada entrada corresponde ao que você
colocado anteriormente no modelo de e-mail. Neste exemplo, eles são e-mail, seunome, missão,
e cor. Este é o conceito chave no uso do cgiemail. Tenha o cuidado de torná-los exatamente os
mesmo; se você colocar NAME = "color" em seu formulário HTML e [color] (observe a grafia
diferença) em seu modelo de e-mail, a entrada não aparecerá no e-mail.

Crie mais avançado HTML formas.
Para aprender a criar formulários mais complicados, leia o guia do NCSA. Todos os seus exemplos de formulários
pode ser convertido para formulários cgiemail simplesmente alterando a AÇÃO. Ao contrário de outros formulários para
programas de e-mail, você não é obrigado a usar entradas ocultas com nomes especiais.

Todos os tipos de entradas (botões de rádio, etc.) funcionam da mesma maneira. Cada entrada precisa de um NOME, e
esse nome deve aparecer entre colchetes em seu modelo de e-mail. É simples assim. Para
para obter mais ideias, consulte a página de exemplo cgiemail.

Realizar certo que o AÇÃO is corrigir.
A parte mais complicada do formulário HTML é definir ACTION corretamente. Comece com o
URL do seu modelo de e-mail e, em seguida, divida-o em duas partes, por exemplo

http://web.mit.edu/wwwdev/cgiemail/questions3.txt
\ / \ /
`--- Parte 1 --- '` -------- Parte 2 ----------'

Em seguida, você coloca o nome do script no meio. Normalmente é `` / cgi-bin / cgiecho '', mas
depende de como seu servidor está configurado. Acontece que em web.mit.edu é
`` / bin / cgiecho '', portanto, minha AÇÃO se parece com isto:

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ / \ / \ /
`--- Parte 1 --- 'nome do script` -------- Parte 2 ----------'

Para simplificar, você pode omitir a parte 1, mas deve incluí-la se quiser testar seu
formulário como um arquivo local. Se você não sabe o que isso significa, sinta-se à vontade para omitir a parte 1.

Experimente Fora os formulário com cgiecho.
Coloque seu formulário em seu navegador WWW favorito, preencha as entradas e envie-o. Vocês
deve ver a aparência do formulário processado. Se, em vez disso, você vir um erro com um número
perto de 500, sua ACTION está provavelmente configurada incorretamente. Volte para a etapa anterior.

Se algumas de suas entradas não parecem estar aparecendo no formulário processado, certifique-se de que
as entradas têm exatamente os mesmos nomes no formulário HTML e no modelo ASCII. Por exemplo
NAME = "seunome" no formulário HTML e [seunome] no modelo de e-mail.

Go viver com cgiemail.
Agora mude cgiecho para cgiemail na AÇÃO de seu formulário HTML. Experimente. Você deve
receber uma mensagem de e-mail com o formulário processado. Se você obtiver uma página de sucesso, mas não
receber correio, há algum problema com o seu arquivo de modelo. Volte e certifique-se de
seguiu corretamente as diretrizes da etapa 1.

Se funcionar, parabéns!

9. Depure se você não receber e-mail

Normalmente, o e-mail é enviado de forma assíncrona, o que significa que vai para uma fila para ser enviado em um
hora conveniente. O correio assíncrono é enviado de forma mais eficiente e confiável, mas tem o
desvantagem de que os problemas só podem ser relatados enviando uma mensagem de erro de volta para o
remetente. Para o sistema de e-mail, parece que o remetente do e-mail é o servidor da web, então
a mensagem de erro não chegará até você.

Se você não está recebendo e-mails, pode usar temporariamente a entrega síncrona de e-mails criando
uma entrada oculta chamada cgiemail-mailopt e dando a ela um valor contendo "sync", por exemplo



Nota: Para a versão 1.1, isso não funcionará. Peça ao seu webmaster para instalar uma versão mais recente.
Alguns mailers têm uma extensão fora do padrão que envia rejeições para um endereço em um
Para: cabeçalho, além do servidor web. No entanto, alguns erros tornam esta linha de cabeçalho
ilegível, portanto, não há como ter certeza de que o salto irá para você.

Opcional: Adicionar texto para que o sucesso Disputas de Comerciais.
Quando o e-mail é enviado, uma página intitulada `` Sucesso '' aparece com o texto da mensagem de e-mail.
Você pode usar uma variável oculta chamada `` addendum '' para adicionar seu próprio texto. Aqui é um simples
exemplo:



Se você estiver disposto a presumir que os leitores do seu formulário estão usando um software de navegador recente
como Lynx 2.6 ou Netscape 3.0, então você pode colocar marcação HTML nesta variável usando o
entidades de caráter apropriadas. Por exemplo, se você quiser adicionar

Obrigado!

então a marcação HTML seria

Obrigado!

o que significa que você precisaria do seguinte em seu formulário:

<INPUT TYPE="oculto" NAME="adendo"
VALUE = "<em> Obrigado! </em>">

Observe que, além de ser difícil de escrever, esse recurso não funcionará para pessoas que usam
software de navegador.

Opcional: Use an alternado sucesso Disputas de Comerciais.
Se não gostar da página padrão que aparece quando o e-mail é enviado com sucesso, você pode
especificar um URL alternativo usando uma variável oculta chamada `` sucesso '' em seu formulário HTML,
por exemplo,

<INPUT TYPE="oculto" NAME="sucesso" VALUE="http://web.mit.edu/">

Nota: Comece seu URL com / ou com http: //. Caso contrário, o cgiemail irá direcionar o seu navegador
para uma segunda chamada de cgiemail, resultando no erro Sem substituições de variáveis.

A partir da versão 1.3, não há como fazer com que esta página de sucesso alternativa contenha informações
o usuário enviou no formulário. Este recurso provavelmente será adicionado em uma versão futura.

Opcional: Realizar alguns inputs necessário.
Se você gostaria de rejeitar automaticamente os formulários com certas entradas deixadas em branco, adicione o
prefixo `` obrigatório- '' para o nome da entrada em seu formulário HTML e seu e-mail
modelo. Aqui está um exemplo:

No formulário HTML:

Seu nome:

No modelo de e-mail

Seu nome: [requer-seunome]

Opcional: Especificar formatação para alguns entradas.
Se, em seu modelo de e-mail, o texto entre colchetes começar com%, o cgiemail irá
use o printf () função em C no nome do campo após a vírgula. Se você não está familiarizado
com esta função, procure em um livro sobre C. Se você estiver familiarizado com ela, observe estes
duas diferenças:

· O primeiro caractere na string de formato deve ser%.

· Caracteres como \ ne \ t devem ser literais. Se você quiser uma nova linha, você deve colocar um
nova linha imediatamente antes da vírgula, mesmo que pareça estranho. Por exemplo, se
O Godzilla's Pizza queria as coberturas listadas uma por linha, eles colocariam o seguinte em
seu modelo de e-mail:

[% s
,cobertura]

Opcional: Use CGI meio Ambiente variáveis.
Este recurso pode ou não funcionar, dependendo se seu webmaster o habilitou ou não
ao configurar o cgiemail.

Além de entradas de formulário, seu modelo de e-mail pode incluir variáveis ​​de ambiente CGI
simplesmente precedendo o nome da variável com um cifrão. Por exemplo,

[$ HTTP_USER_AGENT]

colocará o nome do navegador e / ou gateway do usuário na sua mensagem de e-mail. Em ordem de
respeite a privacidade, seu formulário HTML deve alertar os usuários sobre qualquer informação sobre
aqueles que serão incluídos no e-mail, por exemplo, HTTP_USER_AGENT, REMOTE_ADDR.

Administração
Contato upstream: cgiemail[email protegido]>

Mantenedor do Debian: Anibal Monsalve Salazar[email protegido]>

Informações completas sobre construção, instalação e uso do cgiemail estão disponíveis no WWW:

http://web.mit.edu/wwwdev/cgiemail/

Use cgifile online usando serviços onworks.net