Vorlagen für Mails und Ticket-PDF in Twig schreiben: Platzhalter, Regeln und Prüfung beim Speichern
Mit den Vorlagen deines Projekts bestimmst du, was in den Mails an Käufer:innen, Gäste und Vertragspartner:innen steht und wie das Ticket-PDF aussieht. Du schreibst sie in Twig: Platzhalter wie {{ order.firstname }} setzen beim Versand die passenden Werte ein, mit {% if %} und {% for %} steuerst du, was wann erscheint. Hier erfährst du, welche Platzhalter es in welcher Vorlage gibt, was du in Vorlagen schreiben kannst und was dir die Prüfung beim Speichern meldet.
Um die Projekteinstellungen zu bearbeiten, brauchst du die Rolle Admin.
Wo du die Vorlagen findest
Öffne Einstellungen → Projekte und klicke beim gewünschten Projekt auf Bearbeiten. Die Vorlagen verteilen sich auf diese Reiter:
| Reiter | Vorlagen |
|---|---|
| Shop | Ticket-Mail, Mail Zahlungsaufforderung (Vorkasse), Mail Zahlungserinnerung (Vorkasse), Mail Zahlungseingang (Physische Produkte), Mail Bestellung storniert, Mail Ticketrückgabe, Mail Erstattungsanfrage, Mail Erstattung ausgeführt |
| Tickets | Ticketersatz-Mail, Ticket-Mail (ohne Bestellung), Person ausgeladen, PDF Ticketvorlage |
| Vorlagen | Mail Layout, Mail Coupons, Mail Termine, Mail Gästeliste Shoplink |
| Verträge | die sechs E-Mails rund um Verträge mit ihrem Betreff, etwa E-Mail: Vertragsunterzeichnung |
Die Betreffzeilen der Bestell-, Ticket- und Personenmails sind keine Vorlagen: Ein {{ … }} darin stünde wörtlich im Betreff. Platzhalter im Betreff kennen nur die Vertragsmails.
Platzhalter in allen Mails
Diese Platzhalter gibt es in jeder Mail und im Mail Layout:
| Platzhalter | Inhalt |
|---|---|
setting.… |
Angaben aus den Einstellungen: Shop-Adresse (setting.orders_shop_url), Name und Pronomen der Veranstaltung (setting.general_frontend_event_name), Firmen- und Bankdaten (setting.company_name, setting.company_bank_account_iban), Grußformel (setting.general_email_regards), Absendername und AGB-Adresse. Leer, wenn nicht ausgefüllt. Andere Einstellungen gibt es in Vorlagen nicht. |
mail_logo_url, mail_logo_alt |
das E-Mail-Logo des Projekts, leer ohne Logo |
email_imprint |
das E-Mail-Impressum des Projekts |
link_to_portal, link_to_shop |
ein fertiger Link zum Portal bzw. Shop der Person, um die es in der Mail geht, siehe Links und QR-Codes |
Platzhalter je Mail
Zusätzlich hat jede Mail eigene Platzhalter. Die Adressen (linkToTicketPortal, shopRoute, calendarRoute) sind reine Adressen: Für einen Link setzt du sie in <a href="…"> ein.
| Platzhalter | |
|---|---|
| Ticket-Mail, Zahlungsaufforderung, Zahlungserinnerung, Zahlungseingang, Bestellung storniert, Ticketrückgabe | order (die Bestellung), linkToTicketPortal (Adresse des Ticketportals), girocode (der GiroCode als Bild) |
| Ticketersatz-Mail | wie oben, dazu ticketCode (erstes gültiges Ticket der Bestellung) und ticketCodes (alle Tickets ohne annullierte) |
| Ticket-Mail (ohne Bestellung) | ticketCode, ticketCodes, linkToTicketPortal |
| Mail Erstattungsanfrage, Mail Erstattung ausgeführt | order, request (die Erstattung), refundAmount (Betrag), linkToTicketPortal |
| Mail Coupons | firstname, lastname, coupons (Liste), shopRoute (Shop-Adresse) |
| Mail Termine | firstname, lastname, person, calendarText (Terminübersicht), calendarRoute (Kalender-Adresse) |
| Mail Gästeliste Shoplink | firstname, lastname, shopRoute |
| Person ausgeladen | person |
In Mail Termine gibt es außerdem teams_suggested, teams_assigned und teams_confirmed: die Namen der vorgeschlagenen, eingeteilten bzw. bestätigten Teams der Person, durch Komma getrennt, oder -, wenn es keine gibt.
Wie du den GiroCode einsetzt und wann er leer bleibt, steht in GiroCode: Überweisung per QR-Code in der Zahlungsmail.
Was in Bestellungen, Tickets und Personen steckt
Hinter order, ticketCode und person stehen alle Felder des Datensatzes. Bei Personen und Gruppen gehören dazu alle Formularfelder deines Projekts; ein Feld, das nie ausgefüllt wurde, ist leer. Außerdem erreichst du:
| Platzhalter | Enthält außerdem |
|---|---|
order |
order_positions (Liste der Positionen), person (Besteller:in), total_price, currency_symbol, has_offline_positions |
eine Position aus order.order_positions |
offer (das Produkt), ticket_type (die Ticketart), product_name |
ticketCode |
owner (Inhaber:in des Tickets), issuable (wer das Ticket ausgestellt hat), ticket_type, ticket_type_name, order_position |
ticketCode.issuable |
eine Person mit firstname, lastname und fullname, oder ein Zugang zum Admin-Bereich, dann ist nur name gefüllt |
eine Person (person, order.person, ticketCode.owner) |
host (die einladende Person eines Gastes, sonst leer), portal_url, die Links und QR-Codes sowie applicationsAsOwner (Gruppen, deren Ansprechperson sie ist) und applicationsAsMember (Gruppen, in denen sie Mitglied ist) |
eine Gruppe aus applicationsAsOwner oder applicationsAsMember |
name und owner (die Ansprechperson der Gruppe, mit firstname, lastname, fullname) |
eine Erstattung (request) |
items (Liste, jeweils mit offer und order_position) |
Listen liest du mit {% for %}:
{% for pos in order.order_positions %}
{{ pos.product_name }}: {{ pos.offer.price|number_format(2, ',', '.') }} {{ order.currency_symbol }}
{% endfor %}
So stellst du jede Bestellübersicht selbst zusammen.
Genauso nennst du etwa die Ansprechperson, die einen Gast angemeldet hat:
{% for gruppe in ticketCode.owner.applicationsAsMember %}
{{ gruppe.owner.fullname }} hat dich für {{ gruppe.name }} angemeldet.
{% endfor %}
Werte formatieren und berechnen
Beträge, Datumsangaben und Listen bringst du mit Filtern in die gewünschte Form:
| Du möchtest | So schreibst du es |
|---|---|
| einen Betrag mit zwei Nachkommastellen | {{ order.total_price|number_format(2, ',', '.') }} |
| ein Datum formatieren | {{ order.created_at|date('d.m.Y H:i') }} |
| das heutige Datum | {{ date()|date('d.m.Y') }} |
| einen Abschnitt nur unter einer Bedingung zeigen | {% if order.has_offline_positions %} … {% endif %} |
| eine Liste zu einem Text verbinden oder einen Text teilen | |join(', ') bzw. |split(',') |
| die Anzahl oder den ersten Eintrag einer Liste | |length bzw. |first |
| einen Wert zwischenspeichern | {% set summe = … %} |
| eine Einstellung wie die Shop-Adresse | setting.…, siehe Platzhalter in allen Mails |
Ein Datum erscheint ohne Filter als
2026-10-31 18:30:00, mit|date('d.m.Y H:i')als31.10.2026 18:30.
Welche Filter es außerdem gibt, steht unter Was du in Vorlagen schreiben kannst.
Links und QR-Codes, ohne HTML zu schreiben
Links zum Portal oder Shop und QR-Codes gibt es als fertige Platzhalter. Sie erscheinen als klickbarer Link bzw. als Bild, HTML brauchst du dafür nicht. Die Namen sind dieselben wie in den Nachrichten an Personen und Gruppen:
| Platzhalter | Ergebnis |
|---|---|
link_to_portal |
fertiger Link zum Mitwirkendenportal |
link_to_shop |
fertiger Link zum persönlichen Shop |
link_to_portal_text, link_to_shop_text |
nur die Adresse, etwa für einen eigenen Button |
pass_number_qr_code |
QR-Code der Passnummer als Bild |
uuid_qr_code |
QR-Code der Personenkennung als Bild |
portal_link_qr_code |
QR-Code mit dem Portal-Link als Bild |
{{ link_to_portal }} und {{ link_to_shop }} ohne Pfad gelten für die Person, um die es in der Mail geht: in Bestell- und Erstattungsmails die Besteller:in, in Ticketmails die Inhaber:in des Tickets, in Mail Termine und Person ausgeladen die angeschriebene Person. In Mail Coupons und Mail Gästeliste Shoplink gibt es sie nicht, dort nimmst du shopRoute.
Für eine bestimmte Person schreibst du den Pfad dazu, etwa {{ order.person.link_to_portal }} oder {{ ticketCode.owner.pass_number_qr_code }}.
Schreib diese Platzhalter immer mit vollem Pfad. Über einen Zwischenschritt wie
{% set p = order.person %}{{ p.link_to_portal }}bleiben sie leer, darauf weist dich die Prüfung beim Speichern hin. In der ListeticketCodesgibt es sie nicht.
Wie Portal und Shop für deine Gäste aussehen, erklären Das Mitwirkenden-Portal und Das Ticketportal.
|raw ist erlaubt, ändert aber nichts
Aus den Nachrichten kennst du vielleicht {{ link_to_portal|raw }}. Das darfst du in Vorlagen weiter schreiben, |raw hat dort aber keine Wirkung:
- Links, QR-Codes, GiroCode, Impressum und Terminübersicht erscheinen immer als HTML, mit oder ohne
|raw. - Was Käufer:innen, Gäste oder Mitwirkende selbst eingetippt haben (Namen, Adressen, Formularfelder, Notizen), erscheint immer als reiner Text, auch mit
|raw.
So kann niemand über ein Formularfeld eigenes HTML in deine Mail oder dein Ticket-PDF schmuggeln, etwa einen fremden Link unter deinem Absender. Eigenes HTML schreibst du direkt in die Vorlage.
Deine Vorlagen aus den Nachrichten funktionieren damit unverändert, und die Eingaben deiner Gäste bleiben harmlos.
Das Mail Layout
Das Mail Layout im Reiter Vorlagen legt den Rahmen um alle Mails des Projekts. An die Stelle {{ content }} setzt festiware den Inhalt der jeweiligen Mail. Ein Logo baust du so ein:
{% if mail_logo_url %}
<div style="text-align: center; padding: 24px 20px 4px 20px;">
<img src="{{ mail_logo_url }}" alt="{{ mail_logo_alt }}" width="300" style="max-width: 100%; height: auto; border: 0;">
</div>
{% endif %}
Das Layout gilt auch für Benachrichtigungen ohne eigene Platzhalter. Ein Platzhalter einer bestimmten Mail, etwa order, bliebe dort leer. Nutze im Layout deshalb nur die Platzhalter aller Mails.
Wie du ein eigenes Layout anlegst und zum Standard zurückkehrst, steht in Projekteinstellungen.
Die PDF Ticketvorlage
Die PDF Ticketvorlage im Reiter Tickets bestimmt Text und Aufbau des Ticket-PDFs. Sie kennt:
| Platzhalter | Inhalt |
|---|---|
ticketCode |
das Ticket, mit owner (Inhaber:in, inklusive Formularfeldern), ticket_type und order_position |
qrCode |
der QR-Code des Tickets als Bildquelle: <img src="{{ qrCode }}"> |
background |
die Hintergrundgrafik als Bildquelle |
festiwareLogo |
das festiware-Logo |
agb |
Adresse der AGB |
swappable |
ja, wenn das Ticket über TicketSwap weiterverkauft werden kann, etwa für {% if swappable %} … {% endif %} |
setting.…, email_imprint |
wie in den Mails |
storage_files['…'] |
Schriften und Bilder aus dem Speicher deiner Instanz, etwa {{ storage_files['fonts/Ubuntu-L.ttf'] }} (ohne / am Anfang) |
Die Hintergrundgrafik selbst tauschst du wie in Hintergrundgrafiken für Tickets ändern beschrieben.
Die Vertragsmails
Die E-Mails im Reiter Verträge und ihre Betreffzeilen kennen diese Platzhalter: contractNumber, firstname, lastname, eventName, sender, signingUrl (Adresse zum Unterschreiben oder Ansehen) und contractTypeName. setting.… und email_imprint gibt es hier nicht. Der Betreff erscheint als reiner Text.
Hallo {{ firstname }},
bitte unterschreibe deinen {{ contractTypeName }} für {{ eventName }}:
<a href="{{ signingUrl }}">Vertrag ansehen und unterschreiben</a>
Welche Vertragsmail wann verschickt wird, erklärt E-Mails zur Vertragsunterzeichnung bearbeiten.
Was du in Vorlagen schreiben kannst
Vorlagen kennen eine feste Auswahl an Befehlen, Filtern und Funktionen:
| Art | Erlaubt |
|---|---|
| Befehle | if, for, set, verbatim (zeigt Twig-Code als Text an, ohne ihn auszuführen) |
| Filter | escape/e, upper, lower, capitalize, title, trim, default, length, first, last, join, replace, nl2br, number_format, round, abs, format, striptags, slice, split, date, date_modify, format_date, format_datetime, format_number, format_currency, as_hours, to_int_list, json_encode, url_encode, keys, reverse, merge, sort, map, sum, force_to_int, force_to_float, get und raw (ohne Wirkung) |
| Funktionen | date, diff_minutes, max, min, range (auch 1..3, höchstens 1.000 Einträge), random, cycle |
Mit get liest du einen Wert über einen Pfad, etwa {{ order.person|get('data.feld') }}. Den Pfad darin prüft festiware beim Speichern nicht: Ein Tippfehler fällt erst auf, wenn die Stelle in der Mail leer bleibt.
Alles andere lehnt die Prüfung beim Speichern ab:
- Andere Vorlagen laden (
include,extends,embed,block,import,macro): Layout und Inhalt setzt festiware selbst zusammen, über das Mail Layout und{{ content }}. - Schutz abschalten (
autoescape): Die Eingaben deiner Gäste kämen wieder als HTML durch, siehe|raw. - Mehr lesen, als die Vorlage braucht (
dump,constant,projectsetting()): Das könnte Daten oder Einstellungen ausgeben, die nicht in eine Mail gehören. - Methoden aufrufen (
order.person.getName()): Vorlagen sehen nur fertige Werte. Schreib den Wert ohne Klammern, alsoorder.person.firstname.
Fehlt dir etwas, schreib uns an den Support.
Die Prüfung beim Speichern
Wenn du eine Vorlage änderst und das Projekt speicherst, prüft festiware sie vorher. Findet die Prüfung etwas, steht unter dem Feld eine Liste mit Zeilennummern, und das Projekt wird erst gespeichert, wenn alles behoben ist. Ab dem elften Hinweis fasst die Liste den Rest zusammen („… und 3 weitere Hinweise.“). Oft verschwinden mit der ersten Korrektur gleich mehrere.
Die Prüfung findet Tippfehler, Platzhalter, die es in dieser Vorlage nicht gibt, nicht erlaubte Befehle und Filter sowie Syntaxfehler. Typische Meldungen:
| Meldung | Was du tust |
|---|---|
| Zeile 1: Den Platzhalter „order.persn“ gibt es in dieser Vorlage nicht. Gemeint ist vermutlich „person“. | Tippfehler korrigieren: order.person. |
| Zeile 6: Den Platzhalter „pos.offer.prise“ gibt es in dieser Vorlage nicht. Gemeint ist vermutlich „price“. „is defined“, „|default“ oder „??“ ändern daran nichts, die Stelle bliebe immer leer. | Den richtigen Namen schreiben. Ein |default rettet einen falschen Namen nicht. |
| Zeile 9: Der Filter „filter“ ist in Vorlagen nicht erlaubt. Erlaubt: … | Einen der genannten Filter nehmen oder die Stelle mit {% if %} lösen. |
| Zeile 11: „getName()“ ist ein Methodenaufruf. Platzhalter sind reine Werte, bitte ohne Klammern schreiben. | Den Wert direkt schreiben, etwa order.person.firstname. |
| Zeile 12: „o.portal_url“ bliebe immer leer: „portal_url“ wird nur berechnet, wenn die Vorlage es mit dem Pfad „owner.portal_url“ schreibt, nicht über eine Variable aus {% set %} oder mit ['…']. | Den vollen Pfad schreiben: ticketCode.owner.portal_url. |
| Zeile 14: „order.order_positions“ ist eine Liste, „.offer“ geht darauf nicht. … | Die Liste mit {% for %} durchgehen oder mit |first den ersten Eintrag nehmen. |
| Zeile 3: „order.created_at“ ist ein einfacher Wert und hat kein „timestamp“. | Den Wert mit einem Filter umformen, etwa |date('U'). |
| Zeile 2: Syntaxfehler: … | Meist fehlt in oder vor der genannten Zeile ein {% endif %}, {% endfor %} oder eine schließende Klammer. |
Nicht prüfen lassen sich beim Speichern:
- Pfade hinter dem Filter
get - Namen in Formularfeldern, die mehrere Werte enthalten
- Werte, die erst beim Versand fehlen, etwa ein Ticket in einer Bestellung ohne gültige Tickets
- Formularfelder, die nach dem Speichern der Vorlage aus einem Formular entfernt wurden
Für diese Fälle gibt es die Meldung beim Versand.
Eine Vorlage, die du nicht anfasst, wird beim Speichern anderer Einstellungen nicht geprüft. Andere Felder im Projekt kannst du also jederzeit ändern.
Bleibt die Liste leer, ist deine Vorlage gespeichert und bereit für den Versand.
Wenn beim Versand etwas nicht stimmt
Findet festiware beim Versand einen Platzhalter, den es nicht gibt, geht die Mail trotzdem raus, an dieser Stelle steht dann nichts. Alle Admins der Instanz bekommen eine Benachrichtigung im Admin-Bereich, einmal am Tag je Vorlage und Platzhalter:
Vorlage 'Ticket-Mail' (Projekt Mein Festival 2026) verwendet den unbekannten Platzhalter … Sie wurde ohne diesen Wert erstellt und versendet. Bitte die Vorlage korrigieren.
Lässt sich eine Vorlage gar nicht darstellen, etwa wegen eines Syntaxfehlers, geht die Mail bzw. das Ticket-PDF nicht raus. Auch dann bekommen die Admins eine Benachrichtigung, und beim Versand von Tickets nennt die Rückmeldung die betroffene Vorlage.
Öffne in beiden Fällen die genannte Vorlage, korrigiere sie und speichere. So erfährst du von einem Fehler, bevor sich Gäste bei dir melden.
Tipps
- Prüfe eine geänderte Mail, indem du sie an dich selbst schickst, etwa über Ticket Codes einer Bestellung per E-Mail versenden bei einer Testbestellung. Im E-Mail Sendeprotokoll siehst du, was verschickt wurde.
- Bearbeitest du eine Vorlage im Editor mit Formatierung, setz Befehle wie
{% if %}in ein Widget. Sonst fügt der Editor HTML in den Befehl ein, und die Prüfung meldet einen Syntaxfehler, etwa wegen&. Wie das geht, zeigt twig-Formeln in Vorlagen, Verträgen, PDFs & co. im Editor richtig einsetzen. - Die Grundlagen der Twig-Schreibweise gelten auch für Berechnungsfelder, die Referenz dazu steht in Berechnungsfelder – Twig-Referenz.