fepli
HandbuchReferenzSystem und DatenschutzAdmins

Exportvorlagen

Mit Exportvorlagen legen Super-Admins eigene Ausgaben für die Angebote einer Saison an: PDF, XML, Word-Datei oder Tabelle.

Ort: Einstellungen > Exporte. Sichtbar für: Super-Admins.

RegelInhalt
ZugriffAlle Seiten unter Exporte sind Super-Admins vorbehalten.
GeltungVorlagen und Schriften gehören zum Mandanten.
Im ExportEine Vorlage mit Im Export anbieten erscheint im Reiter Export einer Saison unter Format im Abschnitt Eigene Vorlagen (Export). Dieselben Vorlagen stehen im Korrekturabzug, auf der Saisonseite und im Export im Hintergrund zur Auswahl.

Vorlagen

Die Seite hat zwei Listen, zwischen denen die Auswahl Vorlagen und Schriften wechselt. Die Zahl dahinter nennt die Einträge der Liste.

ElementInhalt
VorlageName der Vorlage. Darunter steht bei PDF und XML der Dateiname mit der Endung .html.twig oder .xml.twig, bei Word der Name der hochgeladenen Datei oder „noch keine Datei“, bei XLSX der Dateiname mit .xlsx.
AusgabeArt der Vorlage: HTML → PDF, XML, DOCX oder XLSX
Seite · SchriftPDF: Seitenformat, „hoch“ oder „quer“, Grundschrift und Schriftgröße, z. B. „A4 hoch · geist 11 pt“. Word: Zahl der Platzhalter in der Datei. XLSX: Zahl der Spalten und Name des Tabellenblatts. XML: „UTF-8“.
Im Exportangeboten oder Entwurf
GeändertDatum und Name der Person, die zuletzt gespeichert hat
Kennzeichen InstallationDie Vorlage steht in der Konfiguration der Installation und ist nur lesbar.
Neue VorlageMenü mit den 4 Arten; die Wahl legt eine Vorlage als Entwurf an und öffnet den Editor.
Leere Liste„Noch keine Vorlagen.“ mit „Legen Sie eine an – ein Programmheft als PDF, Satzdaten als XML oder eine Word-Datei mit Platzhaltern.“

Über der Liste steht: „Vorlagen sind Twig. Eine PDF-Vorlage schreibt HTML, das mPDF setzt; eine XML-Vorlage wird so ausgegeben, wie sie geschrieben ist; eine DOCX-Vorlage ist eine Word-Datei mit Platzhaltern. Angebotene Vorlagen stehen im Export einer Saison unter „Format“.“

Arten

ArtEintrag in Neue VorlageBeginnt mitErgebnis
PDFPDF aus HTML mit „.html.twig · wird mit mPDF gesetzt“Einer Vorlage mit Titel und Kurzbeschreibung je AngebotPDF, gesetzt mit Seitenformat, Rändern und Grundschrift der Vorlage
XMLXML mit „.xml.twig · wird unverändert ausgegeben“Einer Vorlage mit Nummer und Titel je AngebotXML, so ausgegeben, wie die Vorlage es schreibt
WordDOCX mit „Word-Datei hochladen · Platzhalter werden ersetzt“Keiner DateiWord-Dokument, in dem fepli die Platzhalter ersetzt
TabelleXLSX mit „Spalten zusammenstellen · Felder, Antworten, Formeln“Den Spalten Titel, Veranstalter:innen und TerminExcel-Datei mit einem Tabellenblatt

Eine neue Vorlage heißt Neue PDF-Vorlage, Neue XML-Vorlage, Neue DOCX-Vorlage oder Neue XLSX-Vorlage und ist ein Entwurf.

Vorlagen der Installation

Die PDF- und XML-Ausgaben, die die Installation in ihrer Konfiguration festlegt, stehen mit dem Kennzeichen Installation in der Liste. Word- und Kalenderausgaben der Installation stehen nicht dort.

ElementInhalt
Seite einer Vorlage der InstallationDer Editor zeigt Einstellungen und Quelltext, alle Felder sind gesperrt. Hinweis: „Aus der Installation.“ mit „Steht in {Schlüssel} und ist hier nur lesbar. „Als Vorlage übernehmen“ legt eine bearbeitbare Kopie an.“
Als Vorlage übernehmenLegt eine Kopie mit dem Namen „{Name} (Kopie)“ als Entwurf an und öffnet sie im Editor. Meldung: „„{Name}“ ist angelegt – ein Entwurf, noch nicht im Export.“

Editor

Der Editor hat links die Einstellungen der Vorlage. In der Mitte stehen der Quelltext, die Word-Datei oder die Tabelle. Rechts stehen die Vorschau oder die Variablen.

ElementInhalt
Pfeil nach linksZurück zu den Vorlagen
Name im KopfName der Vorlage; „Ohne Namen“, solange das Feld leer ist
Kennzeichen Nicht gespeichertDer Editor enthält Änderungen, die noch nicht gespeichert sind.
Probe-PDF, Probe-XML, Probe-DOCX, Probe-XLSXErstellt den Export der Saison, die gerade eine Bearbeitungsphase hat, im Hintergrund. Die Datei kommt unter die Glocke. Sie enthält die gespeicherte Fassung, nicht die Änderungen im Editor. Die Schaltfläche ist gesperrt, solange die Vorlage einen Fehler hat.
SpeichernSpeichert die Vorlage. Gesperrt, solange nichts geändert ist.

Einstellungen

FeldBedeutungWerteStandard
NameSo steht die Vorlage im Export. Pflicht.TextNeue PDF-Vorlage usw.
AusgabeArt der Vorlage. Der Wechsel ändert, was die Mitte zeigt.HTML → PDF, XML, DOCX, XLSXArt der neuen Vorlage
Dateiname des ExportsAnfang des Dateinamens. Der Hilfetext lautet „Mit Saison und Datum, z. B. {Beispiel}“.Textexport
TabellenblattName des Blatts in der Excel-Datei. Nur bei XLSX.bis 31 Zeichen, ohne [ ] : * ? / \Angebote
Eine Zeile jeNur bei XLSX. Bei Termin ergibt ein Angebot mit 3 Terminen 3 Zeilen.Angebot, TerminAngebot
SeitenformatNur bei PDFA4, A5, A6A4
Hoch, QuerAusrichtung der Seite. Nur bei PDF.Hoch, QuerHoch
Ränder in mmAbstand zum Seitenrand: Oben, Rechts, Unten, Links. Nur bei PDF.0 bis 4015
GrundschriftSchrift des ganzen Dokuments. Die Auswahl nennt die mitgelieferten und die hochgeladenen Schriften (Schriften). Nur bei PDF.Name einer SchriftGeist
SchriftgrößeIn pt. Nur bei PDF.6 bis 24, in Schritten von 0,511
Im Export anbietenSchaltet die Vorlage im Export einer Saison frei. Ausgeschaltet bleibt sie ein Entwurf.an, ausaus
Vorlage löschenLöscht die Vorlage nach einer Rückfrage: „„{Name}“ löschen?“ mit „Die Vorlage steht dann nicht mehr im Export. Nicht umkehrbar.“ Meldung danach: „„{Name}“ ist gelöscht.“

Speichern

FallMeldung
Vorlage gespeichert, Im Export anbieten an„„{Name}“ ist gespeichert und steht im Export bereit.“
Vorlage gespeichert, Im Export anbieten aus„„{Name}“ ist gespeichert – ein Entwurf, noch nicht im Export.“
Das Feld Name ist leer„Nicht gespeichert: Die Vorlage braucht einen Namen.“
PDF, XML oder XLSX mit Fehler„Nicht gespeichert: {Grund}“ mit dem Fehler der Statuszeile. Eine Word-Vorlage speichert auch mit Warnungen.

PDF- und XML-Vorlagen

In der Mitte steht der Quelltext als Twig, mit Hervorhebung und Zeilennummern. Die Kopfzeile nennt den Dateinamen, z. B. export.html.twig, und „Twig · HTML für mPDF“ oder „Twig · XML“. Die Taste Tab rückt ein.

ElementInhalt
Statuszeile links„Keine Fehler“ oder „Zeile {Zeile}: {Meldung}“. Die fehlerhafte Zeile ist rot markiert.
Statuszeile rechtsZeile und Spalte der Schreibmarke, dazu „Twig 3 · UTF-8“
Auswahl VorschauZeigt das Ergebnis. Über der Vorschau steht bei PDF „{Format} hoch · {Anzahl} Seiten“ und, bei Angeboten der Saison, „{Anzahl} Angebote aus {Saison}“. Hat die Saison keine Angebote, zeigt sie „{Anzahl} Beispielangebote“.
Vorschau PDFDie Seiten, wie die Datei sie hat, in einem abgeschotteten Rahmen
Vorschau XMLDie Meldung „Wohlgeformt · <{Wurzel}> mit {Anzahl} Einträgen“ und darunter der Text der Datei. XML wird erst geschrieben, wenn es wohlgeformt ist; sonst meldet die Vorschau „Ausgabe ist kein gültiges XML: {Meldung}“.
Vorschau bei Fehler„Vorschau nicht möglich“ mit der Meldung und dem Link Zur Zeile {Zeile}
Auswahl VariablenListe der Variablen, die sich einfügen lassen. Ein Eintrag fügt den Text an der Schreibmarke ein. Bei einer Vorlage der Installation ist die Liste nur lesbar.

Variablen

Die PDF-Vorlage erhält die Angebote als items, die XML-Vorlage als offers. In der Tabelle steht list für diese Liste.

VariableInhaltSichtbar in
listAngebote der Auswahl, Saison oder gefilterte Liste. Der Eintrag fügt eine Schleife for offer in … ein.PDF, XML
offer.nameTitelPDF, XML
offer.numberAngebotsnummerPDF, XML
offer.teaserKurzbeschreibungPDF, XML
offer.descriptionBeschreibung als HTMLPDF, XML
offer.datesTermine mit begin und endPDF, XML
offer.minAge, offer.maxAgeAlter von, Alter bisPDF, XML
offer.feeBeitrag in EuroPDF, XML
offer.meetingPointTreffpunktPDF, XML
offer.hostsVeranstalter:innen mit namePDF, XML
offer.categoriesKategorien mit namePDF, XML
offer.propertiesEigene Merkmale mit Im Heft ausgeben, mit label und value (Einstellungen)PDF, XML
edition.nameSaisonPDF, XML
todayDatum des ExportsPDF, XML
imagesLogos der Veranstalter:innen mit path und dimensionsXML
<pagebreak />Neue SeitePDF
{PAGENO} / {nbpg}Seitenzahl in Kopf- oder FußzeilePDF
<htmlpagefooter>Fußzeile auf jeder SeitePDF
var:tenantLogoLogo des Mandanten, z. B. als <img src="var:tenantLogo" height="18mm" />PDF
loop.index, loop.lastZähler in SchleifenPDF, XML
dateFilter, der ein Datum formatiert, z. B. date('d.m.Y')XML
<![CDATA[ … ]]>Text mit SonderzeichenXML

Regeln

RegelInhalt
Zulässiges TwigDas Twig einer Vorlage läuft mit einer begrenzten Auswahl an Tags, Filtern und Funktionen. Aufrufe von Methoden gibt es nicht. Eine Variable, die es nicht gibt, ist ein Fehler.
Bilder und Links im PDFAdressen von Bildern, Links und Stylesheets müssen mit var:, data: oder # beginnen. Fepli entfernt jede andere Adresse. Dateien des Servers kommen nie ins PDF.
Schriften im PDFfont-family nennt den Schlüssel einer Schrift aus der Liste (Schriften).
Angebote im PDF-StudioDas PDF-Studio findet die Seiten der Angebote, wenn die PDF-Vorlage die Angebote in einer Schleife über items schreibt, ein Abschnitt je Angebot. Dafür muss die Vorlage nichts Besonderes enthalten.
Anpassungen aus dem PDF-StudioEine Anpassung gehört zur Vorlage und zum Angebot. Sie gilt in jedem PDF der Vorlage, bis sich das Angebot oder die Vorlage ändert (Herkunft).
MeldungBedeutung
„Variable „{Name}“ gibt es hier nicht.“Die Vorlage nutzt eine unbekannte Variable.
„Ein Feld „{Name}“ gibt es hier nicht.“Die Vorlage greift auf ein Feld zu, das das Angebot nicht hat.
„Filter „{Name}“ gibt es nicht.“, „Funktion „{Name}“ gibt es nicht.“Es gibt keinen Filter oder keine Funktion dieses Namens.
„Tag „{Name}“ ist in Exportvorlagen nicht erlaubt.“, „Filter „{Name}“ ist in Exportvorlagen nicht erlaubt.“, „Funktion „{Name}“ ist in Exportvorlagen nicht erlaubt.“Es gibt das Element, aber Exportvorlagen dürfen es nicht verwenden.
„Ein Block ist nicht geschlossen – fehlt endfor oder endif?“Ein for oder if hat kein Ende.
„Ausgabe ist kein gültiges XML: {Meldung}“Das Ergebnis einer XML-Vorlage ist nicht wohlgeformt.

Word-Vorlagen

Die Mitte zeigt die hochgeladene Datei. Ohne Datei steht dort DOCX-Datei wählen mit „.docx bis 10 MB · ältere .doc bitte in Word als .docx speichern“. Darüber steht: „Gestalten Sie das Dokument in Word und laden Sie es hier hoch. Platzhalter wie ${offer.name} werden beim Export durch Text ersetzt; was zwischen ${offer} und ${/offer} steht, wiederholt sich für jedes Angebot. Schrift, Kopf- und Fußzeile und Logos bleiben, wie sie in Word sind.“

ElementInhalt
DateikarteName der Datei, darunter „{Größe} KB · hochgeladen {Datum} · {Name}“
HerunterladenLädt die gespeicherte Datei herunter.
ErsetzenLädt eine andere Datei hoch und ersetzt die vorige.
Gefundene PlatzhalterJeder Platzhalter der Datei mit seiner Bedeutung, der Zahl seiner Vorkommen und dem Kennzeichen bekannt oder unbekannt. Darüber steht „{Anzahl} verschiedene · alle bekannt“ oder „{Anzahl} verschiedene · {Anzahl} unbekannt“.
Rechte Spalte PlatzhalterListe aller Platzhalter. Ein Eintrag kopiert den Platzhalter in die Zwischenablage und meldet „{Platzhalter} kopiert“.
PlatzhalterInhalt
${offer}Anfang des Blocks, der sich je Angebot wiederholt
${/offer}Ende des Blocks
${offer.name}Titel
${offer.number}Angebotsnummer
${offer.teaser}Kurzbeschreibung
${offer.description}Beschreibung als Text
${offer.date}Termine, z. B. „14.07.2026, 09:30–15:00 Uhr“
${offer.age}Alter, z. B. „10–14 Jahre“
${offer.fee}Beitrag, z. B. „12,00 €“
${offer.meetingPoint}Treffpunkt
${offer.hosts}Veranstalter:innen, durch Komma getrennt
${offer.categories}Kategorien, durch Komma getrennt
${edition.name}Saison, z. B. „Sommerferien 2027“
${today}Datum des Exports
RegelInhalt
FormatierungDie Platzhalter werden durch Text ersetzt, die Formatierung kommt vom Platzhalter in Word.
Tabellenzeile je AngebotSteht der Block in einer Tabellenzeile, wird die Zeile je Angebot vervielfältigt.
Warnung ohne Block„Ohne ${offer} … ${/offer} steht nur das erste Angebot im Dokument.“
Warnung ohne Ende„${offer} ohne ${/offer} – der Block endet nicht.“
Warnung bei unbekanntem Platzhalter„{Namen} kennt fepli nicht; der Export übernimmt den Text unverändert. Prüfen Sie die Schreibweise – die Liste rechts zeigt alle Platzhalter.“
DateienNur .docx, bis 10 MB
MeldungBedeutung
„Nur .docx-Dateien. Ältere .doc bitte in Word als .docx speichern.“Die Datei hat ein anderes Format.
„Die Datei ist größer als 10 MB.“Die Datei ist zu groß.

Die Word-Vorlagen der Instanz mit den Markern ${BLOCK_ANGEBOT} und ${name} stehen unter Export.


XLSX-Vorlagen

Die Mitte zeigt die Tabelle, wie die Datei sie haben wird, berechnet für die ersten Angebote der Saison mit Bearbeitungsphase. Hat die Saison keine Angebote, zeigt sie Beispielangebote. Unter der Tabelle stehen die Einstellungen der gewählten Spalte.

ElementInhalt
Kopfzeile der TabelleName des Blatts, dann „{Anzahl} Spalten · {Anzahl} Beispielangebote“ oder „{Anzahl} Spalten · {Anzahl} Angebote der Saison“. Hat eine Spalte einen Fehler, folgt die Meldung.
SpaltenbuchstabeWählt die Spalte. Berechnete Spalten tragen fx. Ein roter Punkt kennzeichnet eine Spalte mit Fehler.
SpalteMenü mit Angebotsfeld, Fragebogen-Antwort, Berechnung und Kostenaufstellung. Fragebogen-Antwort fehlt, solange es keine Frage gibt, deren Antwort sich übernehmen lässt. Kostenaufstellung fehlt, solange kein Fragebogen eine Kostenaufstellung hat.
Leere Tabelle„Noch keine Spalten. Über „+ Spalte“ anlegen.“

Spalte

FeldBedeutungWerte
ÜberschriftKopf der Spalte in der Datei. Formeln beziehen sich auf sie.Text
Pfeile Nach links, Nach rechtsVerschieben die Spalte
DuplizierenLegt eine Kopie neben der Spalte an
Spalte entfernenEntfernt die Spalte
InhaltArt der SpalteAngebotsfeld, Fragebogen-Antwort, Berechnung
AngebotsfeldWert aus dem Angebot. Nur bei Angebotsfeld.ID, Angebotsnummer, Titel, Veranstalter:innen, Termin, Treffpunkt, Alter von, Alter bis, min. Teilnehmer:innen, max. Teilnehmer:innen, Beitrag, Anmeldung über fepli, Einverständnis erforderlich, Ansprechperson, E-Mail Ansprechperson, Kategorien, Saison
FrageFrage eines Fragebogens, gruppiert nach Fragebogen. Nur bei Fragebogen-Antwort. Gibt es die Frage nicht mehr, steht dort „(Frage gibt es nicht mehr)“.
KostenpositionZeile einer Kostenaufstellung oder Summe aller Positionen. Nur bei einer Frage mit Kostenaufstellung.
Fixe Kosten, je Teilnehmer:inTeil der Zeile: feste Kosten oder Kosten je Teilnehmer:in. Nur bei einer Frage mit Kostenaufstellung.
Summe von Spalten, FormelArt der Berechnung. Nur bei Berechnung.
Spalten addierenSpalten mit Zahlen, die die Summe bilden. Ohne Zahlenspalte steht dort „Noch keine Spalten mit Zahlen.“
FormelAusdruck mit Spalten in eckigen Klammern, z. B. [Fixkosten] + [Var-Kosten] * [max TN]. Erlaubt sind Zahlen, +, −, *, /, Klammern und die Funktionen MIN, MAX und RUNDEN; mehrere Werte stehen durch Semikolon getrennt. Ein Eintrag mit dem Namen einer Spalte fügt den Bezug ein.
FormatDarstellung in ExcelText, Zahl, Euro, Datum und Uhrzeit, Ja/Nein als 1/0
ErgebniszeileZeile unter der Tabelle mit dem Ergebnis der Spaltekeine, Summe, Mittelwert

Eine Spalte mit einem Angebotsfeld beginnt mit dem Format, das zum Feld passt: Euro bei Beitrag, Datum und Uhrzeit bei Termin, Zahl bei Nummern, Altersangaben und Teilnehmerzahlen, Ja/Nein als 1/0 bei Anmeldung über fepli und Einverständnis erforderlich, sonst Text.

Kostenaufstellung

Der Eintrag Kostenaufstellung im Menü Spalte (Beschriftung dort: „alle Positionen fix und je Teilnehmer:in, mit Summen“) legt für jede Zeile der Kostenaufstellung zwei Spalten an, Fix {Zeile} und Var {Zeile}, und dazu die Spalten Fixkosten und Var-Kosten mit den Summen.

Hinweise unter der Spalte

ElementInhalt
In ExcelDie Formel, die die Spalte in der Datei hat, darunter die Herkunft des Werts: „Wert aus dem Angebot: {Feld}.“, „Antwort aus „{Fragebogen}“ · {Frage}. Leer, wenn der Bogen nicht ausgefüllt ist.“ oder „Wird als Excel-Formel gespeichert und rechnet in der Datei mit, wenn jemand Werte ändert.“ Mit einer Ergebniszeile folgt „Ergebniszeile: {Formel}“.
„Beispiel: {Werte}“Die Werte der ersten Angebote, „leer“ ohne Wert
Bezüge„Bezüge gehen über die Überschrift, nicht über die Position: Umsortieren bricht keine Formel, Umbenennen ändert die Bezüge mit.“
MeldungBedeutung
„Keine Spalten gewählt.“Die Tabelle hat keine Spalte.
„Formel fehlt.“Die Berechnung hat keine Formel.
„Spalte „{Name}“ gibt es nicht.“Die Formel nennt eine Überschrift, die keine Spalte hat.
„Zwei Spalten heißen „{Name}“ – der Bezug ist nicht eindeutig.“2 Spalten haben dieselbe Überschrift.
„Erlaubt sind Spalten in [ ], Zahlen, + − * / ( ) und MIN, MAX, RUNDEN.“Die Formel enthält ein anderes Zeichen.
„Die Formel ist unvollständig. Prüfen Sie Klammern, Zahlen und Rechenzeichen.“Eine Klammer, eine Zahl oder ein Rechenzeichen fehlt.
„Die Formel verweist direkt oder über andere Formeln auf sich selbst.“Eine Berechnung verweist auf sich selbst oder 2 Berechnungen verweisen aufeinander.

Schriften

Ort: Einstellungen > Exporte > Schriften.

Über der Liste steht: „Schriften für PDF-Vorlagen. Der CSS-Name ist, was in der Vorlage steht: font-family: swiza; Nur statische TrueType-Dateien (.ttf) – variable Schriften und OTF liest mPDF nicht.“

ElementInhalt
SchriftName, darunter der Schlüssel, den font-family in der Vorlage nutzt.
Kennzeichen mitgeliefert, hochgeladenHerkunft der Schrift. Mitgeliefert sind Geist, Geist Medium, DejaVu Sans, DejaVu Serif und DejaVu Sans Mono.
„in {Anzahl} Vorlagen“, „nicht verwendet“Zahl der Vorlagen, die die Schrift als Grundschrift setzen
MusterzeileBeispieltext in der Schrift
Schnitte4 Felder: Normal (R), Kursiv (I), Fett (B), Fett kursiv (BI). Ein Feld zeigt Dateiname und Größe oder „fehlt“.
+ DateiLädt die Datei für einen fehlenden Schnitt einer hochgeladenen Schrift hoch.
Schriftdateien hochladenLädt eine oder mehrere TrueType-Dateien hoch. Fepli ordnet sie nach dem Dateinamen einer Schrift und einem Schnitt zu.
EntfernenLöscht die Schrift nach der Rückfrage „„{Name}“ entfernen?“ mit „Die Dateien der Schrift werden gelöscht.“ Meldung danach: „„{Name}“ ist entfernt.“ Steht bei einer Schrift in Verwendung: „Erst aus den Vorlagen nehmen“.
RegelInhalt
Zuordnung„Dateinamen werden zugeordnet: Name-Regular.ttf, -Italic, -Bold oder -SemiBold, -BoldItalic. mPDF setzt jedes Gewicht ab 600 mit dem Fett-Schnitt; Medium und Light werden eigene Schriften (name-medium).“
DateitypNur statische TrueType-Dateien (.ttf)
EntfernenEine Schrift lässt sich nur entfernen, wenn keine Vorlage sie als Grundschrift setzt. Mitgelieferte Schriften lassen sich nicht entfernen.
MeldungBedeutung
„{Anzahl} Schriftdateien hochgeladen.“, „Schriftdatei hochgeladen.“Der Upload hat geklappt.
„{Name}: nur statische TrueType-Dateien (.ttf).“Die Datei ist keine TrueType-Datei.
„{Name}: OpenType mit CFF-Konturen (.otf) liest mPDF nicht – bitte die TrueType-Fassung.“Die Datei ist eine OTF-Schrift.
„{Name}: eine variable Schrift – mPDF braucht je Schnitt eine statische Datei.“Die Datei ist eine variable Schrift.
„{Name}: diese Schrift kommt mit fepli und braucht keine Datei.“Die Datei gehört zu einer mitgelieferten Schrift.
„„{Name}“ wird noch in Vorlagen verwendet. Wählen Sie dort zuerst eine andere Schrift.“Die Schrift lässt sich nicht entfernen.