Die Aktion 'Als PDF exportieren'
Mit der Aktion 'Als PDF exportieren' ist es möglich, visuell ansprechende und frei definierbare PDFs mit Infos über Personen und Gruppen zu erstellen. Z.B. für Informations-Handouts für Artists, Programmberichte für Partner, Info-Sheets für andere Abteilungen (z.B. Technik) usw.
Die Aktion wird nur angezeigt wenn für den aktuell angezeigten Personen- oder Gruppentyp mindestens eine PDF-Vorlage existiert oder mindestens ein Dateifeld im Formular vorhanden ist.

Vorlagenerstellung
Die Vorlagen für die PDF-Exporte können unter 'alle Einstellungen' > 'PDF Vorlagen' und 'PDF Layouts' erstellt und bearbeitet werden. Hierzu kann der visuelle Editor genutzt werden und Platzhalter genutzt werden. Eine Vorlage hat immer ein Layout, z.B. für die Definition von Styles, die in mehreren Vorlagen genutzt werden können. Außerdem ist eine Vorlage immer mit einem Personen- oder Gruppentyp oder mit Bereichen verknüpft (siehe PDF-Export für Bereiche).
Für weiter reichende Layout-Anpassungen, als dies unser Editor ermöglicht, sind HTML- und CSS-Kenntnisse notwendig.
Platzhalter formatieren
Mit der Checkbox Platzhalter formatieren legst du fest, ob im PDF das steht, was deine Teilnehmenden im Formular gesehen haben, oder das, was festiware intern abspeichert.
Ein Beispiel: Du hast im Formular ein Auswahlfeld „Anreise“ mit der Option Mit der Bahn. Intern speichert festiware dafür nur einen Kurzwert, zum Beispiel bahn .
- Checkbox eingeschaltet: Im PDF steht Mit der Bahn, also genau der Text, den man im Formular auswählen kann. Das ist in den allermeisten Fällen das, was du willst.
- Checkbox ausgeschaltet: Im PDF steht
bahn, also der interne Kurzwert.
So findest du die Checkbox: Sie erscheint in der PDF-Vorlage erst, wenn unter Verknüpftes Element ein Personentyp, Gruppentyp oder Bereich ausgewählt ist und die Vorlage dann einmal gespeichert wurde (damit die Platzhalter geladen werden). Die Checkbox ist standardmäßig erstmal ausgeschaltet. Setze den Haken dann selbst, damit im PDF die lesbaren Texte stehen. Das gilt auch für ältere Vorlagen von Personentypen.
Tipp: Steht in deinem PDF ein seltsamer Kurzwert statt des Textes, den du erwartest, prüfe zuerst diese Checkbox.
Für Fortgeschrittene: Was sich in Twig ändert
Platzhalter schreibst du in der Vorlage mit doppelten geschweiften Klammern, zum Beispiel {{ anreise }} . Diese Schreibweise gibt einen einzelnen Wert direkt als Text aus.
- Eingeschaltet: Alle Felder kommen bereits als fertiger Text an. Auch Felder mit mehreren Werten, etwa eine Mehrfachauswahl, kannst du direkt mit
{{ feldname }}ausgeben. - Ausgeschaltet: Die Felder kommen mit ihren internen Werten an. Eine Mehrfachauswahl ist dann eine Liste mit mehreren Einträgen. Die lässt sich nicht direkt mit
{{ }}ausgeben, sondern nur mit Twig weiterverarbeiten, zum Beispiel mit einer Schleife:{% for wert in feldname %}{{ wert }}{% endfor %}. Das ist nur sinnvoll, wenn du in der Vorlage bewusst mit den internen Werten rechnen oder vergleichen willst.
Vorlage direkt im Editor ausprobieren
Während du an einer PDF-Vorlage arbeitest, willst du natürlich wissen, ob die Platzhalter sich richtig auflösen, ob das Layout passt und ob das fertige Dokument lesbar aussieht. Unter dem Code-Editor findest du dafür zwei Symbole: ein Download-Icon und ein Zahnrad.

So gehst du vor:
- Klicke aufs Zahnrad, um die Vorschau-Einstellungen zu öffnen.
- Wähle eine Person oder Gruppe als Beispieldaten. Welche Auswahl angeboten wird, hängt vom Typ der Vorlage ab (Personen-Typ vs. Gruppen-Typ — siehe Verknüpftes Element weiter unten in der Vorlage).
- Wähle das Format: PDF für den endgültigen Look, HTML für schnelle Iterationen ohne PDF-Rendering.
- Speichern — die Auswahl bleibt an der Vorlage hängen, du musst sie also nicht jedes Mal neu treffen.
- Klick aufs Download-Icon lädt den aktuell sichtbaren (auch ungespeicherten) Vorlagentext mit den gewählten Beispieldaten herunter.
Gut zu wissen:
- Lässt du Person bzw. Gruppe leer, bleiben die jeweiligen Platzhalter im PDF leer — praktisch, um die reine Struktur zu prüfen.
- Die Vorschau funktioniert nur für Twig-Vorlagen (der Standard für neue Vorlagen). Bei den älteren Blade-Vorlagen erscheint die Toolbar nicht.
- Die Vorschau erzeugt nichts auf dem Server — kein Eintrag in den Exporten, kein Versand, keine Spuren im Audit-Log.
Optionen im Aktionsfenster
In eine Datei zusammenfassen
Hier werden statt standardmäßig eine PDF pro Person/Gruppe alle Einträge hintereinander in eine PDF zusammengefasst. Diese Option wird nur angezeigt wenn mehr als ein Eintrag ausgewählt wurde.
Ohne Seitenumbrüche
Beim zusammengefassten Export sorgt dieser Schalter dafür, dass nicht für jeden Eintrag eine neue Seite begonnen wird, sondern die Einträge fortlaufend ausgegeben werden.
Reihenfolge
Über die Option 'Reihenfolge' kann festgelegt werden, in welcher Sortierung die ausgewählten Personen/Gruppen im fortlaufenden Export ('in eine Datei zusammenfassen') ausgegeben werden.
Word-Export
Statt Exporten im PDF-Format können stattdessen auch Word-Dateien erstellt werden. Dieser Modus ist allerdings experimentell und bietet nur sehr eingeschränkte Möglichkeiten, was das Styling / Layout der Exporte betrifft. Viele HTML- und CSS-Funktionen werden hier nicht korrekt wiedergegeben.
Folgende Dateien mitexportieren
Neben der Erstellung von PDF-Dateien kann die Aktion auch dazu genutzt werden, Anhänge der ausgewählten Personen/Gruppen herunterzuladen. Diese Option wird nur angezeigt wenn mindestens ein Dateifeld im Formular des aktuellen Personen-Gruppentyps vorhanden ist.
Wenn ausschließlich der Anhänge-Download gewünscht ist, kann als Export-Vorlage 'Ohne Vorlage (nur Dateien exportieren)' gewählt werden.
PDF-Export für Bereiche
Auch für Bereiche kannst du PDFs erstellen, zum Beispiel einen Zeitplan mit allen Ereignissen pro Bühne oder Spielstätte. Lege dazu eine PDF-Vorlage an und wähle unter Verknüpftes Element einen Bereich aus. Die Vorlage steht danach für alle Bereiche des Projekts zur Auswahl, nicht nur für den gewählten. In der Übersicht der Bereiche steht dir dann die Aktion PDF exportieren zur Verfügung.
In der Vorlage hast du Zugriff auf die Ereignisse des Bereichs. Die Ereignisse seiner direkten Unterbereiche sind automatisch mit enthalten, alles sortiert nach Startzeit.
Zusätzliche Optionen beim Bereichs-Export
- Ereignisse ab / Ereignisse bis: Nur Ereignisse, die in diesem Zeitraum beginnen, kommen in den Export. Beide Tage zählen voll mit. Lässt du die Felder leer, werden alle Ereignisse ausgegeben. So brauchst du für verschiedene Zeiträume keine eigenen Vorlagen.
- Bereiche ohne Termine überspringen: Bereiche, die im gewählten Zeitraum keine Ereignisse haben, werden nicht exportiert.
- Ereignisarten: Nur Ereignisse der ausgewählten Arten kommen in den Export. Leer lassen für alle. Das Feld erscheint nur, wenn im Projekt Ereignisarten angelegt sind.
Die Option Reihenfolge gibt es beim Bereichs-Export nicht.
Gut zu wissen: Jeder Bereich wird einzeln ausgegeben
Die Vorlage wird für jeden ausgewählten Bereich einzeln angewendet, auch wenn du In eine Datei zusammenfassen nutzt. Wählst du einen übergeordneten Bereich und zusätzlich seine Unterbereiche aus, erscheinen deren Ereignisse deshalb mehrfach: einmal beim übergeordneten Bereich und noch einmal beim Unterbereich selbst. Wähle in diesem Fall nur den übergeordneten Bereich aus.
Alle Bereiche in einer gemeinsamen Tabelle
Soll am Ende ein einziger Zeitplan über alle ausgewählten Bereiche herauskommen, sammelst du die Ereignisse in der Vorlage mit collect_push und gibst sie erst im PDF-Layout mit collect_get aus. Die Vorlage selbst gibt dann nichts aus, sie legt nur ab:
{% for ereignis in events %}
{% do collect_push('zeitplan', {
'sort_key': ereignis.start_at|date('YmdHi'),
'uhrzeit': ereignis.start_at|date('H:i'),
'ort': ereignis.area.name,
'name': ereignis.name
}) %}
{% endfor %}
Im Layout, nach {% block content %}{% endblock %} :
{% set zeitplan = collect_get('zeitplan')|sort((a, b) => a.sort_key > b.sort_key ? 1 : -1) %}
{% for e in zeitplan %}
{{ e.uhrzeit }} – {{ e.name }} ({{ e.ort }})<br>
{% endfor %}
Nutze dafür In eine Datei zusammenfassen. Wählst du Ober- und Unterbereiche zusammen aus, landen Ereignisse doppelt in der Sammlung. Filtere sie dann im Layout heraus, zum Beispiel über eine Kombination aus Startzeit, Ort und Name. Mehr zu den beiden Funktionen steht in der Twig-Referenz.