MAIL00002 - centronmail-Formularmailer: Einrichtung
Eine ausführliche Dokumentation der Funktionen und der Befehler für das centronmail-Formularmailer-Skript können Sie im PDF-Format unter diesem Link downloaden.
dokumentation_centronmail_formmailer.pdf
Diese Dokumentation dient der Konfiguration des ‚centronmail’ Formmailer-Skripts für den Versand von Formularen, z.B. zur Kontaktaufnahme oder zur normierten Bestellabgabe.
Beachten Sie hierbei bitte, dass Sie dieses Skript erst ab dem Paket ‚Economic Scripting’ nutzen können.
Im Folgenden eine Anleitung, welche Skriptzeilen Sie an die gewünschte Stelle Ihrer HTML-Website setzen müssen, um das Skript effektiv einsetzen zu können.
Die verwendeten Variablen, die Ihr Formular an das Skript übergibt, sollten folgendermaßen aussehen:
Dies ist die erste Zeile Ihres Formulars, mit dem Sie das Systemskript ansprechen:
<form name="IhrFormularName" action="/scripts/centronmail.asp" method="post">
Die folgende Zeile erzeugt die Absenderadresse, die in der vom Formular erstellten E-Mail angezeigt wird – in diesem Beispiel also ‚root@IhreDomain.de’:
<input type="hidden" value="root@IhreDomain.de" name="_from">
So definieren Sie die Empfängeradresse – in diesem Fall also ‚info@IhreDomain.de’:
<input type="hidden" value="root@IhreDomain.de" name="_recipients">
Diese Zeile wiederum definiert den Betreff Ihrer E-Mail – in unserem Beispiel wäre dies also ‚Bestellung’:
<INPUT type=hidden value="Betreff" name="_subject" >
Sie können zum Abschluss als Bestätigungsseite Ihre selbst gestaltete Website verwenden. Mit folgendem Code fügen Sie Ihre eigene Dankesseite hinzu. Beachten Sie hier bitte, dass Sie Ihre Domain und entsprechend auch den genauen Ort Ihrer Dankesseite angeben müssen:
<INPUT type=hidden value="http://www.domain.de/danke.htm" name="_redirect">
Die restlichen Formularfelder, die Sie in Ihren Formularen einfügen, werden automatisch vom centronmail als E-Mail mitverschickt.
Bitte versuchen Sie nicht, die Formulare von unserer Webseite zu kopieren (z.B. das Kontaktformular), da diese in Skriptsprachen geschrieben sind auf Ihrer Seite wahrscheinlich nicht funktionieren würden.
Ihre Formulare können Sie sehr einfach mit den verschiedenen HTML-Editoren erstellen, die sich momentan auf dem Markt befinden, z.B. mit dem Macromedia / Adobe DreamWeaver, Microsoft FrontPage / Expression Web Designer und anderen.
Ein weiteres, fertiges Beispielformular, das alle Funktionen des Skripts ausnutzt, sieht wie folgt aus:
<form name="IhrFormularName" action="/scripts/centronmail.asp" method="post">
<p>
<input type="hidden" value="root@IhreDomain.de" name="_from">
<input type="hidden" value="root@IhreDomain.de" name="_recipients">
<input type="hidden" value="Betreff" name="_subject" >
<input type="hidden" value="Name,Customer ID,Email,Comments" name="_requiredFields">
<input type="hidden" value="http://www.domain.de/danke.htm" name="_redirect">
<input name="_envars" type="hidden" value="HTTP_REFERER,HTTP_USER_AGENT,REMOTE_ADDR" />
Name: <input name="Name" type="text"><br>
Ihre ID: <input name="Customer ID" type="text"><br>
E-Mail-Adresse: <input name="Email" type="text"><br>
Kommentar:<br>
<textarea name="Comments" rows=5 cols=50></textarea>
<input type="submit" value="Abschicken">
<input type="reset" value="Löschen">
</p>
</form>
Weitere Erläuterungen der im Skriptbeispiel verwendeten Variablen:
_recipients: (Pflichtfeld)
Mit _recipients definieren Sie die E-Mail Adresse, welche die Inhalte des Formulars per Mail erhalten soll. Wünschen Sie, dass die E-Mail an mehrere Empfänger verschickt werden soll, können Sie deren Adresse durch "," trennen.
Beispiel:
<input type="hidden" value="root@IhreDomain.de" name="_recipients"> (hier werden die E-Mails des Formularskripts an root@IhreDomain.de geschickt)
oder
<input type="hidden" value="root@IhreDomain.de,info@IhreDomain.de" name="_recipients"> (hier werden die E-Mails des Formularskripts sowohl an root@IhreDomain.de als auch an info@IhreDomain.de verschickt)
_from:
Mit der Variablen ‚_from’ legen Sie die E-Mail Adresse fest, die in den E-Mails des Formularskripts als Absender angegeben wird. Antwortet ein Empfänger des Formulars auf die E-Mail, geht die Antwort an die in ‚_from’ definierte Adresse.
_subject:
Durch ‚_subject’ können Sie die Betreffzeile der vom Formmailer erstellten E-Mails festlegen, z.B. „Neue Bestellung“, wenn es sich um ein Bestellformular handelt.
_requiredFields:
Hier legen Sie fest, welche Felder von Benutzern des Formulars auf jeden Fall ausgefüllt werden müssen, bevor das Formular seine E-Mail(s) verschickt.
_redirect:
Wie bereits oben beschrieben, können Sie im Feld ‚_redirect’ die Website angeben, auf die der Benutzer nach Abschicken des Formulars weitergeleitet werden soll.
Die obigen Variablen sind allesamt vom type=“hidden“, das heißt, sie sind für den Benutzer nicht sichtbar. Das heißt, diese Werte ändern sich auch nicht, da hier keine Eingabeaufforderung erfolgt.
Die nun Folgenden dagegen sind Eingabefelder, die so im Formular dargestellt werden.
Name:
Hier wird der Benutzer aufgefordert, seinen Namen anzugeben.
Customer ID:
In das Feld ‚Ihre ID’ soll die Kundennummer eingegeben werden – natürlich können Sie die Variablennamen sowie die Feldnamen beliebig ändern, solange Sie in Ihrer Verwendung der Bezeichnungen konsistent bleiben (das heißt, dass Sie keine Variablennamen doppelt vergeben und ähnliches) sowie sich an die Benennungskonventionen halten (z.B. keine Sonderzeichen).
Email:
Die Variable ‚Email’ ist mit dem Feld ‚E-Mail-Adresse’ verknüpft.
Comments:
Das Feld ‚Comments’ wird als fünfreihige Eingabebox mit 50 Spalten erstellt.
Mit den Feldern ‚submit’ und ‚reset’ erstellen Sie zwei Buttons, einen zum ‚Abschicken’ des Formulars, einen zum ‚Löschen’ der Eingaben im Formular.