Sie können außerdem noch ein Feld namens subject anlegen. Hier kann ein Betreff für die Mail eingegeben werden. Wenn Sie auf dieses Feld verzichten, erhalten die E-Mails automatisch den in $default_subject definierten Betreff (s.u.).
Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld enthält einen Alias-Empfänger. Wie das funktioniert, können Sie bei der Beschreibung der Einstellung $aliases lesen.
Zusätzlich können Sie die vorgegebenen Formularfelder mit individuellen ergänzen.
+Wenn Sie Captchas (zufällige Zeichenfolgen, die der Benutzer vor dem Absenden des Formulars eingeben muss, um Spambots auszuschließen) benutzen wollen (siehe unten), müssen Sie im Formular die Datei captcha.php als Bild einbinden (<img>-Tag). Bedenken Sie, dass Sie diese Datei auch in den Templates einbinden müssen!
Das Formular muss dann noch mit POST die Daten an die Datei mailer.php (oder wie Sie die Datei genannt haben) senden.
@@ -142,7 +150,7 @@ Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld enGeben Sie zwischen den einfachen Anführungszeichen die Adresse an, an die die Mail gehen soll. Wenn die Mail an mehrere Empfänger gehen soll, so trennen Sie die einzelnen E-Mail-Adressen ganz einfach durch Semikolons.
-Das war es im Grunde genommen. Aber Form E-Mail lässt sich noch weiter konfigurieren. Mehr dazu finden Sie in den nächsten beiden Abschnitten.
+Sie haben nun Form E-Mail für die Standard-Nutzung konfiguriert. Form E-Mail lässt sich jedoch noch feiner konfigurieren. Mehr dazu finden Sie in den nächsten Abschnitten.
@@ -163,8 +171,9 @@ Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld en$aliases$mailto.array('info' => 'info@IhreDomain.xyz', 'support' => 'support@IhreDomain.xyz',
- 'alle' => 'info@IhreDomain.xyz; support@IhreDomain.xyz')array('info' => 'info@example.com', 'support' => 'support@example.com',
+ 'alle' => 'info@example.com; support@example.com')<select>-Box verwenden, über das der Benutzer den Empfänger auswählen kann).
@@ -264,7 +273,7 @@ Beispiel: array('HTTP_USER_AGENT','REMOTE_ADDR')
$referer_okarray('HTTP_USER_AGENT','REMOTE_ADDR')
$err_name_long$err_subject_long$err_text_long$err_send_error$err_store_error$err_only_postarray('HTTP_USER_AGENT','REMOTE_ADDR')
Seit Version 3.5 ist es möglich, in Form E-Mail zusätzlich zu den vorgegebenen Formularfeldern für Name, E-Mail-Adresse, Betreff und Text eigene Formularfelder zu definieren, die dann von Form E-Mail verarbeitet und in die Mail eingefügt werden.
Wie Form E-Mail diese Formularfelder behandelt, wird über verschiedene Optionen gesteuert, so ist es möglich die Länge des Inhalts zu prüfen, den Inhalt gegen einen regulären Ausdruck und gegen eine frei definierbare PHP-Funktion zu prüfen und am Ende den Inhalt noch durch eine PHP-Funktion aufzubereiten.
Die Konfiguration der individuellen Formularfelder geschieht über das PHP-Array $user_fields in config.php. Sie benötigen zunächst den Namen des Formularfeldes, also das, was Sie im HTML-Formular als Namen angeben. Nehmen wir an, Sie haben folgenden HTML-Code für ein Formularfeld:
<input type="text" name="beruf" />
Der Name des Feldes lautet also beruf. Dies benötigen wir für die weitere Definition.
+ +Sie können nun verschiedene Prüfwerte definieren, mit denen Form E-Mail den Inhalt des Formularfeldes überprüft und ggf. eine Fehlermeldung ausgibt. Diese werden in der folgenden Tabelle erläutert (die Tabelle geht der Einfachheit halber weiterhin vom Formularfeld beruf aus - Sie müssen dies natürlich anpassen!):
+ +| Einstellung | +Beschreibung | +
$user_fields['beruf']['min'] |
+Geben Sie hier an, wie lang der vom Benutzer eingebene Wert mindestens sein muss | +
$user_fields['beruf']['max'] |
+Geben Sie hier an, wie lang der vom Benutzer eingebene Wert höchstens sein darf | +
$user_fields['beruf']['required'] |
+Geben Sie hier den Wert 1 an, wenn das Formularfeld ausgefüllt sein muss. Wenn Sie hier eine 0 oder die Option weglassen, ist das Feld optional. | +
$user_fields['beruf']['regex'] |
+Geben Sie hier einen Perl-kompatiblen regulären Ausdruck zur Prüfung des Wertes ein. Der Ausdruck wird direkt an preg_match() weitergegeben. |
+
$user_fields['beruf']['check'] |
+Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, durch die der Wert geprüft werden soll. Das erste und einzige Argument der Funktion ist der Inhalt des Formularfeldes. Die Funktion muss true zurückgeben, wenn der Wert in Ordnung ist, ansonsten false. |
+
Weiterhin müssen Sie noch diverse Fehlermeldungen definieren (als Unter-Array). Das Definieren dieser Fehlermeldungen ist Pflicht (Sie müssen jedoch nur die Fehlermeldungen zu den Dingen definieren, die auch wirklich geprüft werden).
+ +| Einstellung | +Beschreibung | +
$user_fields['beruf']['errors']['too_short'] |
+Der vom Benutzer eingegebene Wert ist nicht lang genug | +
$user_fields['beruf']['errors']['too_long'] |
+Der vom Benutzer eingegebene Wert ist zu lang | +
$user_fields['beruf']['errors']['not_set'] |
+Das Formularfeld ist ein Pflichtfeld und es wurde nicht ausgefüllt. | +
$user_fields['beruf']['errors']['match_fail'] |
+Die Überprüfung des Wertes durch den regulären Ausdruck ist fehlgeschlagen. | +
$user_fields['beruf']['errors']['check_fail'] |
+Die Überprüfung des Wertes durch die PHP-Funktion ist fehlgeschlagen. | +
Zusätzlich sind noch die folgenden Einstellungen möglich:
+ +| Einstellung | +Beschreibung | +
$user_fields['beruf']['prepare'] |
+Geben Sie hier eine selbst definierte PHP-Funktion (als Zeichenkette) an, die den Wert des Formularfeldes nach den Prüfungen noch verändern (bspw. kann man hier Funktionen angeben, die alle Buchstaben in Großbuchstaben umwandelt). Das erste und einzige Argument der Funktion ist der Inhalt des Formularfeldes. Die Funktion muss den bearbeiteten Wert zurückgeben. | +
$user_fields['beruf']['tpl_var'] |
+Geben Sie hier die Template-Variable an, die in den Templates durch den Wert des Formularfeldes ersetzt werden soll. Wenn Sie hier nichts angeben, wird ein Standardwert verwendet (im Fall des Formularfeldes beruf wäre das dann USER_beruf). |
+
Sie müssen die individuellen Formularfelder nun noch in Ihrem Mail-Formular und in den Templates ergänzen.
+ +Es folgt Beispiel-Konfiguration für ein Formularfeld namens beruf:
+ +
+$user_fields['beruf']['min'] = 5;
+$user_fields['beruf']['max'] = 10;
+$user_fields['beruf']['required'] = 1;
+$user_fields['beruf']['regex'] = '/^[A-Za-z]+$/';
+$user_fields['beruf']['check'] = 'check_beruf';
+$user_fields['beruf']['prepare'] = 'prepare_beruf';
+$user_fields['beruf']['tpl_var'] = 'BERUF';
+
+$user_fields['beruf']['errors']['too_short'] = 'Der Beruf muss mind. 5 Zeichen lang sein!';
+$user_fields['beruf']['errors']['too_long'] = 'Der Beruf darf höchstens 10 Zeichen lang sein!';
+$user_fields['beruf']['errors']['not_set'] = 'Sie haben keinen Beruf eingegeben!';
+$user_fields['beruf']['errors']['match_fail'] = 'Der Beruf darf nur aus Buchstaben bestehen!';
+$user_fields['beruf']['errors']['check_fail'] = 'Der Beruf sollte keine äöü haben!';
+
+# Beispiel-Check-Funktion
+
+function check_beruf($content) {
+ if(strpos($content,'ä') !== false) return false;
+ if(strpos($content,'ö') !== false) return false;
+ if(strpos($content,'ü') !== false) return false;
+
+ return true;
+}
+
+# Beispiel-Vorbereitungs-Funktion
+
+function prepare_beruf($content) {
+ return strtolower($content);
+}
+
+
+Das Formularfeld hat die folgenden Eigenschaften:
+ +min und max)required)regex)check_beruf() wird verhindert, dass ä, ö und ü angegeben werden (das wird natürlich auch durch den regulären Ausdruck ausgeschlossen, es soll lediglich zur Verdeutlichung dienen)prepare_beruf() werden alle Großbuchstaben in Kleinbuchstaben umgewandelt{BERUF} durch den Inhalt des Formularfeldes ersetzt (tpl_var)tpl_var angegeben haben) verwenden.$allowed_envs.
@@ -534,6 +690,8 @@ Der eingegebene Mail-Text
tpl_var angegeben haben) verwenden.
tpl_var angegeben haben) verwenden.{ELSE}-Teil ist optional):{IF CAPTCHA}Captchas sind aktiviert{ELSE}Captchas sind nicht aktiviert{ENDIF}