X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/5224fe74fba39cf1553cae3e423bb6677b08f378..54ca413ee15aeaa674b28f42344116db4d05174b:/readme.htm diff --git a/readme.htm b/readme.htm index 910fd6c..804a234 100644 --- a/readme.htm +++ b/readme.htm @@ -171,8 +171,8 @@ Weiterhin ist noch ein Feld namens recipient möglich. Dieses Feld en $aliases Hier können Sie eine Alias-Namen für Empfänger angeben. Soll einem Alias mehrere Empfänger zugeordnet werden, gilt dasselbe wie für $mailto.
Die Aliase werden mit Hilfe eines assoziativen PHP-Arrays definiert. Da es wohl einige gibt, die von so etwas keine Ahnung haben und ich es nicht gut erklären kann, hier ein Beispiel:

-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') @@ -272,7 +272,7 @@ Beispiel: array('HTTP_USER_AGENT','REMOTE_ADDR') $referer_ok -Geben Sie hier die Hosts an, von denen Form E-Mail aus aufgerufen werden darf (zum Beispiel www.IhreDomain.xyz). Trennen Sie mehrere Hosts durch Semikolons.
+Geben Sie hier die Hosts an, von denen Form E-Mail aus aufgerufen werden darf (zum Beispiel www.example.com). Trennen Sie mehrere Hosts durch Semikolons.
Achtung: Mit einer Referer-Prüfung kann man zwar unbedarfte Anwender abschrecken, aber wirklich zuverlässig ist diese Methode nicht, da sich der Referer fälschen lässt oder auch komplett fehlen kann. @@ -507,36 +507,71 @@ Wie Form E-Mail diese Formularfelder behandelt, wird über verschiede $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. -
-$user_fields['beruf']['prepare'] = 'prepare_beruf';
-$user_fields['beruf']['tpl_var'] = 'BERUF';
+
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).

 
-$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!';
-
+ + + + + + + + + + + + + + + + + + + + + + + + + +
EinstellungBeschreibung
$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:

+ + + + + + + + + + + + + + +
EinstellungBeschreibung
$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).
$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).

Nach oben

@@ -566,6 +601,7 @@ Die Fehlermeldung mail.txt Legt das Aussehen der Mail fest + -Zusätzlich können Sie hier durch Variablen, die mit ENV_ beginnen, Server-Umgebungsvariablen im Text einfügen (siehe auch Konfigurationsvariable $allowed_envs. +Zusätzlich können Sie hier durch Variablen, die mit ENV_ beginnen, Server-Umgebungsvariablen im Text einfügen (siehe auch Konfigurationsvariable $allowed_envs.
+
+!!!TODO: Individuelle Formularfelder!!! sent.htm Wird angezeigt, wenn die Mail erfolgreich versendet wurde + +!!!TODO: Individuelle Formularfelder!!! user_error.htm Wird angezeigt, wenn der Benutzer einen Fehler gemacht hat, der sich aber noch beheben lässt (zum Beispiel wenn ein Formularfeld nicht ausgefüllt wurde) +