Benutzerdokumentation

benötigte Dateien:

- html-Formular: formular.html
- Email-Format-Datei (bestimmt das Format der zu versendenden Email): formular.data
- Erfolgsseite (optional; Seite, die nach dem Versenden des Formulars angezeigt wird - diese Seite kann die Werte ausgefüllter Felder enthalten): formular.response
- Datei mit Liste unbedingt auszufüllender Felder (optional): formular.required

Anleitung

1. Das html-Formular muss zwei "hidden fields" enthalten: 'destination' und 'subject'. Das Feld 'destination' enthält die Emailadresse, an die das Formular versandt werden soll; und das 'subject'-Feld enthält den Betreff der Email.

   Beispiel:
   <imput type=hidden name=destination value=info@unternehmen.com>
   <input type=hidden name=subject value="Eine Nachricht ist eingegangen">
   
   

2. Andere Headers der Email können auch eingefügt werden:
   
   Beispiel: Reply-To: Header:
   <input name="header:Reply-To" value="info@unternehmen.com" type="hidden">.

3. Die Email-Format-Datei ist der Text (Body) der Email, die versandt werden soll. Formularfelder, die in die Email aufgenommen werden sollen, müssen mit einem $ geschrieben werden. Das Feld "name" muss also als $name geschrieben werden.

4. Das FORM tag muss lauten: <FORM method=POST ACTION="http://www.unternehmen.com/cgi-bin/cgi-mailer">

5. Die Email-Format-Datei muss im selben Verzeichnis liegen wie das Html-Formular, es muss ausserdem den selben Namen mit der Endung .data anstatt .html tragen. Wenn das Html-Formular formular.html heisst, muss die Email-Format-Datei formular.data heissen.

6. Die Erfolgsseite muss ebenfalls im selben Verzeichnis liegen wie das Html-Formular. Sie muss auch denselben Namen tragen, allerdings mit der Endung .response anstatt von .html. Die Erfolgsseite enthält die html-Seite, die angezeigt wird, wenn das Formular erfolgreich versandt worden ist. Die Erfolgsseite kann auch die Werte ausgefüllter Felder enthalten. Wenn z.B. der Wert des Feldes "name" mit in die Erfolgsseite aufgenommen werden soll, muss dort $name geschrieben werden.

7. Wenn Felder unbedingt ausgefüllt werden sollen, könn Sie diese in eine Datei formular.required schreiben. Diese Datei muss auch im selben Verzeichnis liegen wie das Html-Formular. Die Datei formular.required hat folgendes Format:
   
   feld-name1 [Tabulator] Meldung
   feld-name2 [Tabulator] Meldung
   
   Jeder Feldname wird überprüft und wenn er leer ist, wird die "Meldung" ausgegeben.

8. CGI Umgebungsvariablen können wie folgt in die Email-Format-Datei aufgenommen werden:
   
   $ENV{'REMOTE_HOST'}