Powermail
Mit dem Inhaltselement Formular Powermail können Formulare direkt auf einer Seite eingebunden werden.
Das Plug-in eignet sich für Kontaktformulare, Anmeldungen oder Feedback. Formulare können flexibel gestaltet werden, von einfachen Textfeldern bis zu mehrseitigen Formularen mit Pflichtfeldern oder Auswahllisten. Die eingegebenen Daten werden per E-Mail übermittelt oder im TYPO3-Backend gespeichert.
Aufbau und Funktionsweise von Powermail
Powermail ist ein Werkzeug zur Erstellung, Anzeige und Verwaltung von Formularen.
Die ausgefüllten Daten können sowohl an die Redaktion als auch an die ausfüllende Person zur Bestätigung per E-Mail geschickt werden.
Zusätzlich können alle übermittelten Daten im Backend eingesehen und exportiert werden.
Powermail besteht aus drei Komponenten:
Inhaltselement Powermail: steuert u. a. den Versand der Antwort-E-Mails und das Verhalten im Seiteninhalt
Formular: enthält die Felder, die im Frontend angezeigt werden
Datenverwaltung: dient zur Einsicht und zum Export der eingegangenen Formulardaten
Hinweis
Trotz des großen Funktionsumfangs ist Powermail nicht für komplexe Abläufe wie Veranstaltungs- oder Kursanmeldungen geeignet.
Nutzen Sie für die Anmeldung von Lehrveranstaltungen ausschließlich die dafür vom ZID bereitgestellten Werkzeuge.
Neues Inhaltselement "Powermail" anlegen
Öffnen Sie im Seitenbaum die Seite, auf der das Formular angezeigt werden soll, und klicken Sie anschließend auf Neues Inhaltselement.
- Wählen Sie in der linken Spalte die Kategorie Powermail aus.
- In der rechten Spalte erscheint nun das Inhaltselement Formular Powermail, das Sie auswählen können.
- Tragen Sie im Reiter Allgemein eine aussagekräftige Überschrift ein (z. B. „Kontaktformular“).
Formular erstellen und bearbeiten
Formular erstellen
Öffnen Sie den Reiter Plug-In. Im Bereich Erweiterungsoptionen → Powermail Formular wählen entscheiden Sie, ob Sie ein neues Formular erstellen oder ein bestehendes wiederverwenden möchten:
- Neues Formular anlegen: Klicken Sie unten rechts auf + (Neues Formular erstellen).
Bestehendes Formular wiederverwenden: Unter Powermail Formular wählen können Sie auch ein bereits erstelltes Formular aus der Liste auswählen.
ACHTUNG: Änderungen, die Sie später an diesem Formular vornehmen, gelten automatisch für alle Seiten, auf denen dasselbe Formular eingebunden ist. Nutzen Sie diese Option daher nur, wenn Sie bewusst dasselbe Formular mehrfach verwenden möchten (z. B. bei identischen Kontaktformularen).
- Geben Sie im Feld Bezeichnung einen klaren internen Namen ein, z. B. Kontaktformular - Organisation X. So finden Sie das Formular später leicht wieder.
- Klicken Sie auf + Seite neu erstellen, um Ihre erste Formularseite zu erstellen.
- Tragen Sie im Feld Bezeichnung den gewünschten Seitentitel ein, zum Beispiel Kontakt.
Formularfelder hinzufügen
- Klicken Sie im Bereich Felder auf Feld neu erstellen.
- Tragen Sie im Feld Bezeichnung den gewünschten Feldnamen ein – zum Beispiel Vorname, E-Mail-Adresse oder Nachricht.
- Wählen Sie unter Typ den passenden Feldtyp aus.
- Textfeld (Input): für kurze Texteingaben, etwa Name oder Betreff
- Textfeld Mehrzeilig (Textarea): für längere Texte, beispielsweise Nachrichten oder Kommentare
- Auswahlfeld (Select): für ein Dropdown-Menü mit mehreren Optionen
- Mehrfachauswahl (Check): für mehrere auswählbare Checkboxen
- Einfachauswahl (Radio): für eine einzige Auswahlmöglichkeit
- Abschicken Feld (Submit): sendet das Formular ab – Pflichtfeld in jedem Formular
- Datei Upload: ermöglicht das Hochladen von Dateien, z. B. PDF oder Bilder
- Wenn das Feld für den Namen oder E-Mail des Absenders verwendet werden soll, wählen Sie eine der folgenden Optionen:
- Aktivieren Sie Dieses Feld beinhaltet die E-Mail des Absenders, wenn hier die E-Mail-Adresse der absendenden Person eingegeben wird.
- Aktivieren Sie Dieses Feld beinhaltet den Namen des Absenders, wenn das Feld den Namen der absendenden Person enthält.
Wiederholen Sie diese Schritte für alle weiteren Felder, die Sie benötigen. Damit das Formular gesendet werden kann, muss es ein Abschicken Feld (Submit) enthalten. Speichern Sie das Formular, erst danach wird das Formular in der Auswahl sichtbar. Kehren Sie zurück zum Inhaltselement und öffnen Sie den Reiter Plug-In. Wählen Sie unter Powermail Formular wählen Ihr soeben erstelltes Formular aus.
Seiteninhalt einfügen
Wenn Sie Inhaltselemente, z.B. Teaser, Text & Medien oder Infobox innerhalb des Powermail Formulars hinzufügen möchten, legen Sie diesen am besten in einem Ordner vorab an. Sie können auch bereits bestehende und befüllte Inhaltselemente einer aktiven Seite verwenden.
Dann gehen Sie wie folgt vor:
- Wählen Sie in Ihrem Powermail-Formular den Feldtyp Seiteninhalt.
- Benennen Sie das Feld unter Bezeichnung. Die Bezeichnung wird nicht auf der Website angezeigt und ist nur für die Identifikation im Backend erforderlich.
- Unter + Inhalt auswählen navigieren Sie zum gewünschten Inhaltselement in Ihrem Ordner oder auf Ihrer aktiven Seite und wählen Sie dieses aus.
Das Inhaltselement wird an der Stelle des Feldes im gewünschten Seitenbereich angezeigt und kann im Backend wie gewohnt nach oben und unten verschoben werden.
Upload-Dateien werden umbenannt
Aus Sicherheitsgründen ist es unbedingt notwendig, dass die Dateien beim Upload einen neuen zufallsgenerierten Dateinamen bekommen. Dies gilt es also beim Erstellen des Formulars zu bedenken um Verwirrung a la “Welche der Dateien ist jetzt der Lebenslauf?” vorzubeugen. Es gibt zwei erprobte Lösungsvorschläge:
- Single-PDF: Diese Möglichkeit lässt nur den Upload einer einzigen Datei zu - die User*in muss die Dateien zusammenfügen.
- File Drop: Eine weitere Möglichkeit ist es, statt des Datei-Upload Feldes einen Link zu einen u:cloud File Drop einzufügen, der es ermöglicht Dateien dort abzulegen. Eine Anleitung zum Einrichten eines solchen Ordners finden Sie auf der entsprechenden Seite des ZID. Diese Möglichkeit hat den Vorteil, dass durch die u:cloud Desktop und Mobile-App die Dateien nicht mehr heruntergeladen werden müssen und keine Umbenennung notwendig ist.
File Drop einrichten
Wenn Nutzer*innen mehrere Dateien hochladen sollen, ohne dass diese umbenannt werden, gehen Sie wie folgt vor:
- Sie benötigen einen u:cloud Zugang (für alle Mitarbeiter*innen und Studierende der Universität Wien möglich)
- Sie müssen in Ihrer u:cloud einen Dateianfrage-Ordner erstellen. Eine Anleitung dazu gibt es vom ZID.
- Öffnen Sie die Freigabeoptionen (Person mit + Symbol)
- Klicken Sie auf “Öffentlichen Link erstellen”
- Klicken Sie direkt auf die drei Punkte und wählen Sie “Freigabelink anpassen”
- Wählen Sie “Dateianfrage - Nur hochladen” und achten Sie darauf, dass unter “Erweiterte Einstellungen” "Download verbergen” ausgewählt ist.
Testen Sie den Freigabe-Link in einem privaten Browserfenster (Inkognito-Modus) zwei Mal. Achten Sie beim zweiten Mal darauf, dass die Dateien, die Sie beim ersten mal hochgeladen haben, nicht sichtbar sind.
- Fügen Sie den nue generierten u:cloud Freigabe Link / Filedrop-Link in einem eigenen Inhaltselement im Powermail-Formular hinzu.
Mehrseitige Formulare erstellen
Wenn Ihr Formular viele Felder enthält, können Sie es auf mehrere Seiten aufteilen. Dadurch bleibt die Eingabe übersichtlich und nutzerfreundlich.
- Öffnen Sie im Formular, im Reiter Plug-In und wählen Sie unter Powermail Formular wählen das gewünschte Formular und speichern Sie Ihre Auswahl.
- Klicken Sie auf das Stiftsymbol neben dem Formularnamen, um das Formular zu bearbeiten.
- Öffnen Sie das Inhaltselement Powermail und haken Sie unter Plug-In > Einstellungen die Option Mehrschrittformular aktivieren (Schritt für Schritt) an
- Im Bereich Seiten klicken Sie auf + Seite neu erstellen und geben Sie eine passende Bezeichnung ein.
- Fügen Sie die gewünschten Felder mit + Feld neu erstellen hinzu.
Wiederholen Sie diesen Schritt, bis alle benötigten Seiten und Felder erstellt sind, und speichern Sie anschließend.
Einstellungsmöglichkeiten im Inhaltselement Powermail
- Im Inhaltselement Powermail können Sie im Reiter Plug-In > Einstellungen unterschiedliche Funktionen auswählen, die sich direkt auf das Formular auswirken:
- Bestätigungsseite aktivieren: Erzeugt VOR dem Abschicken des Formulars eine Seite mit allen Formulardaten und erst das Drücken auf den Submit-Button schickt das formular tatsächlich ab.
- E-Mail muss bestätigt werden (Double Opt-In): Eine E-Mail mit einem Bestätigungslink wird an den*die User*in verschickt. Erst wenn der*die User*in den Link anklickt, werden die Formulardaten an Sie übertragen.
- Wo sollen die Mails gespeichert werden? (leer = gleiche Seite): Sollten Sie ein oder wenige Formulare verwenden, ist die gleiche Seite sinnvoll. Sollten Sie mehrere Formulare haben, empfehlen wir das Erstellen verschiedener Ordner pro Formular und die Sammlung der Antworten an einer zentralen Stelle.
Vorhandenes Formular bearbeiten
- Formular bearbeiten: Wenn Sie ein bereits vorhandenes Formular bearbeiten möchten, klicken Sie im Inhaltselement Formular Powermail im Reiter Plug-In bei Formular-Übersicht auf das Stift-Symbol.
E-Mail-Benachrichtigung einrichten
In den Reitern E-Mail an Empfänger und E-Mail an Besucher können festgelegt werden, wohin die Formulardaten gesendet werden.
E-Mail an Empfänger (das sind Sie)
- Empfängertyp: E-Mail-Adressen (voreingestellt).
- Name des Empfängers: Tragen Sie Ihren Namen ein.
- E-Mail Adresse des Empfängers: Tragen Sie Ihre E-Mailadresse oder die des Redaktionsteams ein.
- Betreff der E-Mail an Empfänger: Dieses Feld MUSS ausgefüllt sein, um den E-Mailversand zu aktivieren. Wählen Sie einen aussagekräftigen Betreff, der Ihnen hilft, die E-Mail zuordnen zu können.
- Inhalt der Mail an Empfänger: Die Voreinstellung
{powermail_all}gibt alle ausgefüllten Formulardaten wieder. Sie können auch einzelne Variablen ausgeben, indem Sie {variablen_name} einfügen, um die wichtigsten Informationen voranzustellen. Bsp:{first_name},{matrikel_nummer}. Außerdem können Sie erklärenden Text für sich oder Ihr Redaktionsteam einfügen. (z.B.: Bearbeitungsprozess der Antwort bzw. Schritte im Bearbeitungsprozess)
E-Mail an Besucher
“Dieses Feld beinhaltet die E-Mail des Absenders” muss im Formular beim Feld E-Mailadresse aktiviert sein!
- Name des Absender (Bestätigungs E-Mail an Besucher): Tragen Sie Ihren Namen bzw. den Ihrer Organisationseinheit ein.
- E-Mail Adresse des Absenders (Bestätigungs E-Mail an Besucher): Tragen Sie Ihre E-Mailadresse bzw. die Redaktionsteams ein.
- Betreff der Mail an Absender (Leerer Betreff deaktiviert den Mailversand): Dieses Feld MUSS ausgefüllt sein, um den E-Mailversand zu aktivieren. Wählen Sie einen aussagekräftigen Betreff, der User*innen sinnvoll rückmeldet, dass das Formular erfolgreich abgeschickt wurde.
- Inhalt der Mail an Absender: Die Voreinstellung
{powermail_all}gibt alle ausgefüllten Formulardaten wieder. Sie sollten darüber unbedingt einen kurzen Text einfügen, dass das Absenden des Formulars erfolgreich war und können für eine personalisierte Ansprache einzelne Variablen in den E-Mailtext einbauen. z.B. "Guten Tag,{first_name} {last_name}, danke für die Anmeldung zum Newsletter."
Antwortseite erstellen
Wenn User*innen nach dem Abschicken des Formulars auf eine Antwortseite weitergeleitet werden sollen, können Sie entweder das Textfeld im Tab Antwortseite befüllen
- Option 1: Text auf Antwortseite: Die Voreinstellung
{powermail_all}gibt alle ausgefüllten Formulardaten wieder. Ebenso kann Text hinzugefügt werden. Z.B: “Vielen Dank für Ihre Anmeldung." Achtung: Links werden derzeit nicht als solche ausgezeichnet. Wir empfehlen deswegen: - Option 2: Weiterleitung nach Ausfüllen auf beliebige Seite: Sie können eine eigene Seite erstellen, auf die User*innen nach dem Abschicken weitergeleitet werden. Dort können Sie wie gewohnt alle Inhaltselemente verwenden. Sie können diese Seite über den Link Browser auswählen oder manuell einfügen.
Löschen von Formulardaten
Um mit den persönlichen Daten Ihrer User*innen verantwortungsvoll umzugehen, löschen Sie gespeicherte Formulardaten, sobald diese nicht mehr benötigt werden und keine Aufbewahrungspflichten bestehen. Im Reiter Plug-In unter “Löschen von Formulardaten” können Sie eine Löschungsvariante wählen:
- Wählen Sie einen Löschmodus für die Formulardaten
- Nicht löschen: Löscht die Daten nicht (nicht empfohlen)
- Löschen zu einem bestimmten Datum: Legen Sie das Datum fest, an dem die Formulardaten gelöscht werden sollen.
- Löschen nach X Tagen: Tragen Sie ein, nach wie vielen Tagen die Formulardaten automatisch gelöscht werden sollen.
Hinweis: Per E-Mail versendete Formulardaten und exportierte Dateien werden dadurch nicht gelöscht. Sie müssen diese auch von Ihrem Computer entfernen.
Hinweis
Testen Sie das Formular immer im Frontend, um sicherzustellen, dass Pflichtfelder, Fehlermeldungen und E-Mail-Funktionen richtig funktionieren.
Eingegangene Formulardaten verwalten
Alle über das Formular gesendeten Daten werden im Backend gespeichert und können dort eingesehen oder exportiert werden.
- Öffnen Sie im Seitenbaum die Seite, auf der sich das Formular befindet.
- Wechseln Sie links in das Modul Powermail.
Dort finden Sie den Bereich Formulareingänge mit allen übermittelten Datensätzen. Klicken Sie auf einen Eintrag, um die Details der Einsendung (Feldwerte, Zeitstempel, Formularname usw.) einzusehen.
Alle Einsendungen eines Powermail-Formulars werden automatisch im TYPO3-Backend gespeichert. Die Daten finden Sie im Modul Liste auf jener Seite, auf der das Formular gespeichert wurde. Wenn im Formular-Inhaltselement ein eigener Speicherort angegeben wurde, erscheinen die Einträge dort, ansonsten direkt auf der Seite mit dem Formular.
In den Formulareingängen können Sie jede Einsendung öffnen und alle übermittelten Feldwerte einsehen. Formulardaten können bei Bedarf exportiert werden, zum Beispiel als CSV-Datei für interne Auswertungen. Nicht mehr benötigte Datensätze können gelöscht werden, sofern dies den jeweiligen Aufbewahrungsrichtlinien entspricht.
Gespeicherte Formulardaten und Datenbank
Wenn Nutzer*innen ein Formular im Frontend absenden, werden die eingegebenen Daten auf zwei Wegen verarbeitet:
- Eine E-Mail mit den Formulardaten wird an die im Reiter E-Mail an Empfänger hinterlegte Adresse geschickt.
- Eine Bestätigungsmail geht automatisch an die im Formular angegebene E-Mail-Adresse der absendenden Person, sofern Sie dies aktiviert haben.
Zusätzlich werden alle übermittelten Daten im Backend gespeichert.
Diese Datensätze können direkt in der Elementübersicht eingesehen werden, klicken Sie auf Mehr… um die E-Mail Auflistung im Backend einsehen zu können.
Datenschutz und Barrierefreiheit
Formulare müssen den Datenschutz- und Barrierefreiheitsrichtlinien der Universität Wien entsprechen.
Beachten Sie:
- Verwenden Sie nur notwendige Felder.
- Keine sensiblen Daten abfragen.
- Fügen Sie einen Link zur Datenschutzerklärung hinzu.
- Alle Felder müssen korrekt beschriftet sein.
- Personenbezogene Daten nur solange aufbewahren wie notwendig.
Weitere Anleitungen
Haben Sie noch Fragen?
Sie haben Fragen oder Anmerkungen zu den TYPO3 Anleitungen?