X-Git-Url: https://git.p6c8.net/form-email.git/blobdiff_plain/7c32bd0e4e2a03f33abbd4168bb8358513312fde..27560e4c6034a1cc4454ddf14ac9add602b5e284:/readme.htm?ds=sidebyside diff --git a/readme.htm b/readme.htm index 65e49fe..a205582 100644 --- a/readme.htm +++ b/readme.htm @@ -65,6 +65,14 @@ p padding-left: 0.5cm; padding-right: 0.5cm; } +pre +{ + padding-left: 0.5cm; + padding-right: 0.5cm; + font-family: 'Courier New', Courier, monospace; + font-size: 10pt; + color: #0000B0; +} table { font-size: 10pt; @@ -484,6 +492,85 @@ Beispiel: array('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!):

+ + + + + + + + + + + + + + + + + + + + + + + + + + +
EinstellungBeschreibung
$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.
+ + + + + + + + + + + + + + + + + + + + + + + + + + +
EinstellungBeschreibung
$user_fields['beruf']['errors']['too_short']
$user_fields['beruf']['errors']['too_long']
$user_fields['beruf']['errors']['not_set']
$user_fields['beruf']['errors']['match_fail']
$user_fields['beruf']['errors']['check_fail']
+ + + + + + + + + + + + + + + +
EinstellungBeschreibung
$user_fields['beruf']['prepare']
$user_fields['beruf']['tpl_var']
+ +

Nach oben

Templates anpassen