cgifile - Online in de cloud

PROGRAMMA:

NAAM

cgiemail, cgiecho, cgifile - CGI Form-to-Mail conversietools

De cgiemail gebruiker gids

Deze handleiding helpt u bij het schrijven van een WWW-formulier dat u een e-mailbericht stuurt. De
volgende stappen zijn vereist:

· Maak een e-mailsjabloon.

· Zet een link naar het sjabloon op je pagina.

· Bepaal of een mailto:-link voldoende is.

· Maak het HTML-formulier.

· Maak meer geavanceerde HTML-formulieren.

· Zorg ervoor dat de ACTIE correct is.

· Probeer je formulier uit met cgiecho.

· Ga live met cgiemail.

· Debuggen als je geen mail ontvangt

De volgende stappen zijn optioneel.

· Voeg tekst toe aan de succespagina.

· Gebruik een alternatieve succespagina.

· Maak een aantal inputs vereist.

· Geef de opmaak op voor sommige invoer.

· Gebruik CGI-omgevingsvariabelen.

creëren an e-mail sjabloon.
Voordat u e-mailberichten via internet gaat ontvangen, moet u beslissen wat deze
berichten eruit moeten zien. Maak een ASCII-bestand, een e-mailsjabloon genaamd, dat eruitziet als
iets zoals dit:

aan: [e-mail beveiligd] HEADER LIJNEN
Onderwerp: vragen drie
lege regel
Wat is jouw naam? [uw naam]
Wat is jouw zoektocht? [zoektocht] LICHAAM
Wat is je favoriete kleur? [kleur]

In zekere zin is deze sjabloon een vrije vorm. Mensen die je e-mail willen sturen, kunnen downloaden
dit sjabloon, vul het in en stuur het naar u op. De sjabloon wordt echter ook gebruikt
door het cgiemail-programma, dus voordat u het bestand naar uw WWW-server uploadt, moet u ervoor zorgen dat
volg deze richtlijnen:

· Waar u ook wilt dat de gebruiker van uw formulier informatie verstrekt, gebruik een enkel woord
tussen vierkante haken zonder spaties, bijv. Uw naam: [uwnaam]. Niet [Zet je naam
hier].

· Zorg ervoor dat het adres in het veld Aan: correct is.

· Als er tussen de kopregels lege regels staan, verwijder deze dan.

· Als er lege regels voor de kopregels staan, verwijder deze dan.

· Zorg ervoor dat al uw kopregels geldig zijn. Het eerste teken op de regel moet a . zijn
brief. De meeste informatie zou in de berichttekst moeten staan; verzin het niet zelf
koppen.

· Zorg ervoor dat er een lege regel is tussen de kopregels en de hoofdtekst.

· Zorg ervoor dat u het opslaat als ASCII-tekst. Als u bijvoorbeeld Microsoft Word gebruikt, gebruikt u
"Opslaan als" en kies "Alleen tekst met regeleinden".

· Als je het bestand op een Mac hebt gemaakt, zorg er dan voor dat je het als tekst uploadt, dat wil zeggen CR's vertaald.
(Unix-computers hebben andere codes die het einde van een regel aangeven dan die van Mac, dus uw
bestand kan eruitzien als één lange regel voor de Unix-computer.)

Binnen deze richtlijnen is er veel flexibiliteit. U kunt Bcc:, X-Face:, of elke
andere header in de headers. Je kunt dingen als Cc: [jouwnaam] in de headers zetten. Zijn
creatief. Zet er gewoon niets in waarvan je niet wilt dat je webmaster het ziet,
want daar gaan de teruggestuurde berichten naartoe.

Ga je gang en upload je e-mailsjabloon naar de WWW-server en bekijk het met je
WWW-browser.

Zetten a link naar de sjabloon on jouw pagina.
Hier is een voorbeeld:

Wil je de brug over? Download mijn "vragen drie"-formulier en stuur het naar
<[e-mail beveiligd]>.

Zelfs nadat je je WWW-formulier hebt gemaakt, wil je deze link laten staan ​​om te vergroten
toegankelijkheid voor gebruikers met een handicap.

Beslissen if a mailto: link wil doen.
Zonder ingewikkelde HTML heb je al een manier waarop mensen op het WWW je kunnen sturen
de gewenste informatie. Voordat u de moeite neemt om een ​​HTML-formulier te maken, moet u beslissen of:
het is echt de moeite waard. Formulieren op het WWW hebben twee specifieke nadelen:

· Je zult veel frivole e-mail krijgen van mensen die alleen maar 'op het web surfen'.

· Het e-mailadres van de gebruiker wordt handmatig getypt en wordt vaak verkeerd getypt, zodat u:
geen manier om te antwoorden. Bij mailto:links is dat minder een probleem.

creëren de HTML vorm.
Als je hebt besloten een HTML-formulier te maken, moet je mensen een manier geven om een
e-mailadres. Met de mailto:-link zou hun mailer het Van:-adres voor
hen. Maar nu moet je een regel toevoegen aan de bovenkant van je e-mailsjabloon, zoals deze:

Van email]

Hier is een voorbeeld van een HTML-formulier.

Jouw e-mailadres: ____________________

Uw naam: ____________________

Uw zoektocht: ____________________

Je favoriete kleur: ____________________

E-mail verzenden (In dit voorbeeld wordt geen e-mail verzonden.)

Dit is de HTML-bron:

<FORM METHODE="POST"
ACTIE="http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt">

Jouw e-mailadres:
Uw naam:
Jouw zoektocht:
Je favoriete kleur:



Dit is een heel eenvoudig voorbeeld. Merk op dat de NAAM van elke ingang overeenkomt met wat u
eerder in het e-mailsjabloon heeft gezet. In dit voorbeeld zijn dat e-mail, jouwnaam, quest,
en kleur. Dit is het sleutelconcept bij het gebruik van cgiemail. Zorg ervoor dat u ze precies zo maakt
dezelfde; als je NAME="color" in je HTML-formulier zet en [color] (let op de spelling
verschil) in uw e-mailsjabloon, wordt de invoer niet weergegeven in de e-mail.

creëren meer vergevorderd HTML vormen.
Lees de handleiding van de NCSA om meer gecompliceerde formulieren te leren maken. Al hun voorbeeldvormen
kan worden geconverteerd naar cgiemail-formulieren door simpelweg de ACTIE te wijzigen. In tegenstelling tot andere vormen-naar-
e-mailprogramma's, bent u niet verplicht om verborgen invoer met speciale namen te gebruiken.

Alle soorten ingangen (keuzerondjes, enz.) werken op dezelfde manier. Elke ingang heeft een NAAM nodig, en
die naam moet tussen vierkante haken staan ​​in je e-mailsjabloon. Het is zo simpel. Tot
voor meer ideeën, zie de cgiemail voorbeeldpagina.

Merk zeker de ACTIE is corrigeren.
Het lastigste deel van het HTML-formulier is om de ACTIE correct in te stellen. Begin met de
URL van uw e-mailsjabloon en splits deze vervolgens in twee delen, bijv.

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

Vervolgens zet je de scriptnaam in het midden. Meestal is dit ``/cgi-bin/cgiecho'', maar het is
hangt af van hoe uw server is geconfigureerd. Op web.mit.edu is het toevallig
``/bin/cgiecho'', dus mijn ACTIE ziet er als volgt uit:

http://web.mit.edu/bin/cgiecho/wwwdev/cgiemail/questions3.txt
\ /\ /\ /
`--- Deel 1 ---' scriptnaam ` -------- Deel 2 ----------'

Voor de eenvoud mag je deel 1 weglaten, maar je moet het wel opnemen als je je . wilt testen
formulier als een lokaal bestand. Als je niet weet wat dat betekent, sla dan gerust deel 1 over.

Probeer uit jouw formulier Met cgiecho.
Zet uw formulier in uw favoriete WWW-browser, vul de gegevens in en verzend het. Jij
zou moeten zien hoe het verwerkte formulier eruitziet. Als u in plaats daarvan een fout ziet met een nummer
bijna 500 is, is uw ACTIE waarschijnlijk verkeerd ingesteld. Ga terug naar de vorige stap.

Als sommige van uw invoer niet lijkt te verschijnen in het verwerkte formulier, zorg er dan voor dat:
de ingangen hebben exact dezelfde namen in het HTML-formulier als in het ASCII-sjabloon. bijv
NAME="uwnaam" in het HTML-formulier en [uwnaam] in het e-mailsjabloon.

Go leven Met cgiemail.
Verander nu cgiecho in cgiemail in de ACTIE van je HTML-formulier. Probeer het. Je zou moeten
ontvang een e-mail met het verwerkte formulier. Als u een succespagina krijgt, maar niet
e-mail ontvangt, is er een probleem met uw sjabloonbestand. Ga terug en zorg ervoor dat je
de richtlijnen in stap 1 correct hebt gevolgd.

Als het werkt, gefeliciteerd!

9. Debuggen als je geen mail ontvangt

Normaal gesproken wordt e-mail asynchroon verzonden, wat betekent dat het in een wachtrij gaat om te worden verzonden om at a
geschikte tijd. Asynchrone e-mail wordt efficiënter en betrouwbaarder verzonden, maar heeft de
nadeel dat problemen alleen gemeld kunnen worden door een foutmelding terug te mailen naar de
afzender. Voor het mailsysteem lijkt het erop dat de afzender van de mail de webserver is, dus
de foutmelding komt niet bij je terecht.

Als u geen e-mail ontvangt, kunt u tijdelijk synchrone e-mailbezorging gebruiken door een
een verborgen invoer met de naam cgiemail-mailopt en het een waarde geven die "sync" bevat, bijv



Opmerking: voor release 1.1 werkt dit niet. Vraag uw webmaster om een ​​nieuwere release te installeren.
Sommige mailers hebben een niet-standaard extensie die bounces stuurt naar een adres in een Error-
Aan: header naast de webserver. Sommige fouten maken deze kopregel echter
onleesbaar, dus er is geen manier om er absoluut zeker van te zijn dat de bounce naar jou gaat.

Optioneel: Toevoegen tekst naar de succes pagina.
Wanneer e-mail wordt verzonden, verschijnt een pagina met de titel ``Succes'' met de tekst van het e-mailbericht.
U kunt een verborgen variabele genaamd ``addendum'' gebruiken om uw eigen tekst toe te voegen. Hier is een eenvoudige
voorbeeld:



Als u bereid bent aan te nemen dat de lezers van uw formulier recente browsersoftware gebruiken
zoals Lynx 2.6 of Netscape 3.0, dan kunt u HTML-opmaak in deze variabele plaatsen met de
passende karakterentiteiten. Als u bijvoorbeeld wilt toevoegen

Dank je!

dan zou de HTML-opmaak zijn

Bedankt!

wat betekent dat je het volgende nodig hebt in je formulier:

<INPUT TYPE="verborgen" NAME="addendum"
VALUE="<em>Bedankt!</em>">

Merk op dat deze functie niet alleen moeilijk te schrijven is, maar ook niet werkt voor mensen die oudere gebruiken
browsersoftware.

Optioneel: Te gebruiken an afwisselend succes pagina.
Als u de standaardpagina die wordt weergegeven wanneer e-mail met succes is verzonden, niet leuk vindt, kunt u:
specificeer een alternatieve URL met behulp van een verborgen variabele genaamd ``succes'' in uw HTML-formulier,
bv

<INPUT TYPE="verborgen" NAME="succes" VALUE="http://web.mit.edu/">

Let op: Begin je URL met / of met http:///. Anders stuurt cgiemail uw browser
naar een tweede aanroep van cgiemail, resulterend in de fout Geen variabele vervangingen.

Vanaf release 1.3 is er geen manier om deze alternatieve succespagina informatie te laten bevatten
de gebruiker heeft het formulier ingevuld. Deze functie zal waarschijnlijk in een toekomstige release worden toegevoegd.

Optioneel: Merk sommige ingangen vereist.
Als u formulieren automatisch wilt weigeren als bepaalde invoer blanco wordt gelaten, voegt u de
prefix ``required-'' voor de naam van de invoer in zowel uw HTML-formulier als uw e-mail
sjabloon. Hier is een voorbeeld:

In het HTML-formulier:

Uw naam:

In het e-mailsjabloon

Uw naam: [required-yourname]

Optioneel: Specificeren opmaak For sommige ingangen.
Als in uw e-mailsjabloon de tekst tussen vierkante haken begint met %, zal cgiemail
Gebruik de printf () functie in C op de veldnaam na de komma. Als je niet bekend bent
met deze functie, kijk in een boek over C. Als je er bekend mee bent, let dan op deze:
twee verschillen:

· Het eerste teken in de opmaakreeks moet % zijn.

· Tekens als \n en \t moeten letterlijk zijn. Als je een nieuwe regel wilt, moet je een
newline net voor de komma, ook al ziet dit er vreemd uit. Bijvoorbeeld, als
Godzilla's Pizza wilde dat de toppings één per regel vermeldden, ze zouden het volgende erin doen:
hun e-mailsjabloon:

[%S
,topping]

Optioneel: Te gebruiken CGI milieu variabelen.
Deze functie kan wel of niet werken, afhankelijk van of uw webmaster deze al dan niet heeft ingeschakeld
bij het configureren van cgiemail.

Naast formulierinvoer kan uw e-mailsjabloon CGI-omgevingsvariabelen bevatten
gewoon door de naam van de variabele te laten voorafgaan door een dollarteken. Bijvoorbeeld,

[$HTTP_USER_AGENT]

zal de naam van de browser en/of gateway van de gebruiker in uw e-mailbericht plaatsen. Om zo te
respecteer de privacy, uw HTML-formulier moet gebruikers waarschuwen voor informatie over:
die in de e-mail zullen worden opgenomen, bijv. HTTP_USER_AGENT, REMOTE_ADDR.

Administratie
Stroomopwaarts contact: cgiemail[e-mail beveiligd]>

Debian-beheerder: Anibal Monsalve Salazar[e-mail beveiligd]>

Volledige informatie over het bouwen, installeren en gebruiken van cgiemail is beschikbaar op het WWW:

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

Gebruik cgifile online met onworks.net-services