skip to content

Regional Computing Centre (RRZK)TYPO3 at University of Cologne

Powermail-Formulare erstellen und einbinden

Powermail unterscheidet sich in einer grundlegenden Eigenschaften von den meisten anderen TYPO3-Extensions: Eigentlich immer genügt es ein Plugin in die Seite einzubetten und es wird an der entsprechenden Stelle automatisch definiert. Powermail macht einen Unterschied zwischen der Definition und dem Einbetten des Formulars.

Sie können ein bestehendes Formular ohne Probleme auf eine andere Seite verschieben. TYPO3 hält Sie nicht auf, aber kopieren Sie kein bestehendes Formular auf eine neue Seite. Es ist ein naheliegender Gedanke ein ähnliches Formular zu kopieren und anzupassen. Dies scheint  Arbeit zu sparen, doch letztlich führt dies zu technischen Problemen mit der Datenstruktur.

  • Es ist empfehlenswert das Formular auf derjenigen Seite anzulegen, auf welcher es verwendet werden soll. Suchen Sie also zunächst die entsprechende Seite im Seitenbaum, oder legen Sie sie an falls sie noch nicht existiert.
  • Wählen Sie diese Seite aus und wechseln Sie in das Listen-Modul.
  • Klicken Sie auf den Button "Create New Record" / "Neuen Datensatz erstellen" direkt oberhalb des Seitentitels.
  • Wählen Sie "Formulare" aus der Gruppe powermail um ein Formular auf dieser Seite anzulegen.
expand:
Wählen Sie "Formulare" aus der Gruppe powermail um ein Formular auf dieser Seite anzulegen.

  • Es erscheint ein weiterer Dialog.
  • Dort vergeben Sie zunächst einen Namen für das Formular. Dieser sollte aussagekräftig sein, denn er dient dazu das Formular im Backend zu erkennen. Er erscheint aber nicht im Frontend.
  • Klicken Sie auf den Button "Create New Pages".
  • Der Dialog wird erweitert und Powermail legt nun eine "Page" an. Das ist keine Seite im Seitenbaum, sondern eine Ansichtsseite des Formulars. Diese können Sie in mehreren Schritten anzeigen. Benennen Sie diese Seite. Auch diesen Namen sehen Sie nicht im Frontend. Für jeden Anzeige-Schritt benötigen Sie eine weitere Seite, die Sie über den Button "Create new Pages" anlegen können.
  • Klicken Sie nun auf den Button "Create new Fields". Fügen Sie der jeweiligen Seite die gewünschten Formular-Elemente hinzu. Definieren Sie hierbei immer einen Variablen-Name für jedes zu übertragende Formular-Element.
  • Vergessen Sie nicht das Submit-Element und vergessen Sie nicht zu speichern. Das Submit-Element erzeugt den "Absenden"-Button ohne den das Formular funktionslos bleibt.
expand:
Der Dialog zum Definieren eines neuen Formulars ist mehrstufig: Zunächst vergeben Sie einen Namen für das Formular, dann legen Sie mit "Create New Pages" (1) eine Formularseite an für die Sie ebenfalls einen Namen vergeben. Jetzt können Sie mit "Create New Fields" (2) neue Formularlemente hinzufügen.

  • Wechseln Sie nun auf das Seiten-Modul.
  • Ein Formular in der Marginalia macht aufgrund des dort beschränkten Platz und des Verhaltens der Marginalia im Responsive Design keinen Sinn. Suchen Sie deshalb in der Haupt-Spalte die Stelle an welcher das Formular angezeigt werden soll und klicken Sie dort auf "Element hinzufügen".
expand:

  • Geben Sie der Formular eine Überschrift. Diese wird auch im Frontend angezeigt, wenn Sie nicht die Darstellung auf Hidden setzen.
  • Wechseln Sie in den Tab Plug-In:
    • Dort wählen Sie in der Gruppe Erweiterungsoptionen den Tab "Main Settings" / "Einstellungen".
    • Hier können Sie im Dropdown-Menü "Powermail Formular wählen" das entsprechende Formular auswählen. Wenn Sie unserem Rat folgend das Formular auf der gleichen Seite definiert haben, ist es dort meist vorausgewählt.

  • Speichern Sie ab und wechseln Sie in das Frontend.
  • Probieren Sie nun Ihr Formular aus.

  • Die Extension Powermail erhält überdurchschnittlich oft Updates. Bei wichtigen Formularen sollten Sie diese nach einem solchen Update erneut ausprobieren.

Contact
If you have any questions or problems, please contact the RRZK-Helpdesk