readme.htm

   1 <?xml version="1.0" encoding="iso-8859-1" ?>
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
   3 "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
   4
   5 <html xmlns="http://www.w3.org/1999/xhtml">
   6 <head>
   7 <title>ReadMe f&uuml;r Form E-Mail&nbsp;3.5</title>
   8 <meta name="author" content="Patrick Canterino" />
   9 <style type="text/css">
  10 <!--
  11 .upanddown
  12 {
  13  font-size: 8pt;
  14  background-color: #E8E8E8;
  15  padding: 3px;
  16  margin-left: 0.5cm;
  17  margin-right: 0.5cm;
  18  white-space: nowrap;
  19 }
  20 a:link, a:visited, a:active, a:focus
  21 {
  22  font-weight: normal;
  23  text-decoration: none;
  24  color: #0000FF;
  25  cursor: hand;
  26 }
  27 a:link:hover, a:visited:hover, a:active:hover, a:focus:hover
  28 {
  29  font-weight: normal;
  30  text-decoration: underline;
  31  color: #0000FF;
  32  cursor: hand;
  33 }
  34 body
  35 {
  36  font-family: Verdana, Tahoma, Arial, Helvetica, sans-serif;
  37  font-size: 10pt;
  38  color: #000000;
  39  background-color: #FFFFFF;
  40 }
  41 code
  42 {
  43  font-family: 'Courier New', Courier, monospace;
  44  font-size: 10pt;
  45  color: #0000B0;
  46 }
  47 h1
  48 {
  49  font-size: 18pt;
  50  font-weight: bold;
  51 }
  52 h2
  53 {
  54  font-size: 13pt;
  55  font-weight: bold;
  56  padding-left: 0.2cm;
  57  padding-right: 0.2cm;
  58 }
  59 li
  60 {
  61  margin-top: 3px;
  62 }
  63 p
  64 {
  65  padding-left: 0.5cm;
  66  padding-right: 0.5cm;
  67 }
  68 table
  69 {
  70  font-size: 10pt;
  71  margin-left: 0.5cm;
  72  margin-right: 0.5cm;
  73 }
  74 td
  75 {
  76  vertical-align: top;
  77 }
  78 ul
  79 {
  80  padding-left: 0.5cm;
  81  padding-right: 0.5cm;
  82  margin-left: 1cm;
  83 }
  84 -->
  85 </style>
  86 <base target="_self" />
  87 </head>
  88 <body bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#0000FF" alink="#0000FF">
  89
  90 <h1><a name="top" id="top">ReadMe f&uuml;r Form E-Mail&nbsp;3.5</a></h1>
  91
  92 <p>
  93 <a href="#wasistfeml">Was ist <i>Form E-Mail</i>?</a><br />
  94 <a href="#einrichten">Einrichten von <i>Form E-Mail</i></a><br />
  95 <a href="#einstellungen">Einstellungen</a><br />
  96 <a href="#templates">Templates anpassen</a>
  97 </p>
  98
  99 <h2><a name="wasistfeml" id="wasistfeml">Was ist <i>Form E-Mail</i>?</a></h2>
 100
 101 <p><i>Form E-Mail</i> ist ein in PHP programmierter Form-Mailer, der speziell darauf ausgerichtet ist, ein Kontaktformular zu verarbeiten. Unter Kontaktformular verstehe ich ein Formular mit Feldern f&uuml;r Name und E-Mail-Adresse des Absenders, eines f&uuml;r den Betreff und ein weiteres f&uuml;r den Text der Mail.<br />
 102 Auf diese Weise m&uuml;ssen Sie zum Beispiel nicht &uuml;berall auf Ihrer Homepage Ihre E-Mail-Adresse angeben und sie so nicht der Gefahr aussetzen, ein Opfer von Spammern zu werden.</p>
 103
 104 <p class="upanddown"><a href="#top">Nach oben</a></p>
 105
 106 <h2><a name="einrichten" id="einrichten">Einrichten von <i>Form E-Mail</i></a></h2>
 107
 108 <p>Sie brauchen als erstes ein HTML-Formular. Dieses muss mindestens diese Felder enthalten:</p>
 109
 110 <table border="1">
 111 <tr>
 112 <td><b>Feldname</b></td>
 113 <td><b>Zweck</b></td>
 114 </tr>
 115 <tr>
 116 <td><i>email</i></td>
 117 <td>E-Mail-Adresse des Absenders</td>
 118 </tr>
 119 <tr>
 120 <td><i>name</i></td>
 121 <td>Name des Absenders</td>
 122 </tr>
 123 <tr>
 124 <td><i>text</i></td>
 125 <td>Text der E-Mail</td>
 126 </tr>
 127 </table>
 128
 129 <p>Sie k&ouml;nnen au&szlig;erdem noch ein Feld namens <i>subject</i> anlegen. Hier kann ein Betreff f&uuml;r die Mail eingegeben werden. Wenn Sie auf dieses Feld verzichten, erhalten die E-Mails automatisch den in <code>$default_subject</code> definierten Betreff (s.u.).<br />
 130 Weiterhin ist noch ein Feld namens <i>recipient</i> m&ouml;glich. Dieses Feld enth&auml;lt einen Alias-Empf&auml;nger. Wie das funktioniert, k&ouml;nnen Sie bei der Beschreibung der Einstellung <code>$aliases</code> lesen.</p>
 131
 132 <p>Wenn Sie Captchas (zuf&auml;llige Zeichenfolgen, die der Benutzer vor dem Absenden des Formulars eingeben muss, um Spambots auszuschlie&szlig;en) benutzen wollen (siehe unten), m&uuml;ssen Sie im Formular die Datei <i>captcha.php</i> als Bild einbinden (<code>&lt;img&gt;</code>-Tag). Bedenken Sie, dass Sie diese Datei auch in den <a href="#templates">Templates</a> einbinden m&uuml;ssen!</p>
 133
 134 <p>Das Formular muss dann noch mit <tt>POST</tt> die Daten an die Datei <i>mailer.php</i> (oder wie Sie die Datei genannt haben) senden.</p>
 135
 136 <p>Ein beispielhaftes Formular finden Sie in der Datei <a href="formular.htm" target="_blank"><i>formular.htm</i></a>.</p>
 137
 138 <p>Die Adresse, an der die mit <i>Form E-Mail</i> erzeugte Mail gesendet werden soll, wird in der Datei <i>config.php</i> festgelegt. &Ouml;ffnen Sie die Datei mit einem beliebigen Editor und suchen Sie nach dieser Zeile:</p>
 139
 140 <p><code>$mailto = '';</code></p>
 141
 142 <p>Geben Sie zwischen den einfachen Anf&uuml;hrungszeichen die Adresse an, an die die Mail gehen soll. Wenn die Mail an mehrere Empf&auml;nger gehen soll, so trennen Sie die einzelnen E-Mail-Adressen ganz einfach durch Semikolons.</p>
 143
 144 <p>Das war es im Grunde genommen. Aber <i>Form E-Mail</i> l&auml;sst sich noch weiter konfigurieren. Mehr dazu finden Sie in den n&auml;chsten beiden Abschnitten.</p>
 145
 146 <p class="upanddown"><a href="#top">Nach oben</a></p>
 147
 148 <h2><a name="einstellungen" id="einstellungen">Einstellungen</a></h2>
 149
 150 <p><b>Empf&auml;nger</b></p>
 151
 152 <table border="1">
 153 <tr>
 154 <td><b>Einstellung</b></td>
 155 <td><b>Beschreibung</b></td>
 156 </tr>
 157 <tr>
 158 <td><code>$mailto</code></td>
 159 <td>siehe oben</td>
 160 </tr>
 161 <tr>
 162 <td><code>$aliases</code></td>
 163 <td>Hier k&ouml;nnen Sie eine Alias-Namen f&uuml;r Empf&auml;nger angeben. Soll einem Alias mehrere Empf&auml;nger zugeordnet werden, gilt dasselbe wie f&uuml;r <code>$mailto</code>.<br />
 164 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&auml;ren kann, hier ein Beispiel:<br /><br />
 165 <code>array('info' =&gt; 'info@IhreDomain.xyz', 'support' =&gt; 'support@IhreDomain.xyz',<br />
 166 &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;'alle' =&gt; 'info@IhreDomain.xyz; support@IhreDomain.xyz')</code></td>
 167 </tr>
 168 </table>
 169
 170 <p><b>Allgemeines</b></p>
 171
 172 <table border="1">
 173 <tr>
 174 <td><b>Einstellung</b></td>
 175 <td><b>Beschreibung</b></td>
 176 </tr>
 177 <tr>
 178 <td><code>$default_subject</code></td>
 179 <td>Der Standard-Betreff. Dieser wird verwendet, wenn der Benutzer keinen Betreff f&uuml;r seine Mail angegeben hat.</td>
 180 </tr>
 181 <tr>
 182 <td><code>$friendly_sender</code></td>
 183 <td>Wenn 1, wird die E-Mail-Adresse des Autors der Mail als Absender angegeben. Bei 0 erscheint das, was der Server als Absender eintr&auml;gt. Wenn 2, wird zus&auml;tzlich noch der Name als Absender angegeben.<br />
 184 Bitte setzen Sie diese Option nur auf 0, wenn es wirklich sein muss!</td>
 185 </tr>
 186 <tr>
 187 <td><code>$line_break</code></td>
 188 <td>Legt fest, ab wievielen Zeichen ein automatischer Zeilenumbruch durchgef&uuml;hrt werden soll (0 f&uuml;r keine Zeilenumbr&uuml;che).</td>
 189 </tr>
 190 <tr>
 191 <td><code>$add_header</code></td>
 192 <td>Legt beim Wert&nbsp;1 fest, ob <i>Form E-Mail</i> Informationen zur Zeichencodierung, MIME-Version usw. in den Mail-Header schreiben soll.<br />
 193 Bitte setzen Sie diese Option nur auf 0, wenn es wirklich sein muss!</td>
 194 </tr>
 195 <tr>
 196 <td><code>$timeformat</code></td>
 197 <td>Legt das Aussehen der Zeitangaben der Mail fest. Was hier alles m&ouml;glich ist, finden Sie im PHP-Handbuch bei der <a href="http://www.php.net/manual/de/function.strftime.php">Beschreibung zu <code>strftime()</code></a>.<br />
 198 Beachten Sie bitte, dass bei neueren PHP-Versionen, trotz deutscher Spracheinstellungen, die Namen von Wochentagen und Monaten englisch dargestellt werden. Es handelt sich hierbei aber um ein allgemeines Problem.</td>
 199 </tr>
 200 <tr>
 201 <td><code>$return_url</code></td>
 202 <td>Geben Sie hier die URL einer Seite an, auf die nach dem erfolgreichen Versenden einer Mail weitergeleitet werden soll. Wenn Sie hier nichts angeben, wird eine per Template formatierte Seite angezeigt.<br />
 203 <b style="color:#FF0000">Achtung:</b> Benutzen Sie hier nach M&ouml;glichkeit absolute URLs! Ich habe zwar etwas eingebaut, was hier relative URLs in absolute umwandelt, um dem HTTP-Standard gerecht zu werden, aber ich garantiere nicht, dass diese Umwandlung immer einwandfrei funktioniert. Seien Sie bei relativen URLs also sehr vorsichtig und verwenden Sie im Fehlerfall absolute.</td>
 204 </tr>
 205 <tr>
 206 <td><code>$no_tld</code></td>
 207 <td>Setzen Sie diese Option auf 1, wenn der Absender auch E-Mail-Adressen ohne Top-Level-Domain angeben darf.</td>
 208 </tr>
 209 <tr>
 210 <td><code>$allowed_envs</code></td>
 211 <td>Geben Sie hier die Server-Umgebungsvariablen, die im Mailtext angezeigt werden d&uuml;rfen, als normales PHP-Array an (siehe auch die Erl&auml;uterungen zur Template-Datei <i>mail.txt</i>).<br />
 212 Beispiel: <code>array('HTTP_USER_AGENT','REMOTE_ADDR')</code></td>
 213 </tr>
 214 <tr>
 215 <td><code>$charset</code></td>
 216 <td>Geben Sie hier den Zeichensatz, der f&uuml;r die E-Mail verwendet werden soll, an.</td>
 217 </tr>
 218 <tr>
 219 <td><code>$timezone</code></td>
 220 <td>Geben Sie hier Ihre Zeitzone an (dies ist bei neueren PHP-Versionen n&ouml;tig, da ansonsten eine Fehlermeldung auftreten kann).</td>
 221 </tr>
 222 </table>
 223
 224 <p><b>L&auml;ngen&uuml;berpr&uuml;fungen</b></p>
 225
 226 <table border="1">
 227 <tr>
 228 <td><b>Einstellung</b></td>
 229 <td><b>Beschreibung</b></td>
 230 </tr>
 231 <tr>
 232 <td><code>$name_min</code></td>
 233 <td>Geben Sie hier an, wie lang der vom Benutzer eingebene Name mindestens sein muss (0 =&nbsp;beliebig lang)</td>
 234 </tr>
 235 <tr>
 236 <td><code>$subject_min</code></td>
 237 <td>Geben Sie hier an, wie lang der vom Benutzer eingebene Betreff mindestens sein muss (0 =&nbsp;beliebig lang)</td>
 238 </tr>
 239 <tr>
 240 <td><code>$text_min</code></td>
 241 <td>Geben Sie hier an, wie lang der vom Benutzer eingebene Text mindestens sein muss (0 =&nbsp;beliebig lang)</td>
 242 </tr>
 243 <tr>
 244 <td><code>$name_max</code></td>
 245 <td>Geben Sie hier an, wie lang der vom Benutzer eingebene Name h&ouml;chstens sein darf (0 =&nbsp;beliebig lang)</td>
 246 </tr>
 247 <tr>
 248 <td><code>$subject_max</code></td>
 249 <td>Geben Sie hier an, wie lang der vom Benutzer eingebene Betreff h&ouml;chstens sein darf (0 =&nbsp;beliebig lang)</td>
 250 </tr>
 251 <tr>
 252 <td><code>$text_max</code></td>
 253 <td>Geben Sie hier an, wie lang der vom Benutzer eingebene Text h&ouml;chstens sein darf (0 =&nbsp;beliebig lang)</td>
 254 </tr>
 255 </table>
 256
 257 <p><b>Sicherheit</b></p>
 258
 259 <table border="1">
 260 <tr>
 261 <td><b>Einstellung</b></td>
 262 <td><b>Beschreibung</b></td>
 263 </tr>
 264 <tr>
 265 <td><code>$check_referer</code></td>
 266 <td>Wenn &gt; 0, &uuml;berpr&uuml;ft <i>Form E-Mail</i> die Host-Angabe im HTTP-Referer. Das ist n&uuml;tzlich, wenn Sie verhindern wollen, dass irgendjemand Ihr Script f&uuml;r sich ausnutzt.</td>
 267 </tr>
 268 <tr>
 269 <td><code>$referer_ok</code></td>
 270 <td>Geben Sie hier die Hosts an, von denen <i>Form E-Mail</i> aus aufgerufen werden darf (zum Beispiel <i>www.IhreDomain.xyz</i>). Trennen Sie mehrere Hosts durch Semikolons.<br />
 271 <b style="color:#FF0000">Achtung:</b> Mit einer Referer-Pr&uuml;fung kann man zwar unbedarfte Anwender abschrecken, aber wirklich zuverl&auml;ssig ist diese Methode nicht, da sich der Referer f&auml;lschen l&auml;sst oder auch komplett fehlen kann.</td>
 272 </tr>
 273 </table>
 274
 275 <p><b>Captchas</b></p>
 276
 277 <table border="1">
 278 <tr>
 279 <td><b>Einstellung</b></td>
 280 <td><b>Beschreibung</b></td>
 281 </tr>
 282 <tr>
 283 <td><code>$captcha_enable</code></td>
 284 <td>Wenn &gt; 0, wird die Captcha-&Uuml;berpr&uuml;fung aktiviert.</td>
 285 </tr>
 286 <tr>
 287 <td><code>$captcha_case</code></td>
 288 <td>Wenn 1, wird bei Captchas auf Gro&szlig;- und Kleinschreibung geachtet. Beachten Sie bitte, dass bei deaktiverter Einstellung im Captcha selbst immer noch Gro&szlig;- und Kleinbuchstaben angezeigt werden - lediglich bei der Auswertung wird die Gro&szlig;- und Kleinschreibung nicht ber&uuml;cksichtigt.</td>
 289 </tr>
 290 <tr>
 291 <td><code>$captcha_max</code></td>
 292 <td>Wenn &gt; 0, ist nur eine bestimmte Anzahl von Fehlversuchen bei der Eingabe des Captcha-Texts m&ouml;glich.</td>
 293 </tr>
 294 <tr>
 295 <td><code>$captcha_length</code></td>
 296 <td>Geben Sie hier die L&auml;nge des Captcha-Textes an.</td>
 297 </tr>
 298 <tr>
 299 <td><code>$captcha_width</code></td>
 300 <td>Geben Sie hier die Breite des Captcha-Bilds an (in Pixeln). Dieser Wert wird &uuml;berschrieben, wenn <code>$captcha_image_bg</code> gesetzt ist.</td>
 301 </tr>
 302 <tr>
 303 <td><code>$captcha_height</code></td>
 304 <td>Geben Sie hier die H&ouml;he des Captcha-Bilds an (in Pixeln). Dieser Wert wird &uuml;berschrieben, wenn <code>$captcha_image_bg</code> gesetzt ist.</td>
 305 </tr>
 306 <tr>
 307 <td><code>$captcha_angle</code></td>
 308 <td>Geben Sie hier den Winkel-Bereich an, in dem der Captcha-Text ausgerichtet werden soll. Es wird ein zuf&auml;lliger Wert aus diesem Bereich ausgew&auml;hlt.</td>
 309 </tr>
 310 <tr>
 311 <td><code>$captcha_x</code></td>
 312 <td>Geben Sie hier den Bereich an, in dem sich der horizontale Startpunkt des Captcha-Texts befinden soll. Es wird ein zuf&auml;lliger Wert aus diesem Bereich ausgew&auml;hlt.</td>
 313 </tr>
 314 <tr>
 315 <td><code>$captcha_y</code></td>
 316 <td>Geben Sie hier den Bereich an, in dem sich der vertikale Startpunkt des Captcha-Texts befinden soll. Es wird ein zuf&auml;lliger Wert aus diesem Bereich ausgew&auml;hlt.</td>
 317 </tr>
 318 <tr>
 319 <td><code>$captcha_possible</code></td>
 320 <td>Geben Sie hier die m&ouml;glichen Zeichen des Captcha-Texts an. Standardm&auml;&szlig;ig vorgegeben ist <i>'ABCDEFGHJKLMNPRSTUVWXYZabcdefghijkmnpqrstuvwxyz23456789'</i>.</td>
 321 </tr>
 322 <tr>
 323 <td><code>$captcha_font</code></td>
 324 <td>Schriftart f&uuml;r den Captcha-Text. Geben Sie hier den Pfad zu einer <i>.ttf</i>-Datei an. Standardm&auml;&szlig;ig ist hier die mitgelieferte <i>XFILES.TTF</i> angegeben.</td>
 325 </tr>
 326 <tr>
 327 <td><code>$captcha_font_size</code></td>
 328 <td>Geben Sie hier die Schriftgr&ouml;&szlig;e des Captcha-Textes an.</td>
 329 </tr>
 330 <tr>
 331 <td><code>$captcha_lines</code></td>
 332 <td>Wenn &gt; 0, werden zuf&auml;llige St&ouml;rlinien in das Captcha-Bild eingef&uuml;gt.</td>
 333 </tr>
 334 <tr>
 335 <td><code>$captcha_color_bg</code></td>
 336 <td>Geben Sie hier die RGB-Werte (in Form eines PHP-Arrays) der Hintergrundfarbe des Captcha-Bilds an.</td>
 337 </tr>
 338 <tr>
 339 <td><code>$captcha_color_text</code></td>
 340 <td>Geben Sie hier die RGB-Werte (in Form eines PHP-Arrays) der Textfarbe des Captcha-Bilds an.</td>
 341 </tr>
 342 <tr>
 343 <td><code>$captcha_image_bg</code></td>
 344 <td>Hier k&ouml;nnen Sie, wenn Sie m&ouml;chten, ein Hintergrundbild f&uuml;r das Captcha-Bild angeben. Diese Option &uuml;berschreibt <code>$captcha_length</code> und <code>$captcha_height</code> mit den Angaben aus dem Bild.</td>
 345 </tr>
 346 </table>
 347
 348 <p><b>Fehlermeldungen</b></p>
 349
 350 <table border="1">
 351 <tr>
 352 <td><b>Einstellung</b></td>
 353 <td><b>Beschreibung</b></td>
 354 </tr>
 355 <tr>
 356 <td><code>$err_nothing</code></td>
 357 <td>Der Benutzer hat &uuml;berhaupt nichts eingegeben</td>
 358 </tr>
 359 <tr>
 360 <td><code>$err_no_name</code></td>
 361 <td>Der Benutzer hat keinen Namen angegeben</td>
 362 </tr>
 363 <tr>
 364 <td><code>$err_no_email</code></td>
 365 <td>Der Benutzer hat keine E-Mail-Adresse angegeben</td>
 366 </tr>
 367 <tr>
 368 <td><code>$err_invalid_email</code></td>
 369 <td>Der Benutzer hat eine von der Syntax her ung&uuml;ltige E-Mail-Adresse angegeben</td>
 370 </tr>
 371 <tr>
 372 <td><code>$err_no_text</code></td>
 373 <td>Der Benutzer hat keinen Text angegeben</td>
 374 </tr>
 375 <tr>
 376 <td><code>$err_name_short</code></td>
 377 <td>Der vom Benutzer eingegebene Name ist nicht lang genug</td>
 378 </tr>
 379 <tr>
 380 <td><code>$err_subject_short</code></td>
 381 <td>Der vom Benutzer eingegebene Betreff ist nicht lang genug</td>
 382 </tr>
 383 <tr>
 384 <td><code>$err_text_short</code></td>
 385 <td>Der vom Benutzer eingegebene Text ist nicht lang genug</td>
 386 </tr>
 387 <tr>
 388 <td><code>$err_send_error</code></td>
 389 <td>Die Mail konnte nicht versendet werden</td>
 390 </tr>
 391 <tr>
 392 <td><code>$err_only_post</code></td>
 393 <td><i>Form E-Mail</i> darf nur mit <tt>POST</tt> aufgerufen werden</td>
 394 </tr>
 395 <tr>
 396 <td><code>$err_referer_not_ok</code></td>
 397 <td>Der im HTTP-Referer angegebene Host darf keine Mails &uuml;ber das Script senden</td>
 398 </tr>
 399 <tr>
 400 <td><code>$err_captcha_incorrect</code></td>
 401 <td>Der vom Benutzer eingegebene Captcha-Code ist nicht korrekt</td>
 402 </tr>
 403 <tr>
 404 <td><code>$err_captcha_max</code></td>
 405 <td>Der Benutzer hat den Captcha-Code zu oft falsch eingegeben</td>
 406 </tr>
 407 <tr>
 408 <td><code>$err_captcha_disabled</code></td>
 409 <td>Wird angezeigt, wenn <i>captcha.php</i> aufgerufen wird und Captchas eigentlich deaktiviert sind.</td>
 410 </tr>
 411 <tr>
 412 <td><code>$err_captcha_session_failure</code></td>
 413 <td>Wird angezeigt, wenn keine Session-Variablen gefunden werden konnten.</td>
 414 </tr>
 415 </table>
 416
 417 <p><b>Pfade zu Templates</b></p>
 418
 419 <table border="1">
 420 <tr>
 421 <td><b>Einstellung</b></td>
 422 <td><b>Beschreibung</b></td>
 423 </tr>
 424 <tr>
 425 <td><code>$tpl_mail</code></td>
 426 <td>Template f&uuml;r die Mail</td>
 427 </tr>
 428 <tr>
 429 <td><code>$tpl_sent</code></td>
 430 <td>Die Mail wurde erfolgreich versendet</td>
 431 </tr>
 432 <tr>
 433 <td><code>$tpl_user_error</code></td>
 434 <td>Der Benutzer hat etwas falsch gemacht</td>
 435 </tr>
 436 <tr>
 437 <td><code>$tpl_fatal</code></td>
 438 <td>Es ist ein Fehler aufgetreten, den der Benutzer nicht mehr beheben kann</td>
 439 </tr>
 440 </table>
 441
 442 <p class="upanddown"><a href="#top">Nach oben</a></p>
 443
 444 <h2><a name="templates" id="templates">Templates anpassen</a></h2>
 445
 446 <p>Die Anpassung der Ausgaben von <i>Form E-Mail</i> erfolgt &uuml;ber Templates (englisch f&uuml;r &quot;Vorlagen&quot;). Jede der Templates enth&auml;lt Variablen der Form <b>{VARIABLENNAME}</b>, die dann von <i>Form E-Mail</i> durch entsprechende Daten ersetzt werden.</p>
 447
 448 <p>Hier nun eine Auflistung der einzelnen Templates und der verwendeten Variablen (ohne geschweifte Klammern):</p>
 449
 450 <table border="1">
 451 <tr>
 452 <td width="20%"><b>Datei</b></td>
 453 <td width="40%"><b>Zweck</b></td>
 454 <td width="40%"><b>Verwendete Variablen</b></td>
 455 </tr>
 456 <tr>
 457 <td><i>fatal.htm</i></td>
 458 <td>Wird angezeigt, wenn ein Fehler aufgetreten ist, den der Benutzer nicht mehr beheben kann</td>
 459 <td>
 460 <ul>
 461 <li><b>ERROR</b><br />
 462 Die Fehlermeldung</li>
 463 </ul>
 464 </td>
 465 </tr>
 466 <tr>
 467 <td><i>mail.txt</i></td>
 468 <td>Legt das Aussehen der Mail fest</td>
 469 <td>
 470 <ul>
 471 <li><b>EMAIL</b><br />
 472 Die eingegebene E-Mail-Adresse</li>
 473 <li><b>NAME</b><br />
 474 Der eingegebene Name</li>
 475 <li><b>SUBJECT</b><br />
 476 Der Betreff der Mail</li>
 477 <li><b>TEXT</b><br />
 478 Der eingegebene Mail-Text</li>
 479 <li><b>TIME</b><br />
 480 Die formatierte Zeitangabe</li>
 481 </ul>
 482
 483 Zus&auml;tzlich k&ouml;nnen Sie hier durch Variablen, die mit <b>ENV_</b> beginnen, Server-Umgebungsvariablen im Text einf&uuml;gen (siehe auch Konfigurationsvariable <code>$allowed_envs</code>.
 484 </td>
 485 </tr>
 486 <tr>
 487 <td><i>sent.htm</i></td>
 488 <td>Wird angezeigt, wenn die Mail erfolgreich versendet wurde</td>
 489 <td>
 490 <ul>
 491 <li><b>EMAIL</b><br />
 492 Die eingegebene E-Mail-Adresse</li>
 493 <li><b>MAIL</b><br />
 494 Die komplette Mail, so wie sie versendet wurde (nat&uuml;rlich ohne Header)</li>
 495 <li><b>NAME</b><br />
 496 Der eingegebene Name</li>
 497 <li><b>SUBJECT</b><br />
 498 Der Betreff der Mail</li>
 499 <li><b>TEXT</b><br />
 500 Der eingegebene Mail-Text</li>
 501 <li><b>TIME</b><br />
 502 Die formatierte Zeitangabe</li>
 503 </ul>
 504 </td>
 505 </tr>
 506 <tr>
 507 <td><i>user_error.htm</i></td>
 508 <td>Wird angezeigt, wenn der Benutzer einen Fehler gemacht hat, der sich aber noch beheben l&auml;sst (zum Beispiel wenn ein Formularfeld nicht ausgef&uuml;llt wurde)</td>
 509 <td>
 510 <ul>
 511 <li><b>EMAIL</b><br />
 512 Die eingegebene E-Mail-Adresse</li>
 513 <li><b>ERROR</b><br />
 514 Die Fehlermeldung</li>
 515 <li><b>NAME</b><br />
 516 Der eingegebene Name</li>
 517 <li><b>SUBJECT</b><br />
 518 Der Betreff der Mail</li>
 519 <li><b>TEXT</b><br />
 520 Der eingegebene Mail-Text</li>
 521 </ul>
 522
 523 Zus&auml;tzlich ist es m&ouml;glich, einen Bereich, der nur angezeigt werden soll, wenn Captchas aktiviert sind, anzuzeigen, indem Sie diesen in folgenden Block einschlie&szlig;en (der <code>{ELSE}</code>-Teil ist optional):<br />
 524 <br />
 525 <code>{IF CAPTCHA}Captchas sind aktiviert{ELSE}Captchas sind nicht aktiviert{ENDIF}</code>
 526 </td>
 527 </tr>
 528 </table>
 529
 530 <p>&nbsp;</p>
 531
 532 <hr width="80%" noshade="noshade" />
 533
 534 <p><a href="changes.htm">Versionshistorie</a></p>
 535
 536 <hr width="80%" noshade="noshade" />
 537
 538 <p style="font-size:8pt">&copy;&nbsp;2002-2011 Patrick Canterino</p>
 539
 540 <table border="0" cellspacing="0" style="font-size:8pt">
 541 <tr>
 542 <td>Homepage:</td>
 543 <td><a href="http://www.patshaping.de/" target="_blank">http://www.patshaping.de/</a></td>
 544 </tr>
 545 <tr>
 546 <td><a name="bottom" id="bottom">E-Mail:</a></td>
 547 <td><a href="mailto:patrick@patshaping.de">patrick@patshaping.de</a></td>
 548 </tr>
 549 </table>
 550 </body>
 551 </html>