EFG: Unterschied zwischen den Versionen
Aus Contao Community Documentation
(→Funktionsweise und Erläuterungen) |
(→Bestätigungs-Email) |
||
| Zeile 48: | Zeile 48: | ||
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung. | Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung. | ||
| − | + | * Bestätigung per Email versenden: | |
| + | Nur wenn diese Option gewählt ist, wird eine Bestätigungs-Email versendet und es stehen die weiteren Felder zur Verfügung: | ||
| − | + | * Formularfeld der Empfänger-Emailadresse: | |
| + | Hier muß das Formularfeld gewählt werden, das die Email-Adresse des Frontend-Benutzers/Seitenbesuchers enthält | ||
| − | + | * Absender: | |
| + | Die Email-Adresse, die als Absender der Bestätigungs-Mail verwendet wird | ||
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-Email" | Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-Email" | ||
| − | + | * Betreff: | |
| + | Die Betreffzeile der Bestätigungs-Mail | ||
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-Email" | Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-Email" | ||
| − | + | * Text der Bestätigungs-Email: | |
| + | Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe <http://www.typolight.org/wiki/german:inserttags> ) zur Ausgabe von Datum o.ä. eingesetzt werden.\\ Weiterhin können die per Formular übermittelten Daten | ||
mit Insert-Tags der Form <nowiki>{{form::FELDNAME}}</nowiki> im Text eingesetzt werden.\\ FELDNAME steht hierbei für den "Feldname", der im Formular-Generator für das jeweilige Formularfeld eingetragen wurde.\\ Enthält das Formular z.B. ein Feld mit Feldname "user_name", so wird das Insert Tag <nowiki>{{form::user_name}}</nowiki> im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt.\\ | mit Insert-Tags der Form <nowiki>{{form::FELDNAME}}</nowiki> im Text eingesetzt werden.\\ FELDNAME steht hierbei für den "Feldname", der im Formular-Generator für das jeweilige Formularfeld eingetragen wurde.\\ Enthält das Formular z.B. ein Feld mit Feldname "user_name", so wird das Insert Tag <nowiki>{{form::user_name}}</nowiki> im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt.\\ | ||
Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form <nowiki>{{form::FELDNAME?attachement=true}}</nowiki> | Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form <nowiki>{{form::FELDNAME?attachement=true}}</nowiki> | ||
Version vom 11. März 2011, 21:03 Uhr
 |
Unvollständiger Artikel: dieser Artikel ist noch nicht sauber bearbeitet.
Bitte erweitere ihn und entferne erst anschliessend diesen Hinweis. |
| betrifft | |
|---|---|
| Contao Version | 2.9 |
EFG (Extended Form Generator) - Entwickler Thomas Kuhn
Übertrag Handbuch EFG aus altem Wiki
Inhaltsverzeichnis
Was ist und was bietet EFG?
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.
A - Bestätigung per Email
Contao bietet die Möglichkeit, nach Absenden eines Formulars im Frontend auf eine "Danke-Seite" weiterzuleiten, sowie eine E-Mail mit den übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Diese kann optional als Kopie auch an den Absender des Formulars geschickt werden.
EFG bietet darüberhinaus die Möglichkeit, eine E-Mail mit beliebigem Text-Inhalt an den Formular-Absender zu senden. Der Text und Betreff kann durch den Einsatz von "Insert-Tags" personalisiert werden.
Ab v1.8 können die "Insert-Tags" (wie in der Bestätigungs-Mail) auch auf der Bestätigungs-Seite verwendet werden.
B - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen
EFG bietet im Formular-Generator eine weitere Option "Daten im Backend-Modul speichern".
Bei gewählter Option werden Backend-Module erzeugt, in denen die aus Frontend-Formularen eingehenden Daten verwaltet werden können. Es ist ebenso möglich, neue Datensätze direkt im Backend anzulegen - auch ohne veröffentlichtes Frontend-Formular. Dadurch können nahezu beliebige Backend-Module/-Tabellen erstellt werden, einfach durch Anlegen eines Fomulars mit den benötigten Feldern. Manuelles Anlegen von Datenbank-Tabellen ist nicht erforderlich.
Zur Ausgabe und Bearbeitung der "Formular-Daten" im Frontend (mit Listen- und Detailansicht sowie Suche) steht letztlich noch ein spezielles Listing-Modul zur Verfügung.
C - zusätzliche Formularfeld-Typen
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
- Select-Menü (DB)
- Radio-Button-Menü (DB) und
- Checkbox-Menü (DB)
Die im Frontend-Formular verfügbaren Optionen dieser Formular-Elemente werden aus beliebigen TL-Datenbank-Tabellen generiert (Angabe der Tabelle, des anzuzeigenden Feldes sowie optionaler Einschränkung zur Filterung der Werte)
Dieser Feld-Typ erzeugt im Frontend-Formular eine Bilder-Galerie, ergänzt um Radio-Buttons zur Auswahl eines Bildes.
Funktionsweise und Erläuterungen
* A - Bestätigungs-Email
Bestätigungs-Email
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.
- Bestätigung per Email versenden:
Nur wenn diese Option gewählt ist, wird eine Bestätigungs-Email versendet und es stehen die weiteren Felder zur Verfügung:
- Formularfeld der Empfänger-Emailadresse:
Hier muß das Formularfeld gewählt werden, das die Email-Adresse des Frontend-Benutzers/Seitenbesuchers enthält
- Absender:
Die Email-Adresse, die als Absender der Bestätigungs-Mail verwendet wird Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-Email"
- Betreff:
Die Betreffzeile der Bestätigungs-Mail Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-Email"
- Text der Bestätigungs-Email:
Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe <http://www.typolight.org/wiki/german:inserttags> ) zur Ausgabe von Datum o.ä. eingesetzt werden.\\ Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form {{form::FELDNAME}} im Text eingesetzt werden.\\ FELDNAME steht hierbei für den "Feldname", der im Formular-Generator für das jeweilige Formularfeld eingetragen wurde.\\ Enthält das Formular z.B. ein Feld mit Feldname "user_name", so wird das Insert Tag {{form::user_name}} im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt.\\ Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form {{form::FELDNAME?attachement=true}}
- HTML-Vorlage für die Bestätigungs-Email:**\\ Falls die Bestätigungs-Email als HTML-Mail (bzw. als Multipart, sowohl Text- als auch HTML-Version) versendet werden soll, kann hier aus dem Dateisystem eine HTML-Datei gewählt werden.\\ Mit der Installation dieser Extension wird im Ordner "example_confirmation_mail" ein einfaches Beispiel für Testzwecke bereitgestellt. Die Verwendung der Insert-Tags ist auch in der HTML-Vorlage möglich.
Vorlage:Extensions:efg form options1 de.png
* B - Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen
Lizenz
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).
Autor
Thomas Kuhn
--Planepix 19:52, 9. Mär. 2011 (CET)
