Contao Community Documentation - Benutzerbeiträge [de]

Easyupdate

2014-10-21T06:16:19Z

Schnaub:

{{stub}}

'''easyUpdate3'''

'''Tickets / Bugs'''
https://github.com/BugBuster1701/privat-easyupdate3.git

{{AppliesTo
|Version=3.2.14
}}

{{ExtInfo
| Dev=Lutz Schoening und Glen Larger
| ExtVersion=3.0.1 stable
| Version=3.0.6 - 3.3.1
| ERLink=https://contao.org/de/extension-list/view/easyupdate3.de.html
}}
[[Kategorie:Installation_und_Updates]]
[[Kategorie:Extensions]]

== Was ist easyUpdate3? ==
easyUpdate3 ist eine Erweiterung um Contao3 mit speziellen ZIP-Dateien aus dem Backend heraus zu aktualisieren

== Funktionsweise und Erläuterungen ==

=== easyUpdate3 installieren ===

Nach der normalen Installation unter Contao erscheint im Backend ein neuer Menüeintrag, links unter System.

[[Datei:Easyupdate_install_0040.png|Installation von easyUpdate, Schritt 1]]

=== Sicherheitshinweise ===

Folgend der Sicherheitshinweis des Autors von "easyUpdate3".
{{Achtung|Hinweistext nach der easyUpdate3 Installation:
Es gibt keine 100%-ige Sicherheit, dass alles einwandfrei funktioniert. Seien Sie sich also bewusst, was Sie tun!
Machen Sie bei der ersten Verwendung dieses Tools ruhig eine zusätzliche Sicherung der Datenbank.
Das Tool greift auf das Dateisystem zu, das kann zu DATENVERLUST führen!
Alles was Sie machen, tun Sie auf eigene Gefahr.}}
Das ist ist sehr guter und richtiger Hinweis, sollte jedoch, beim Einhalten dieser Vorgehensweise, den Anwender nicht Abschrecken "easyUpdate3" zu verwenden

=== Kompatibilität ===

*Getestete und funktionierende Vorgänge:
Getestet wurde eine Installation bis zur Contao Version 3.0.1. ( in der hier dargestellten Fassung auch bis 3.2.14 )

3.0.6 ====> 3.3.1

*Getestete und fehlerhafte Vorgänge:

2.x.x ====> 2.x.x ( Nicht mit Contao 2.x möglich! )

=== Update vorbereiten - ZIP Dateien Downloaden und Ablegen ===

*Download der richtigen ZIP-Dateien

Die entsprechenden ZIP-Dateien finden sich unter folgendem Link:
[http://www.contao.glen-langer.de/ Webseiten von Glen Larger]

Nach dem Download der ZIP-Dateien werden diese über die Dateiverwaltung im Verzeichnis "easyupdate3" abgelegt.

[[Datei:Easyupdate setfolder.png|Backend-Ablage im Verzeichnis]]

=== Update durchführen ===

*Auswahl der Zip-Datei

Durch Klick auf den Menüpunkt "Easyupdate" wird folgendes Dialogfeld angezeigt.

[[Datei:Easyupdate select file.png|Auswahl der ZIP-Datei]]

{{Hinweis| Wenn eine Versionsnummer X.X.X erscheint, dann ist wahrscheinlich die ZIP-Datei beschädigt}}

Nach Auswahl der ZIP-Datei wird mitgeteilt welche Dateien nicht im folgenden Update aktualisiert werden

[[Datei:Easyupdate selectfiles noupdate.png|Anzeige der Dateien die nicht aktualisiert werden]]

Im weiteren Verlauf werden diverse Dialoggrafiken dargestellt, diese werden jeweils mit der Schaltfläche "Nächsten Schritt ausführen" bestätigt.

[[Datei:Easyupdate changelog view.png|Anzeige des Changelog zwischen den Versionen]]

[[Datei:Easyupdate data contant view.png|Anzeige der Inhalte der Archivdatei]]

[[Datei:Easyupdate save data.png|Anzeige der Dateien die gesichert werden]]

=== Update überprüfen - Install-Tool ===

== Autor der Erweiterung eaysupdate3 ==

Glen Larger [[Benutzer:BugBuster|BugBuster]]

== Weiterführende Links ==

[https://contao.org/de/extension-list/view/easyupdate3.de.html easyUpdate3 in der Erweiterungsliste]

[http://www.contao.glen-langer.de Webseite von BugBuster]

[https://community.contao.org/de/showthread.php?1607-easyUpdate-Updates-noch-einfacher&highlight=easyupdate easyUpdate im Contao-Forum]

Datei:Easyupdate setfolder.png

2014-10-21T06:12:49Z

Schnaub: Schnaub lud eine neue Version von „Datei:Easyupdate setfolder.png“ hoch

Datei:Easyupdate select file.png

2014-10-21T06:10:28Z

Schnaub: Schnaub lud eine neue Version von „Datei:Easyupdate select file.png“ hoch

Datei:Easyupdate save data.png

2014-10-21T06:06:32Z

Schnaub:

Datei:Easyupdate data contant view.png

2014-10-21T06:05:22Z

Schnaub:

Datei:Easyupdate changelog view.png

2014-10-21T06:03:01Z

Schnaub:

Datei:Easyupdate selectfiles noupdate.png

2014-10-21T05:53:45Z

Schnaub:

Datei:Easyupdate select file.png

2014-10-21T05:45:33Z

Schnaub:

Datei:Easyupdate setfolder.png

2014-10-21T05:32:13Z

Schnaub:

Diskussion:Easyupdate

2014-10-20T18:08:55Z

Schnaub:

Ob hier ein Abschnitt zur Installation hingehört? M.E. kann man das ja einmal grundsätzlich abhandeln (irgendwo bei Erste Schritte oder so), das braucht nicht jede Extension nochmal zu beschreiben --[[Benutzer:Lucina|lucina]] ([[Benutzer Diskussion:Lucina|Diskussion]]) 15:39, 20. Okt. 2014 (CEST)

----

Ja, das stimmt natürlich. Ich werde das wieder einkürzen.
Kurz zur Erklärung: Ich habe im Zuge eines kompletten Updates via easyupdate die Screenshots an- und hier die ersten abgelegt. Einfach aus dem Umstand heraus, es einmal von vorn bis hinten durch zu spielen.
Es werden evtl. noch weitere unnötige Screens dabei herauskommen aber man kann ja am Ende das Gesamtbild im Finale so darstellen, das es stimmig ist. Abgesehen davon werde ich mich künftig bemühen, keine Screens hochzuladen die nicht wirklich nötig sind.

Mein Ansinnen ist es bei derlei Darstellungen/Anleitungen immmer den Anwender so zu führen, dass so wenig wie möglich "Fragezeichen" auftauchen.
[[Benutzer:schnaub|schnaub]] ([[Benutzer Diskussion:schnaub|Diskussion]]) 20:06, 20. Okt. 2014 (CEST)

Easyupdate

2014-10-20T13:33:26Z

Schnaub:

{{stub}}

'''easyUpdate3'''

'''Tickets / Bugs'''
https://github.com/BugBuster1701/privat-easyupdate3.git

{{AppliesTo
|Version=3.2.14
}}

{{ExtInfo
| Dev=Lutz Schoening und Glen Larger
| ExtVersion=3.0.1 stable
| Version=3.0.6 - 3.3.1
| ERLink=https://contao.org/de/extension-list/view/easyupdate3.de.html
}}
[[Kategorie:Installation_und_Updates]]
[[Kategorie:Extensions]]

== Was ist easyUpdate3? ==
easyUpdate3 ist eine Erweiterung um Contao3 mit speziellen ZIP-Dateien aus dem Backend heraus zu aktualisieren

== Funktionsweise und Erläuterungen ==

=== easyUpdate3 installieren ===

Zum Installieren von easyUpdate3 sind mehrere Wege möglich. In der Erweiterungsverwaltung "easyupdate" eingeben ud Suchen oder in der Erweiterungsliste unter dem gleichen Begriff die Erweiterung Suchen.

Ist die Erweiterung gefunden, wird sie ganz normal installiert

[[Datei:Easyupdate_install_0010.png|Installation von easyUpdate, Schritt 1]]

Contao weist auf die bevorstehende Installation hin

[[Datei:Easyupdate install 0020.png|Installation von easyUpdate, Schritt 1]]

Nach der Installation erscheint easyUpdate nun auch in der Erweiterungsverwaltung

[[Datei:Easyupdate_install_0030.png|Installation von easyUpdate, Schritt 1]]

Ein neuer Menüeintrag ist links unter System sichtbar

[[Datei:Easyupdate_install_0040.png|Installation von easyUpdate, Schritt 1]]

=== Sicherheitshinweise ===

Folgend der Sicherheitshinweis des Autors von "easyUpdate3".
{{Achtung|Hinweistext nach der easyUpdate3 Installation:
Es gibt keine 100%-ige Sicherheit, dass alles einwandfrei funktioniert. Seien Sie sich also bewusst, was Sie tun!
Machen Sie bei der ersten Verwendung dieses Tools ruhig eine zusätzliche Sicherung der Datenbank.
Das Tool greift auf das Dateisystem zu, das kann zu DATENVERLUST führen!
Alles was Sie machen, tun Sie auf eigene Gefahr.}}
Das ist ist sehr guter und richtiger Hinweis, sollte jedoch, beim Einhalten dieser Vorgehensweise, den Anwender nicht Abschrecken "easyUpdate3" zu verwenden

=== Kompatibilität ===

*Getestete und funktionierende Vorgänge:
Getestet wurde eine Installation bis zur Contao Version 3.0.1. ( in der hier dargestellten Fassung auch bis 3.2.14 )

3.0.6 ====> 3.3.1

*Getestete und fehlerhafte Vorgänge:

2.x.x ====> 2.x.x ( Nicht mit Contao 2.x möglich! )

=== Update vorbereiten - ZIP Dateien Downloaden und Ablegen ===

=== Update durchführen ===

*Auswahl der Zip-Datei

{{Hinweis| Wenn eine Versionsnummer X.X.X erscheint, dann ist wahrscheinlich die ZIP-Datei beschädigt}}

=== Update überprüfen - Install-Tool ===

== Autor der Erweiterung eaysupdate3 ==

Glen Larger [[Benutzer:BugBuster|BugBuster]]

== Weiterführende Links ==

[https://contao.org/de/extension-list/view/easyupdate3.de.html easyUpdate3 in der Erweiterungsliste]

[http://www.contao.glen-langer.de Webseite von BugBuster]

[https://community.contao.org/de/showthread.php?1607-easyUpdate-Updates-noch-einfacher&highlight=easyupdate easyUpdate im Contao-Forum]

Datei:Easyupdate install 0040.png

2014-10-20T13:31:48Z

Schnaub:

Datei:Easyupdate install 0030.png

2014-10-20T13:31:29Z

Schnaub:

Datei:Easyupdate install 0020.png

2014-10-20T13:30:41Z

Schnaub:

Datei:Easyupdate install 0010.png

2014-10-20T13:24:06Z

Schnaub:

Diskussion:EFG

2014-09-29T08:19:25Z

Schnaub:

Warum wurden "Absatz für Inserttags für Datei-Uploads" wieder eingefügt ? . Diese sind in der Ver.3.2.x nicht notwendig da sie über Optionsfelder möglich sind.
Die hier aktuelle Version des EFG bezieht sich auf Contao-Version 3.2.x. Das wurde auch so dargestellt.

Korrekt wäre IMHO allenfalls die Info, dass es möglich wäre, auch ausserhalb der Optionen diese tags händisch hinzuzufügen, was jedoch widersinnig wäre.

Bitte um Erklärung.

----

Das ist nicht ganz richtig.

a.) Man kann Dateianhänge für eine Mail in der Formularkonfiguration definieren ... das sind dann Dateien aus der Dateiverwaltung.

und / oder

b.) Die hochgeladene(n) Datei(en) aus dem Formular (über den Feldtyp 'Datei-Upload') an die Mail anhängen. Das macht man mit dem Inserttag.

----
Ok, Danke für die Erläuterung. Ich hatte nicht an den Feldtyp 'Datei-Upload' gedacht.

Diskussion:EFG

2014-09-26T20:51:23Z

Schnaub:

Warum wurden "Absatz für Inserttags für Datei-Uploads" wieder eingefügt ? . Diese sind in der aktuellen Version nicht notwendig da sie über Optionsfelder möglich sind.
Die hier aktuelle Version des EFG bezieht sich auf Contao-Version 3.2.x. Das wurde auch so dargestellt.

Korrekt wäre IMHO allenfalls die Info, dass es möglich wäre, auch ausserhalb der Optionen diese tags händisch hinzuzufügen, was jedoch widersinnig wäre.

Bitte um Erklärung.

Schnaub, 26.09.2014

Diskussion:EFG

2014-09-26T20:50:11Z

Schnaub:

Diskussion:EFG

2014-09-26T20:49:24Z

Schnaub: Frage wegen Korrektur

EFG

2014-09-26T07:37:39Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.2.1 stable
| Version=3.2.2 - 3.2.7
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

=== E - Datei an E-Mail anhängen ===
Mit dem EFG können Dateien jeweils an die versendende E-Mail und/oder an die versendende Bestätigungs-E-Mail angehängt werden.
Beim Verwenden dieser Option kann direkt aus der Dateiverwaltung eine Datei ausgewählt werden

[[Datei:efg_10_attached_sheet_mail_01.png|efg_10_attached_sheet_mail_01.png]]

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> im Text eingesetzt werden.

FELDNAME steht hierbei für den "Feldnamen", 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

'''Leere Felder auslassen'''

Ist diese Option gewählt, werden leere Felder ( z.B. Felder die nicht als Pflichtfeld deklaiert und auch nicht ausgefüllt wurden, nicht im Mailversand berücksichtigt.

'''Dateien an Mail anhängen'''

Mit dieser Option können Dateien als Anhang der Mail versendet werden ( sowohl in der Mail-Versendung als auch in der Bestätigungsmail-Versendung )
Die entsprechende Dateien können direkt aus der Dateiverwaltung von Contao ausgewählt werden.

[[Datei:Attached mail 01.png|Attached mail 01.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.
[[Datei:Efg 07 tooltip alias.png|Efg 07 tooltip alias.png]]}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

Datei:Attached mail 01.png

2014-09-26T07:36:02Z

Schnaub: Schnaub lud eine neue Version von „Datei:Attached mail 01.png“ hoch

Datei:Attached mail 01.png

2014-09-26T07:34:02Z

Schnaub: Schnaub lud eine neue Version von „Datei:Attached mail 01.png“ hoch

Datei:Attached mail 01.png

2014-09-26T07:33:26Z

Schnaub:

Easyupdate

2014-09-24T11:38:58Z

Schnaub:

EFG

2014-09-24T05:52:56Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.2.1 stable
| Version=3.2.2 - 3.2.7
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

=== E - Datei an E-Mail anhängen ===
Mit dem EFG können Dateien jeweils an die versendende E-Mail und/oder an die versendende Bestätigungs-E-Mail angehängt werden.
Beim Verwenden dieser Option kann direkt aus der Dateiverwaltung eine Datei ausgewählt werden

[[Datei:efg_10_attached_sheet_mail_01.png|efg_10_attached_sheet_mail_01.png]]

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.
[[Datei:Efg 07 tooltip alias.png|Efg 07 tooltip alias.png]]}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

Easyupdate

2014-09-23T04:42:04Z

Schnaub:

{{stub}}

'''easyUpdate3'''

'''Tickets / Bugs'''
https://github.com/BugBuster1701/privat-easyupdate3.git

{{AppliesTo
|Version=3.0.6 - 3.3.1
}}

{{ExtInfo
| Dev=Lutz Schoening und Glen Larger
| ExtVersion=3.0.1 stable
| Version=3.0.6 - 3.3.1
| ERLink=https://contao.org/de/extension-list/view/easyupdate3.de.html
}}
[[Kategorie:Installation_und_Updates]]
[[Kategorie:Extensions]]

== Was ist easyUpdate3? ==
easyUpdate3 ist eine Erweiterung um Contao3 mit speziellen ZIP-Dateien aus dem Backend heraus zu aktualisieren

== Funktionsweise und Erläuterungen ==

=== easyUpdate3 installieren ===

=== Sicherheitshinweise ===

Folgend der Sicherheitshinweis des Autors von "easyUpdate3".
{{Achtung|Hinweistext nach der easyUpdate3 Installation:
Es gibt keine 100%-ige Sicherheit, dass alles einwandfrei funktioniert. Seien Sie sich also bewusst, was Sie tun!
Machen Sie bei der ersten Verwendung dieses Tools ruhig eine zusätzliche Sicherung der Datenbank.
Das Tool greift auf das Dateisystem zu, das kann zu DATENVERLUST führen!
Alles was Sie machen, tun Sie auf eigene Gefahr.}}
Das ist ist sehr guter und richtiger Hinweis, sollte jedoch, beim Einhalten dieser Vorgehensweise, den Anwender nicht Abschrecken "easyUpdate3" zu verwenden

=== Kompatibilität ===

*Getestete und funktionierende Vorgänge:
Getestet wurde eine Installation bis zur Contao Version 3.0.1. ( in der hier dargestellten Fassung auch bis 3.2.14 )

3.0.6 ====> 3.3.1

*Getestete und fehlerhafte Vorgänge:

2.x.x ====> 2.x.x ( Nicht mit Contao 2.x möglich! )

=== Update vorbereiten - ZIP Dateien Downloaden und Ablegen ===

=== Update durchführen ===

*Auswahl der Zip-Datei

{{Hinweis| Wenn eine Versionsnummer X.X.X erscheint, dann ist wahrscheinlich die ZIP-Datei beschädigt}}

=== Update überprüfen - Install-Tool ===

== Autor der Erweiterung eaysupdate3 ==

Glen Larger [[Benutzer:BugBuster|BugBuster]]

== Weiterführende Links ==

[https://contao.org/de/extension-list/view/easyupdate3.de.html easyUpdate3 in der Erweiterungsliste]

[http://www.contao.glen-langer.de Webseite von BugBuster]

[https://community.contao.org/de/showthread.php?1607-easyUpdate-Updates-noch-einfacher&highlight=easyupdate easyUpdate im Contao-Forum]

Easyupdate

2014-09-22T16:36:27Z

Schnaub:

Easyupdate

2014-09-22T16:33:43Z

Schnaub:

{{stub}}

'''easyUpdate3'''

'''Tickets / Bugs'''
https://github.com/BugBuster1701/privat-easyupdate3.git

{{AppliesTo
|Version=3.0.6 - 3.3.1
}}

{{ExtInfo
| Dev=Lutz Schoening und Glen Larger
| ExtVersion=3.0.1 stable
| Version=3.0.6 - 3.3.1
| ERLink=https://contao.org/de/extension-list/view/easyupdate3.de.html
}}
[[Kategorie:Installation_und_Updates]]
[[Kategorie:Extensions]]

== Was ist easyUpdate3? ==
easyUpdate3 ist eine Erweiterung um Contao3 mit speziellen ZIP-Dateien aus dem Backend heraus zu aktualisieren

== Funktionsweise und Erläuterungen ==

=== easyUpdate3 installieren ===

=== Sicherheitshinweise ===

Folgend der Sicherheitshinweis des Autors von "easyUpdate3".
{{Achtung|Zitat des Autors in der Erweiterungsliste:
Es gibt keine 100%-ige Sicherheit, dass alles einwandfrei funktioniert. Seien Sie sich also bewusst, was Sie tun!
Machen Sie bei der ersten Verwendung dieses Tools ruhig eine zusätzliche Sicherung der Datenbank.
Das Tool greift auf das Dateisystem zu, das kann zu DATENVERLUST führen!
Alles was Sie machen, tun Sie auf eigene Gefahr.}}
Das ist ist sehr guter und richtiger Hinweis, sollte jedoch, beim Einhalten dieser Vorgehensweise, den Anwender nicht Abschrecken "easyUpdate3" zu verwenden

=== Kompatibilität ===

*Getestete und funktionierende Vorgänge:
Getestet wurde eine Installation bis zur Contao Version 3.0.1. ( in der hier dargestellten Fassung auch bis 3.2.14 )

3.0.6 ====> 3.3.1

*Getestete und fehlerhafte Vorgänge:

2.x.x ====> 2.x.x ( Nicht mit Contao 2.x möglich! )

=== Update vorbereiten - ZIP Dateien Downloaden und Ablegen ===

=== Update durchführen ===

*Auswahl der Zip-Datei

{{Hinweis| Wenn eine Versionsnummer X.X.X erscheint, dann ist wahrscheinlich die ZIP-Datei beschädigt}}

=== Update überprüfen - Install-Tool ===

== Autor der Erweiterung eaysupdate3 ==

Glen Larger [[Benutzer:BugBuster|BugBuster]]

== Weiterführende Links ==

[https://contao.org/de/extension-list/view/easyupdate3.de.html easyUpdate3 in der Erweiterungsliste]

[http://www.contao.glen-langer.de Webseite von BugBuster]

Easyupdate

2014-09-22T15:57:19Z

Schnaub:

Easyupdate

2014-09-22T14:02:53Z

Schnaub: /* Autor der Erweiterung eaysupdate3 */

Easyupdate

2014-09-22T14:02:32Z

Schnaub: /* Autor der Erweiterung eaysupdate3 */

Easyupdate

2014-09-22T14:01:16Z

Schnaub:

Easyupdate

2014-09-22T13:54:12Z

Schnaub:

Easyupdate

2014-09-22T12:50:52Z

Schnaub: Die Seite wurde neu angelegt: „{{stub}} '''easyUpdate3''' '''Tickets / Bugs''' https://github.com/BugBuster1701/privat-easyupdate3.git {{AppliesTo |Version=3.0.6 - 3.3.1 }}“

{{stub}}

'''easyUpdate3'''

'''Tickets / Bugs'''
https://github.com/BugBuster1701/privat-easyupdate3.git

{{AppliesTo
|Version=3.0.6 - 3.3.1
}}

EFG

2014-09-20T19:02:31Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.2.1 stable
| Version=3.2.2 - 3.2.7
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

=== E - Datei an E-Mail anhängen ===
Mit dem EFG können Dateien jeweils an die versendende E-Mail und/oder an die versendende Bestätigungs-E-Mail angehängt werden.
Beim Verwenden dieser Option kann direkt aus der Dateiverwaltung eine Datei ausgewählt werden

[[Datei:efg_10_attached_sheet_mail_01.png|efg_10_attached_sheet_mail_01.png]]

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.
[[Datei:Efg 07 tooltip alias.png|Efg 07 tooltip alias.png]]}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

Aktualisierung durch [[Benutzer:Schnaub|Schnaub]] 18:06, 18. Sep. 2014

EFG

2014-09-20T18:50:53Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.2.1 stable
| Version=3.2.2 - 3.2.7
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

=== E - Datei an E-Mail anhängen ===
Mit dem EFG können Dateien jeweils an die versendende E-Mail und/oder an die versendende Bestätigungs-E-Mail angehängt werden.
Beim Verwenden dieser Option kann direkt aus der Dateiverwaltung eine Datei ausgewählt werden

[[Datei:efg_10_attached_sheet_mail_01.png|efg_10_attached_sheet_mail_01.png]]

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.
[[Datei:Efg 07 tooltip alias.png|Efg 07 tooltip alias.png]]}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

EFG

2014-09-19T13:05:24Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

=== E - Datei an E-Mail anhängen ===
Mit dem EFG können Dateien jeweils an die versendende E-Mail und/oder an die versendende Bestätigungs-E-Mail angehängt werden.
Beim Verwenden dieser Option kann direkt aus der Dateiverwaltung eine Datei ausgewählt werden

[[Datei:efg_10_attached_sheet_mail_01.png|efg_10_attached_sheet_mail_01.png]]

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.
[[Datei:Efg 07 tooltip alias.png|Efg 07 tooltip alias.png]]}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

Datei:Efg 07 tooltip alias.png

2014-09-19T13:01:40Z

Schnaub:

EFG

2014-09-19T12:51:16Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

=== E - Datei an E-Mail anhängen ===
Mit dem EFG können Dateien jeweils an die versendende E-Mail und/oder an die versendende Bestätigungs-E-Mail angehängt werden.
Beim Verwenden dieser Option kann direkt aus der Dateiverwaltung eine Datei ausgewählt werden

[[Datei:efg_10_attached_sheet_mail_01.png|efg_10_attached_sheet_mail_01.png]]

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

EFG

2014-09-19T12:48:56Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

=== E - Datei an E-Mail anhängen ===
Mit dem EFG können Dateien jeweils an die versendende E-Mail und/oder an die versendende Bestätigungs-E-Mail angehängt werden.
Beim Verwenden dieser Option kann direkt aus der Dateiverwaltung eine Datei ausgewählt werden

[[Datei:efg_10_attached_sheet_mail_01.png|efg_10_attached_sheet_mail_01.png]]

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

Datei:Efg 10 attached sheet mail 01.png

2014-09-19T12:45:10Z

Schnaub:

EFG

2014-09-19T12:03:43Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst: - zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:

* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

EFG

2014-09-19T11:54:31Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

----

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

----

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

----

=== D - zusätzliche Formularfeld-Typen ===
EFG stellt im Formular-Generator weitere Feld-Typen bereit:
* Select-Menü (DB)
* Radio-Button-Menü (DB) und
* Checkbox-Menü (DB)

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst:
* zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:
* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

EFG

2014-09-19T11:11:20Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

=== D - 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)

[[Datei:Efg-be_formdatalisting_de.png]]

Dieser Feld-Typ erzeugt im Frontend-Formular eine Bilder-Galerie, ergänzt um Radio-Buttons zur Auswahl eines Bildes.

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst:
* zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:
* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]

[https://contao.org/de/extension-list/view/efg.20020019.de.html EFG in der Erweiterungsliste]

----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

EFG

2014-09-19T11:07:02Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

=== D - 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)

[[Datei:Efg-be_formdatalisting_de.png]]

Dieser Feld-Typ erzeugt im Frontend-Formular eine Bilder-Galerie, ergänzt um Radio-Buttons zur Auswahl eines Bildes.

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst:
* zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:
* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:Efg 09 form show fe data 01.png|Efg 09 form show fe data 01.png]]

[[Datei:Efg 09 form show fe data 02.png|Efg 09 form show fe data 02.png]]

[[Datei:Efg 09 form show fe data 03.png|Efg 09 form show fe data 03.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]
----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

Datei:Efg 09 form show fe data 03.png

2014-09-19T11:02:11Z

Schnaub:

Datei:Efg 09 form show fe data 02.png

2014-09-19T11:00:22Z

Schnaub:

Datei:Efg 09 form show fe data 01.png

2014-09-19T10:59:47Z

Schnaub:

EFG

2014-09-19T09:46:47Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

=== D - 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)

[[Datei:Efg-be_formdatalisting_de.png]]

Dieser Feld-Typ erzeugt im Frontend-Formular eine Bilder-Galerie, ergänzt um Radio-Buttons zur Auswahl eines Bildes.

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst:
* zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:
* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:efg-be_formdatalisting_de.png|efg-be_formdatalisting_de.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.

[https://community.contao.org/de/forumdisplay.php?13-efg Rubrik EFG im Contao-Forum]
----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

EFG

2014-09-19T09:02:26Z

Schnaub:

{{stub}}

'''EFG (Extended Form Generator)'''
Übertrag Handbuch EFG aus altem Wiki

'''Tickets / Bugs'''
https://bitbucket.org/thk/efg/issues

{{AppliesTo
|Version=3.2.X
}}

{{ExtInfo
| Dev=Thomas Kuhn
| ExtVersion=2.0.1 stable
| Version=2.7.0 - 3.0.5
| ERLink=http://www.contao.org/erweiterungsliste/view/efg.20000019.de.html
|Depending=[http://www.contao.org/erweiterungsliste/view/xls_export.de.html
}}
[[Kategorie:Extensions]]
== Was ist und was bietet EFG? ==
EFG steht für Extended Form Generator und erweitert den Contao Formular-Generator um die folgenden Features.

=== A - (EFG) Per E-Mail versenden ===
EFG bietet die Möglichkeit eine E-Mail die übermittelten Daten an eine definierte E-Mail-Adresse zu versenden. Die Option "(EFG) Per E-Mail versenden" sollte verwendet werden wenn EFG in Kombination mit z.B. einer Bestätigungsmail zur Anwendung kommt.
"Insert-Tags" können verwendet werden.

[[Datei:Efg_01_form_send_mail.png|Efg_01_form_send_mail.png]]

=== B - (EFG) Bestätigung per E-Mail versenden ===
Eine Kopie des per E-Mail vesendeten Formulars kann auch an den Absender geschickt werden.

[[Datei:Efg_02_small_form_confirm_mail.png|Efg_02_small_form_confirm_mail.png]]

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.

=== C - Speichern eingehender "Formular-Daten", Erstellung von Backend-Modulen ===
EFG bietet im Formular-Generator eine weitere Option "Daten im Modul 'Formular-Daten' speichern".

[[Datei:Efg_03_form_backup_data_small.png|Efg_03_form_backup_data_small.png]]

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.

=== D - 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)

[[Datei:Efg-be_formdatalisting_de.png]]

Dieser Feld-Typ erzeugt im Frontend-Formular eine Bilder-Galerie, ergänzt um Radio-Buttons zur Auswahl eines Bildes.

----

== Funktionsweise und Erläuterungen ==

*(EFG) Per E-Mail versenden

Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Empfängeradresse'''

Die Emailadresse an welche die übermittelten Daten gesendet werden sollen

'''Betreff'''

Die Betreffzeile

'''Text der E-Mail'''

Die Textnachricht, Insert-Tags sind möglich, siehe Abblidung unten

[[Datei:Efg 04 form options data.png|Efg 04 form options data.png]]

----

*(EFG)Bestätigung per E-Mail versenden

Nur wenn diese Option gewählt ist, wird eine Bestätigungs-E-Mail versendet.
Hierfür stehen im Formular-Generator die im folgenden dargestellten Felder zur Verfügung.

'''Formularfeld der Empfänger-E-Mailadresse:'''

Hier muss das Formularfeld angegeben werden in dem der Absender ( Frontend-Benutzers/Seitenbesucher ) seine Emailadresse angibt oder ein Formularfeld das die Emailadresse als Wert enthält

'''Absender:'''

Die E-Mail-Adresse, die als Absender der Bestätigungs-Mail verwendet wird
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Antwort an (Reply-to)'''

Hier kann die Emailadresse angegeben werden falls die Antwort auf die Bestätigungsmail nicht an den Absender gesendet werden sollen. Alternative ist die Eingabe mehrerer Emailadressen ( kommagetrennt ) möglich

'''Betreff:'''

Die Betreffzeile der Bestätigungs-Mail
Verwendung von Insert-Tags möglich, siehe "Text der Bestätigungs-E-Mail"

'''Text der Bestätigungs-E-Mail:'''

Der eigentliche Text (Mail-Body) der Bestätigungs-Email. Es können die allgemeinen "Insert-Tags" (siehe http://www.contao.org/inserttags.html ) zur Ausgabe von Datum o.ä. eingesetzt werden.

Weiterhin können die per Formular übermittelten Daten mit Insert-Tags der Form
<source>{{form::FELDNAME}}</source> 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 der folgende Insert Tag im Text der Email durch den vom Formular-Absender angegebenen Namen ersetzt: <source>{{form::user_name}}</source>

Datei-Uploads können als Anhang der Bestätigungs-Mail versendet werden, durch Einfügen von Insert-Tags der Form: <source>{{form::FELDNAME?attachment=true}}</source>

Um der Ausgabe ein Label hinzu zu fügen, verwendet man: <source>{{form::FELDNAME?label=Label of this field: }}</source>
Mit der Formularoption "Leere Felder auslassen" kann so die Ausgabe leerer Felder inkl. Label unterdrückt werden.

'''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.

[[Datei:Efg 05 form options confirm.png|Efg 05 form options confirm.png]]

----

== Speichern von "Formular-Daten" im Backend, Erstellung von Backend-Modulen ==

EFG stellt im Formular-Generator eine zusätzliche Option zur Verfügung:
Wenn diese Option aktiviert ist, werden über das Frontend-Formular übermittelte Daten in der Datenbank gespeichert und können im Backend verwaltet werden.
{{Hinweis|Nach Ergänzung oder Änderung von Formular-Feldern muß das Formular erneut gespeichert werden, oder aber diese Option erst nach Anlegen aller benötigten Formular-Felder gewählt werden.}}

* Daten im Modul "Formular-Daten" speichern

Hierfür stehen im Formular-Generator die im folgenden dargestellten Optionen zur Verfügung.

'''Formularfeld für Alias*'''

Hier muss das Formularfeld gewählt werden dessen Inhalt zur Erzeugung des Formulardaten-Alias verwendet wird.{{msgInfo|Um eine korrekte ID für jeden Datensatz zu erhalten, sollte man beim Erstellen der Formularfelder mit einem versteckten Feld beginnen, dieses z.B. als ID benennen und den Standard-Wert für das Feld mit <source>{{date::Ymdi}} </source> belegen. So ist eine eindeutige Referenz als Alias gewährleistet.}}

'''Optionswerte speichern'''

Hier kann die Option gewählt werden, das bei den Feldern des Typ 'Select-Menü', 'Radio-Button-Menü' und 'Checkbox-Menü' der ausgewählte Wert anstelle der Bezeichnung gespeichert wird. Die Option hat keine Auswirkung auf die Felder 'Select-Menü (DB)', 'Radio-Button-Menü (DB)' und 'Checkbox-Menü (DB)'

'''Feldwerte exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die ausgewählten Werte von Formularfeldern anstelle der ausgewählten Bezeichnungen exportiert. Dies trifft für alle Radio-Buttons, Checkboxen und Selects zu

'''Feldnamen exportieren'''

Wird diese Option gewählt, werden beim Export der Formulardaten die Feldnamen anstelle der Feldbezeichnungen exportiert

[[Datei:Efg 06 form backup data.png|Efg 06 form backup data.png]]

----

*Verwaltung der "Formular-Daten" im Backend

Sobald für mindestens ein Formular die Speicherung der "Formular-Daten" aktiviert ist, erscheint ein neuer Bereich in der Backend-Navigation, benannt als "Formular-Daten".

[[Datei:Efg_be_module_feedback.png|Efg_be_module_feedback.png]]

Jedes "daten-speichernde" Formular erzeugt darunter einen weiteren Eintrag (die Bezeichnung entspricht dabei dem Titel des Formulars).

Hier können die Daten bearbeitet/verändert und gelöscht werden. Auch Neuanlegen von Datensätzen, sowie Export der Daten im CSV-Format ist im Backend möglich.

Zusätzlich bietet der Navigations-Eintrag "Feedback" den gleichzeitigen Zugriff auf die aus verschiedenen Formularen gespeicherten Daten. Dies kann genutzt werden, wenn z.B. mehrere unterschiedliche "Anfrage"-Formulare im Einsatz sind. (Ein Neuanlegen von Daten ist allerdings nur in den formularspezifischen Listen-Ansichten möglich.)

----

*Bearbeitung der Daten im Backend

[[Datei:Efg 08 backend edit data.png|Efg 08 backend edit data.png]]

Jeder Datensatz umfasst:
* zusätzlich zu den per Formularfeld definierten - folgende Basis-/Metadaten:
* Anzeige des betreffenden Formulars aus dem der Datensatz stammt ( Feldbezeichung "Formular" ) '''''*1'''''
* Die Referenz-Anzeige des Eintrags ( Feldbezeichung "Alias" ) '''''*1'''''
* das Datum der Erstellung/Übermittlung des Datensatzes (Feldname "date") '''''*1'''''
* die IP-Adresse des Benutzers (Feldname "ip") '''''*1'''''
* eine Checkbox "Veröffentlicht" (Feldname: "published", Vorgabewert: nicht veröffentlicht, kann wie bei Artikeln z.B. in Verbindung mit Auflistung-Modul als Kriterium für Anzeige im Frontend dienen) '''''*2'''''
* den Sortierindex ( Der Sortierindex kann bei einer Auflistung verwendet werden ) '''''*1'''''
* "Bestätigungsmail gesendet" ( Hinweis ob eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* "Bestätigungsmail gesendet am" ( Hinweis wann eine Bestätigungsmail gesendet wurde ) '''''*1'''''
* ein Textfeld "Bemerkung" (Feldname: "be_notes") '''''*2'''''
* Dropdownfeld zur Auswahl von Mitglied als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Mitgliedsgruppe als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzer als Besitzer des Datensatzes '''''*3'''''
* Dropdownfeld zur Auswahl von Benutzergruppe als Besitzer des Datensatzes '''''*3'''''

'''''*1''''' - Diese Felder sind im Frontend-Formular nicht verfügbar; sie werden sowohl per Frontend-Formular als auch bei Daten-Erfassung im Backend automatisch befüllt

'''''*2''''' - Diese Felder sind im Frontend-Formular nicht verfügbar, können aber z.B. in Verbindung mit Auflistungs-Modul Verwendung finden

'''''*3''''' - Diese Felder dienen der Zuordnung von Mitglieder- und Benutzergruppenberechtigungen bei der Ansicht / Bearbeitung im FE

----

'''Frontend-Modul "Auflistung Formular-Daten"'''

Zur Ausgabe der "Formular-Daten" im Frontend steht ein Ausgabe-Modul "Auflistung Fomular-Daten" zur Verfügung. Die Anwendung und Funktionsweise entspricht dem Modul "Auflistung".
Optional kann die Bearbeitung und das Löschen der Daten im Frontend ermöglicht werden (wahlweise öffentlich, nur Daten der eigenen Mitglieder-Gruppe oder nur eigene Daten).

[[Datei:efg-be_formdatalisting_de.png|efg-be_formdatalisting_de.png]]

Anstelle von Datenbank-Feldnamen wird bei den Angaben "Felder", "Bedingung", "Sortieren nach", "Durchsuchbare Felder" und "Felder der Detailseite" der im Formular-Generator für das jeweilige Formularfeld eingetragene "Feldname" verwendet.

== Lizenz ==
EFG wird der Contao Community unter der gleichen Lizenz wie Contao zur Verfügung gestellt (LGPL).

== Autor der Erweiterung EFG ==
Thomas Kuhn

== Weiterführende Links ==
Auf dem TYPOlight-Usertreffen 2009 in Frankfurt am Main wurde die Erweiterung EFG mit Praxisbeispielen vorgestellt. Die dazu gehörenden Informationen sind auf http://www.tl-usertreffen.weitzeldesign.com/usertreffen-2009.html zu finden.
----

--[[Benutzer:Planepix|Planepix]] 15:04, 12. Mär. 2011 (CET)

Datei:Efg 08 backend edit data.png

2014-09-19T08:44:17Z

Schnaub: