From 3e2d2f46b42fb471172f2c2383f4676e20007833 Mon Sep 17 00:00:00 2001
From: Patrick Canterino <patrick@patshaping.de>
Date: Mon, 6 Feb 2012 18:45:20 +0000
Subject: [PATCH 1/1] Beispiel-Formularfeld in ReadMe-Datei kopiert und
 erlaeutert

---
 form-email/config.php |  8 ++++----
 readme.htm            | 47 +++++++++++++++++++++++++++++++++++++++++--
 2 files changed, 49 insertions(+), 6 deletions(-)

diff --git a/form-email/config.php b/form-email/config.php
index 3e5a47d..ea1eee0 100644
--- a/form-email/config.php
+++ b/form-email/config.php
@@ -6,7 +6,7 @@
 # Konfiguration fuer Form E-Mail
 #
 # Autor:            Patrick Canterino <patrick@patshaping.de>
-# Letzte Aenderung: 05.02.2012
+# Letzte Aenderung: 06.02.2012
 #
 # Copyright (C) 2002-2012 Patrick Canterino
 #
@@ -82,10 +82,10 @@ $referer_ok    = '';
 
 # Mails speichern
 
-$store_mails = 1;
-$store_mails_dir = 'stored_mails';
+$store_mails        = 1;
+$store_mails_dir    = 'stored_mails';
 $store_mails_prefix = 'feml_';
-$store_mails_max = 10;
+$store_mails_max    = 10;
 
 # Captcha
 
diff --git a/readme.htm b/readme.htm
index 12b8071..5d93757 100644
--- a/readme.htm
+++ b/readme.htm
@@ -67,8 +67,8 @@ p
 }
 pre
 {
- padding-left: 0.5cm;
- padding-right: 0.5cm;
+ padding-left: 0.7cm;
+ padding-right: 0.7cm;
  font-family: 'Courier New', Courier, monospace;
  font-size: 10pt;
  color: #0000B0;
@@ -581,6 +581,49 @@ Wie <i>Form E-Mail</i> diese Formularfelder behandelt, wird &uuml;ber verschiede
 
 <p>Sie m&uuml;ssen die individuellen Formularfelder nun noch in Ihrem Mail-Formular und in den <a href="#templates">Templates</a> erg&auml;nzen.</p>
 
+<p>Es folgt Beispiel-Konfiguration f&uuml;r ein Formularfeld namens <i>beruf</i>:</p>
+
+<pre>
+$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);
+}
+</pre>
+
+<p>Das Formularfeld hat die folgenden Eigenschaften:</p>
+
+<ul>
+<li>Der Beruf muss aus mind. 5 Zeichen und max. 10 Zeichen bestehen (<code>min</code> und <code>max</code>)</li>
+<li>Es sind nur die Buchstaben A-Z (gro&szlig; und klein) erlaubt (<code>regex</code>)</li>
+<li>&Uuml;ber die Pr&uuml;ffunktion <code>check_beruf()</code> wird verhindert, dass &auml;, &ouml; und &uuml; angegeben werden (das wird nat&uuml;rlich auch durch den regul&auml;ren Ausdruck ausgeschlossen, es soll lediglich zur Verdeutlichung dienen)</li>
+<li>Durch die Vorbereitungsfunktion <code>prepare_beruf()</code> werden alle Gro&szlig;buchstaben in Kleinbuchstaben umgewandelt</li>
+</ul>
+
 <p class="upanddown"><a href="#top">Nach oben</a></p>
 
 <h2><a name="templates" id="templates">Templates anpassen</a></h2>
-- 
2.34.1