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.

Mail 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') als 31.10.2026 18:30.

Welche Filter es außerdem gibt, steht unter Was du in Vorlagen schreiben kannst.

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 Liste ticketCodes gibt 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, also order.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

Hat das Deine Frage beantwortet? Danke für Dein Feedback Es gab ein Problem beim Absenden Deines Feedbacks

Brauchst Du weitere Hilfe? Schreib uns! Schreib uns!