Hier finden sie eine deutsche Uebersetzung zur Konfiguration Ihres Formmail-Programmes welches sich in ihrem cgi-bin verzeichnis befindet. aufruf ueber: ACHTUNG: Das Programm formmail.pl wurde häufig zu Spamzwecken von Dritten benutzt. Deshalb haben wir das Programm in mailer.pl umbenannt.
configurationseinstellungen siehe unten.
############################################################################## # FormMail Version 1.9 # # Copyright 1995-2001 Matt Wright mattw@worldwidemart.com # # Created 06/09/95 Last Modified 08/03/01 # # Matt's Script Archive, Inc.: http://www.worldwidemart.com/scripts/ # ############################################################################## # COPYRIGHT NOTICE # # Copyright 1995 - 1997 Matthew M. Wright All Rights Reserved. # # # # FormMail kann ohne Gebuehren verwendet und veraendert werden, so lange # # dieser Copyright Hinweis und die obenstehenden Kommentare erhalten bleiben # # Mit der Verwendung dieses Skripts sprechen Sie sowohl Matt Wright als auch # # zeitform Internet Dienste frei von der Verantwortung die Zuverlaessigkeit # # des Skripts betreffend. # # # # Den Code fuer dieses Programm zu verkaufen ohne schriftliche Genehmigung # # ist ausdruecklich verboten. In anderen Worten: fragen Sie bitte zuerst, # # bevor Sie mit meinem Programm versuchen Geld zu machen. # # # # Holen Sie sich auch eine Genehmigung fuer den Vertrieb dieses Skripts # # ueber das Internet oder andere Medien ein. In jedem Fall muessen Copyright # # und Kopfteil erhalten bleiben. # ############################################################################## # Ins Deutsche uebertragen: zeitform Internet Dienste # # Thomas Krisch Alexander Nouak Ulf Stegemann Gbr # # http://www.zeitform.de # # Letzte Aenderung: 13. April 1998 # ############################################################################## FormMail ist ein universelles WWW-Formular zu E-Mail Gateway. Es bedarf lediglich eines input-tags damit dieses Skript mit Ihren Formularen arbeitet. Andere versteckte Konfigurationsfelder koennen ebenso eingefuegt werden, die die Funktionalitaet von FormMail auf Ihrer Site erhoehen. Version 1.6 von FormMail beinhaltet einige Bugfixes, optimierten Code und mehr Kommentare (die von zeitform Internet Dienste allerdings nicht uebersetzt wurden. Anm. d. Ue.). Die groesste Aenderung in dieser Version ist allerdings, dass voreingestellt die Formularfelder in der Reihenfolge sortiert werden, wie sie im Formular erscheinen. Lesen Sie die History um alle Aenderungen kennen zu lernen. Das Script FormMail.pl muss in das cgi-bin Verzeichnis auf Ihrem Server installiert werden und der anonyme WWW-User muss Lese- und Ausfuehrungs- rechte fuer das Skript erhalten. Sollten Sie keinen Zugriff auf das CGI- Verzeichnis auf Ihrem Server haben, koennen Sie eventuell dennoch CGI-Skripts ausfuehren, in dem Sie die Endung .pl in .cgi aendern. Fragen Sie in Zweifelsfaellen Ihren Administrator. Einrichten des FormMail-Skripts: ================================ Das FormMail.pl Skript muss nicht grossartig konfiguriert werden um zu arbeiten. Lassen Sie das Skript unverändert, Sie müssen nur Ihre Internetseite mit untenstehenden Variablen füllen. Ihr FormMail Skript ist nun konfiguriert. ----------------------------------------------------------------------------- Formularkonfiguration: ====================== Der action-tag Ihres Formulars muss auf dieses Skript weisen (offensichtlich), und der method-tag muss POST oder GET in Grossbuchstaben beinhalten. Version 1.6 von FormMail bietet eine Menge neuer Moeglichkeiten, die resultierende HTML-Seite und die Art, wie dieses Skript ablaeuft, zu gestalten. In der Folge finden Sie eine Liste von Formularfeldern und wie sie Sie einsetzen. Notwendige Formularfelder: ========================== Es gibt eigentlich nur ein Formularfeld, das Sie unbedingt einsetzen muessen, damit FormMail richtig funktioniert. Das Empfaengerfeld. Feld: recipient Beschreibung: Es gibt an, an wen der Formularinhalt gesendet werden soll. Hoechstwahrscheinlich werden Sie dieses Feld als versteckt definieren, damit es der Anwender nicht manipuliert, und als Feldinhalt Ihre eigene Email-Adresse oder - als HTML-Program- mierer - die Email-Adresse Ihres Kunden angeben. Syntax: ----------------------------------------------------------------------------- Optionale Formularfelder: ========================= Feld: subject (Betreff) Beschreibung: Das subject-feld erlaubt Ihnen, anzugeben, welcher Betreff in der E-Mail erscheinen soll, die erzeugt wird. Wenn Sie diese Variable nicht definieren, wird das Skript automatisch eine Nachricht mit dem Betreff "WWW Formular Auswertung" erzeugen. Syntax: Wenn Sie ein eigenes Betreff-feld definieren moechten: Wenn Sie dem Anwender erlauben moechten, ein eigenes Betreff- Feld anzugeben: ----------------------------------------------------------------------------- Feld: email Beschreibung: Dieses Feld erlaubt es dem Anwender, eine eigene return- Mailadresse anzugeben. Wenn Sie in der Lage sein wollen, dem Anwender per E-Mail zu antworten, sollten Sie dieses Feld unbedingt in Ihrem Formular aufnehmen und es durch den Anwender ausfuellen lassen. Diese Eingabe des Anwenders erscheint dann im From:-Feld der Nachricht, die Sie erhalten. Nehmen Sie das Feld 'email' in die Liste 'required' auf (s. weiter unten), so wird die Syntx der E-Mail Adresse auf ihre Richtigkeit geprueft. Syntax: ----------------------------------------------------------------------------- Feld: realname (Name) Beschreibung: Das realname-Formularfeld gestattet es dem Anwender, seinen wirklichen Namen einzugeben. Dieses Feld ist zur Identifikation des Absenders nuetzlich und wird ebenfalls in der From:-Zeile erscheinen, wie Sie es von Mailprogrammen her gewohnt sind, in denen neben der Mailadresse auch der komplette Name des Nutzers ausgegeben wird. Syntax: ----------------------------------------------------------------------------- Feld: redirect Beschreibung: Wenn der Anwender nach Abschicken des Formulars zu einer anderen URL als zur Standardantwort des Skripts geleitet werden soll, koennen Sie diese mit Hilfe dieses Felds definieren. Syntax: Um eine URL zu waehlen, zu der der Anwender automatisch geleitet wird: Um Ihrem Anwender zu gestatten, selbst eine URL anzugeben: ----------------------------------------------------------------------------- Feld: required (erforderlich) Version: 1.3 & hoeher Beschreibung: Ermoeglicht es, bestimmte Felder zu definieren, die der Nutzer auf jeden Fall ausfuellen muss. Wenn das Formular abgeschickt wird, ohne dass die in diesem Feld definierten Felder ausgefuellt sind, erscheint eine Fehlermeldung. Um eine selbsterstellte Fehlerseite auszugeben, siehe unter 'missing_fields_redirect'. Syntax: Ersetzen Sie feld1,feld2,feld3 durch beliebig viele im Formular vorkommende Feldnamen, die unbedingt ausgefuellt werden sollen. ----------------------------------------------------------------------------- Feld: env_report Version: 1.3 & Hoeher Beschreibung: Ermoeglicht es, Umgebungsvariablen anzugeben, deren Inhalt mit der E-Mail mitgesendet wird. Dies ist dann nuetzlich, wenn Sie wissen wollen, welchen Browser der Anwender benutzt, von welcher Seite er kommt und andere Attribute. In der Folge finden Sie eine kurze Liste mit sinnvollen Variablen: REMOTE_HOST - Sendet den Hostnamen des Anwenders. REMOTE_ADDR - Sendet die IP-Adresse, von der aus der Anwender auf das Netz zugreift. HTTP_USER_AGENT - Der Browser, den der Anwender einsetzt. Es gibt noch weiter Variablen, die nuetzlich sein koennen. Sie finden mehr dazu unter: http://www.cgi-resources.com/Documentation/Environment_Variables/ Syntax: Wenn Sie Hostnamen und Browser des Anwenders wissen wollten, wuerden Sie folgendes einsetzen: ----------------------------------------------------------------------------- Feld: sort Version: 1.4 & Hoeher Beschreibung: Sortiert die Formularfelder in der Email, die Sie erhalten, in der von Ihnen vorgegebenen Reihenfolge. Wenn Sie dieses Feld nicht definieren, werden die Felder in der Reihenfolge sortiert, in der der Server die Daten ueber das Internet erhaelt. Syntax: Alphabetische Sortierung: Eigene Reihenfolge der Sortierung: ----------------------------------------------------------------------------- Feld: print_config Version: 1.5 & Hoeher Beschreibung: print_config gibt Ihnen die Moeglichkeit, einige Konfigura- tionsvariable in der E-Mail Nachricht ausgeben zu lassen. Normalerweise werden diese Variablen (email, realname, subject) direkt in den Kopfteil der Nachricht geschrieben und nicht mehr gesondert in der Nachricht selbst ausgegeben. Mit print_config koennen Sie dies jedoch aendern. Syntax: Wollten Sie beispielsweise die Felder 'email' und 'subject' in der Nachricht gesondert ausgewiesen haben, wuerden Sie folgenden Tag benutzen: ----------------------------------------------------------------------------- Feld: print_blank_fields Version: 1.6 Beschreibung: print_blank_fields gibt den Inhalt aller Felder aus, ungeachtet ob sie ausgefuellt wurden, oder nicht, also auch, wenn der Inhalt leer ist. Syntax: Wenn Sie auch die leeren Felder ausgegeben haben moechten: ---------------------------------------------------------------------------- Feld: title Version: 1.3 & Hoeher Beschreibung: Dieses Formularfeld ermoeglicht es Ihnen einen Titel fuer die Ergebnisseite zu definieren, wenn Sie nicht eine spezielle Antwortseite (redirect, s.o.) definiert haben. Syntax: Wollen Sie als Titel "Formularergebnisse": ----------------------------------------------------------------------------- Feld: return_link_url Version: 1.3 & Hoeher Beschreibung: Dieses Feld erlaubt Ihnen, eine URL zu spezifizieren, die als Link auf der automatisch generierten Bericht-Seite erscheint und dem Anwender die Moeglichkeit gibt, beispielsweise zur Homepage zurueckzukehren. Dieses Feld wird natuerlich nicht benutzt, wenn das Feld 'redirect' gesetzt wurde. Syntax: ----------------------------------------------------------------------------- Feld: return_link_title Version: 1.3 & Hoeher Beschreibung: Dieses Feld spezifiziert den Linktitel der oben besprochenen URL. Der Link wird also nach dem folgenden Schema generiert: Syntax: ----------------------------------------------------------------------------- Feld: missing_fields_redirect Version: 1.6 Beschreibung: Dieses Formularfeld ermoeglicht es, die Seite zu definieren, die erscheint, wenn die im required-Feld definierten Felder nicht ausgefuellt sind. So koennen Sie eine eigene Fehler- meldungsseite ausgeben lassen statt der vom Skript generierten. Syntax: ----------------------------------------------------------------------------- Feld: background Version: 1.3 & Hoeher Beschreibung: Erlaubt es Ihnen ein Hintergrundbild anzugeben, das verwendet wird, wenn Sie das 'redirect'-Feld nicht gesetzt haben. Dieses Bild erscheint als Hintergrund auf der Bericht-Seite. Syntax: ----------------------------------------------------------------------------- Feld: bgcolor Version: 1.3 & Hoeher Beschreibung: Erlaubt es Ihnen eine Hintergrundfarbe anzugeben, die fuer die Bericht-Seite verwendet wird. Muss nicht gesetzt werden, wenn 'redirect' verwendet wurde. Syntax: Fuer die Hintergrundfarbe Weiss: ----------------------------------------------------------------------------- Feld: text_color Version: 1.3 & Hoeher Beschreibung: Funktioniert wie 'bgcolor', nur dass hier die Textfarbe naeher bestimmt wird. Muss nicht gesetzt werden, wenn 'redirect' verwendet wurde. Syntax: Fuer die Textfarbe Schwarz: ----------------------------------------------------------------------------- Feld: link_color Version: 1.3 & Hoeher Beschreibung: Funktioniert wie 'bgcolor', nur dass hier die Linkfarbe naeher bestimmt wird. Muss nicht gesetzt werden, wenn 'redirect' verwendet wurde. Syntax: Fuer die Linkfarbe Rot: ----------------------------------------------------------------------------- Feld: vlink_color Version: 1.3 & Hoeher Beschreibung: Funktioniert wie 'bgcolor', nur dass hier die Linkfarbe der bereits besuchten Links naeher bestimmt wird. Muss nicht gesetzt werden, wenn 'redirect' verwendet wurde. Syntax: Fuer die besuchte-Linkfarbe Blau: ----------------------------------------------------------------------------- Feld: alink_color Version: 1.4 & Hoeher Beschreibung: Funktioniert wie 'bgcolor', nur dass hier die Linkfarbe der aktiven Links naeher bestimmt wird. Muss nicht gesetzt werden, wenn 'redirect' verwendet wurde. Syntax: Fuer die aktive-Linkfarbe Blau:: ----------------------------------------------------------------------------- Alle anderen Formularfelder die in Ihrem Formular erscheinen, werden Ihnen zurueckgemailt und erscheinen in der Bericht-Seite, sofern Sie nicht das 'redirect'-Feld gesetzt haben. Die Anzahl der Felder, die Sie aufnehmen unterliegt keiner Beschraenkung, ausgenommen der Beschraenkungen, die von Browser oder Server vorgegeben werden. ----------------------------------------------------------------------------- Einige Nutzungsmoeglichkeiten fuer dieses Skript sind: 1) Sie wollen ein Formular bereitstellen, wissen aber nicht, wie man ein CGI-Skript dafuer schreibt. 2) Sie sind Administrator eines Servers und wollen Ihren Anwendern die Moeglichkeit geben, Formulare zu benutzen, ihnen jedoch nicht eigene cgi-bin-Verzeichnisse zur Verfuegung stellen. Sie koennen dieses Skript einrichten und allen Benutzern gestatten, darauf zuzugreifen. 3) Sie wollen EIN Skript, das all Ihre Formulare abarbeitet und Ihnen den Inhalt zumailt. ----------------------------------------------------------------------------- History: Version 1.0 06/11/95 - This script was created. Version 1.1 08/03/95 - A major hole in the script which allowed users to run commands under your server's uid was disabled, thanks to Paul Phillips, who noticed the error. - The ability to redirect the user to a specified HTML file after they filled out a form was added. Version 1.2 09/23/95 - If the form field is one of the required or optional 'special' fields, such as redirect, recipient, subject, email, realname, etc... the script will not print these fields to either your mail message or to the user's screen when they are returned to a generic form response. It helps you so that things do not get duplicated. Version 1.3 01/21/96 - Much needed update finally completed - Added form fields: env_report, bgcolor, background, link_color, vlink_color, title, text_color, return_link_title, return_link_url and required. - Security hole, which allowed any user on any system to bum off of your FormMail script, has been plugged up with the @referers variable. - Report style in return html and e-mail touched up a bit. Version 1.4 01/23/96 - Added options: sort, alink_color - Fixed a few bugs from Version 1.3, namely the fact that the link_colors weren't working well. - FormMail now supports both the GET and POST methods. Version 1.5 02/05/96 - Sorting of Fields in E-Mail Response Fixed. - print_config option added. Version 1.6 05/02/97 - Sorting of fields by default was fixed to now sort in the order the fields are passed to FormMail from the web browser, which is usually the same order as they appear in the HTML form. - The sort order: directive, env_report and print_config parsing routines were made to better compensate for line breaks and extra spaces in input for ease of use. - Redirect error causing the redirect option to incorrectly work with https (secure servers) was fixed. - Input of a '0' in a regular form field now recognized as input and sent back to user. - Output of non-filled in form fields suppressed. - E-mail addresses checked for correct syntax if designated a required field. - Fields only printed if they contain a value or if the print_blank_fields option is set to 1. - missing_fields_redirect added so you can route users who don't completely fill out the form to a pre-made HTML page. - Parts of code optimized, especially in respect to the way config variables are handled. ----------------------------------------------------------------------------- Matt Wright - mattw@worldwidemart.com - http://www.worldwidemart.com/scripts/ zeitform Internet Dienste - zeitform@zeitform.de - http://www.zeitform.de