Formmail 1.99 ist das klassische CGI-Programm, mit dem man die Inhalte eines ausgefüllten Formulares an eine vorher bestimme E-Mail-Adresse senden kann. Wenn Sie z.B. ein Bestellformular o.ä. haben und die Angaben des Besuchers als E-Mail erhalten möchten, erstellen Sie einfach ein Formular mit Ihrem HTML-Editor und nutzen dieses CGI-Skript.

Um ein solches Formular komplett zu installieren, gehen Sie folgendermaßen vor:

1. Installieren Sie die Source-Codes der benötigen Dateien. Dazu begeben Sie sich per Telnet auf Ihren Server und geben Folgendes ein:
   1. cd / (wechselt zum home)
   2. tar -xvf /contrib/formmail.tar (installiert Dateien)

   Nun befinden sich zwei neue Dateien in Ihrem /home/httpd/cgi-bin-Verzeichnis: 'formmail.pl' und 'formmail.README.txt'.

   Achten Sie unbedingt darauf, dass im easyTECC-Administrationstool die Option "cgi-bin" für die jeweilige Domain aktiviert ist.

   Nur bei Einrichtung in einem kundeneigenen Unterverzeichnis (z.B. /home/httpd/docs/KUNDE/cgi-local) ist Folgendes zu beachten:
   
   Sie müssen bitte darauf achten, dass die Datei 'formmail.pl' auch in diesem Verzeichnis ausführbar ist - dies muss unter Linux vorher bestimmt werden. Geben Sie zu diesem Zweck in dem Verzeichnis, in dem sich das Skript 'formmail.pl' befindet, per Telnet diesen Befehl ein:

   chmod 755 formmail.pl

   Danach ist die Datei 'formmail.pl' über das spätere Formular aufrufbar und kann korrekt arbeiten. Es muss hierbei auch beachtet werden, im easyTECC-Administrationstool die Option "cgi-local" für die jeweilige Domain zu aktivieren.

    

2. Nun erstellen Sie eine HTML-Seite die das eigentliche Formular beinhalten soll. Das kann man mit fast allen gängigen HTML-Editoren. Diese Seite muss wenigstens die beiden folgenden Einträge beinhalten - es gibt viele weitere, optionale Einträge, die Sie in der README-Datei von Formmail 1.99 finden.

   <form method="POST" action="/cgi-bin/formmail.pl">

   Dieser Eintrag leitet das eigentliche Formular unter HTML ein. Der 'action'-Tag (so nennt man die Einträge, die mit '<' beginnen und mit '>' aufhören) leitet die späteren Feldinhalte des Formulars an das angegebene CGI-Programm unter der angegebenen Adresse "/cgi-bin/formmail.pl".
   
   <input type="hidden" name="recipient" value="order@domain.de">
   
   Dieser Eintrag übergibt eine entscheidende Information an das Formmail-Skript - die E-Mail-Adresse, die später alle Daten, die in das Formular vom Besucher eingegeben wurden erhält. Dies sollte natürlich eine entsprechende E-Mail-Adresse bei Ihrem Kunden sein.

   Die folgenden 'hidden'-Felder sind optionale Felder, die aber einen sehr hohen Nutzwert haben:

   • subject = Gibt einen Betreff in der E-Mail an - sinnvoll, wenn Sie mehrere Formulare in einer Domain haben.
   • redirect = An diese URL wird der Besucher umgeleitet, nachdem er das Formular ausgefüllt und abgesandt hat. Sehr gut für eine 'Dankeschön'-Seite, die Sie vorher für diesen Zweck erstellt haben.
   • required = Eine Liste (durch Kommas getrennt), die die Namen der benötigten Felder beinhaltet. Das Skript verlangt vom Benutzer die Eingabe von entsprechenden Daten in diesen Feldern, falls eines dieser Felder nicht ausgefüllt wurde.
   • Weitere optionale Felder finden Sie in der README-Datei von Formmail 1.99

   
   So könnte z.B. der entscheidende Teil einer solchen HTML-Seite mit Formular aussehen:
   
   ...
   ...
   ...
   <form method="POST" action="/cgi-bin/formmail.pl">
   <input type="hidden" name="recipient" value="order@domain.de">
   <input type="hidden" name="subject" value="Anfrageformular">
   <input type="hidden" name="required" value="vorname,nachname,email">
   ...
   ...
   ...