Der Formular Manager ist eine Erweiterung, die es dem/der Benutzer:in erlaubt, auf einfache Weise per Drag & Drop eigene Formulare zu erstellen.
Vom/von der Integrator:in müssen vor dem Einsatz wenige Konfigurationen im TypoScript vorgenommen werden.
Außerdem kann das Design durch CSS-Variablen und weitere Eingrifffe im CSS beliebig angepasst werden.
Im TypoScript können vom/von der Integrator:in einige Einstellungen gesetzt werden, die entweder das Verhalten des Elements, die DSGVO-Checkbox, das Aussehen der Felder oder die erlaubten Elemente im Fomular beeinflussen.
Diese Einstellungen sind in der unten stehenden Tabelle aufgeführt. Dem TypoScript-Pfad muss folgendes vorangesetzt werden:
plugin.tx_bh.settings.contentElements.el-form-manager
| Typoscript-Pfad | Werte | Funktion | Standardwert |
| config.disabled-thanks-setting | 0 / 1 | Wenn hier 1 gesetzt wird, kann der/die Redakteur:in im Settingsformular die ID der Dankeseite nicht verändern. Diese muss dann allerdings vom/von der Integrator:in im TypoScript vorgegeben werden! | 1 |
| thanks | integer | Hier wird die ID der Dankeseite vorkonfiguriert. | 1 |
| widthEnabled | 0 / 1 | Aktivieren/Deaktivieren der globalen Element-Einstellungen für die Maximalbreite (nur in Verbindung mit framework.css). | 0 |
| marginEnabled | 0 / 1 | Aktivieren/Deaktivieren der globalen Element-Einstellungen für den Abstand nach unten (nur in Verbindung mit framework.css). | 0 |
| elementsAllowed | string | Elemente, die man in das Formular ziehen kann. | el-form-manager-item |
Dem TypoScript-Pfad muss folgendes vorangesetzt werden:
plugin.tx_bh.settings.contentElements.el-form-manager-item
| Typoscript-Pfad | Werte | Funktion | Standardwert |
| config.label | 0 / 1 | Hier kann die Anzeige des Labels bei den Fomularfeldern ein- und ausgeschaltet werden. | 1 |
| config.placeholder | 0 / 1 | Hier kann die Anzeige des Placeholders bei den Fomularfeldern ein- und ausgeschaltet werden. | 1 |
Um Einfluss auf das Design der Anfrage zu nehmen, können folgende Variablen angepasst werden:
In den Mail-Templates lassen sich das Logo, die Überschrift, der Text und die Farben im TypoScript konfigurieren:
Wenn diese Anpassungen nicht ausreichen oder mehrere Mail-Templates benötigt werden, können mehrere Templates im TypoScript definiert und die Dateien ausgelagert werden - siehe weiter unten.
Die Texte werden in den Übersetzungen gesetzt.
Folgende Übersetzungs-Keys stehen im Send- und Confirm-Mail zur Verfügung:
| Key in der Übersetzung | Beschreibung |
| el-form-manager--sendmail-headline | Text der Überschrift im Send-Mail |
| el-form-manager-sendmail-text | Text des Send-Mails, der über der Tabelle mit den Daten der Anfrage angezeigt wird. |
| el-form-manager-confirmmail-headline | Text der Überschrift im Confirm-Mail |
| el-form-manager-confirmmail-text | Text des Confirm-Mails, der über der Tabelle mit den Daten der Anfrage angezeigt wird. |
Sollten die Konfigurationsmöglichkeiten der Default-Templates nicht ausreichen oder werden mehrere Mail-Templates benötigt, so können im TypoScript für jedes Formular weitere Send- und Confirm-Mail-Templates definiert werden:
Sobald im TypoScript weitere Templates definiert sind, kann der/die Redakteur:in im Settingsformular des Anfrage-Managers zwischen den angebotenen Templates wählen.
Beim Formular Manager kann durch Klicken des add Plus-Symbols in der Element-Status-Leiste ein Formular-Element hinzugefügt werden.
Bei der Erstellung eines Formulars ist zu beachten, dass das Formular nur dann richtig funktioniert, wenn auch ein Haupt-E-Mail-Feld enthalten ist.
Wenn ein weiteres E-Mail-Feld in das Formular soll, sollte hier das Feld
zusätzliche E-Mail verwendet werden. Der Name des zusätzlichen E-Mail-Feldes darf nicht mail sein!
Das Anfrage-Element kann dann in den Einstellungen wie folgt konfiguriert werden:
Hier wird die Art des Anfrage-Elements eingestellt. Folgende Optionen stehen zur Auswahl:
Hier wird die Breite des Elements eingestellt.
Hier kann ein Tooltip aktiviert werden. Dieser erscheint als kleines Fragezeichen-Icon über dem Feld und zeigt beim darüber Hovern einen Text an.
Hier wird der Name des Feldes angegeben. Dieser wird im Formular nicht angezeigt, sondern dient zur Zuordnung des Wertes nach Abschicken des Formulars. Der Name des Feldes kann sich durchaus vom Label und dem Placeholder unterscheiden.
Im Namen des Feldes dürfen keine Leerzeichen, Umlate oder Sonderzeichen vorkommen.
TIPP:
Statt Leerzeichen kann der Unterstrich _ verwendet werden. Dieser wird im Mail dann durch Leerzeichen ersetzt.
Hier kann das Anfrage-Element als Pflichtfeld deklariert werden. Ist diese Option aktiviert, kann das Formular nicht abgeschickt werden, wenn das Feld leer ist.
Bei manchen Feldern sind noch weitere Optionen möglich, die sich meist von selbst erklären oder durch einen Tooltip im Settingsformular näher beschrieben werden.
Das Label bzw. der Placeholder des Inputfeldes, sowie der Text des Tooltipps und auch die Optionen für das Dropdown-Feld, können durch Klicken des edit Stift-Symbols in der Element-Toolbar oder durch Doppelklick auf das Feld bearbeitet und auch übersetzt werden.
Nach Klick auf das Stift-Symbol öffnen sich über dem Input-Feld die Optionen zum Bearbeiten der Texte.
Nach dem Wechseln in eine andere Sprache können hier auch die Texte übersetzt werden.
Diese Texte können - wie im Bakehouse gewohnt - direkt durch Doppelklick oder durch Klick auf das edit Stift-Symbol bearbeitet werden.
Der Text des Absende-Buttons kann durch Doppelklick bearbeitet werden.
Die einzelnen Optionen des Dropdownfelds können ähnlich wie Label/Placeholder und Tooltip im Bearbeiten-Modus des Anfrage-Elements definiert und übersetzt werden.
Jede Zeile ist eine neue Option.
Es können pro Option ein Label (dies wird im offenen Dropdown angezeigt) und ein Wert (dieser wird nach der getätigten Anfrage weitergegeben) angegeben werden. Diese müssen durch ein Semikolon ; getrennt werden.
Wenn Wert und Label ident sind, kann auch nur eines der beiden angegeben werden.
Bei obiger Eingabe sieht das Dropdownfeld dann wie folgt aus:
Um die Optionen zu übersetzen, muss die Sprache gewechselt werden und dann im Bearbeiten-Modus des Anfrage-Elements die Optionen übersetzt werden.
Das Ergebnis der obigen Übersetzung sieht dann wie folgt aus:
