fepli
HandbuchReferenzSystem und DatenschutzAdmins

PDF- und XML-Vorlagen

Eine PDF-Vorlage legt fest, wie das Programmheft aussieht. Eine XML-Vorlage liefert dieselben Angaben als Daten, etwa für ein Satzprogramm.

Beide Arten schreiben Sie im Editor der Exportvorlagen in Twig, einer Sprache für Vorlagen. Was für alle Vorlagen gilt, steht dort.


Was fepli aus der Vorlage macht

Eine PDF-Vorlage schreibt HTML, die Sprache von Webseiten. fepli setzt daraus mit dem Programm mPDF die Seiten des PDF. Eine XML-Vorlage wird so ausgegeben, wie sie geschrieben ist. fepli schreibt die Datei aber erst, wenn das XML wohlgeformt ist, also jedes Element richtig geöffnet und geschlossen.


Seite und Schrift

Diese Einstellungen hat nur eine PDF-Vorlage.

FeldBedeutungWerteStandard
SeitenformatGröße der SeiteA4, A5, A6A4
Hoch, QuerAusrichtung der SeiteHoch, QuerHoch
Ränder in mmAbstand zum Seitenrand: Oben, Rechts, Unten, Links0 bis 4015
GrundschriftSchrift des ganzen Dokuments, aus den mitgelieferten und den hochgeladenen SchriftenName einer SchriftGeist
SchriftgrößeGröße der Grundschrift in Punkt (pt)6 bis 24, in Schritten von 0,511

Quelltext und Vorschau

In der Mitte steht der Quelltext der Vorlage mit Zeilennummern. Darunter steht in der Statuszeile „Keine Fehler“ oder „Zeile {Zeile}: {Meldung}“; die fehlerhafte Zeile ist rot markiert.

Rechts wechseln Sie zwischen zwei Ansichten:

AnsichtInhalt
VorschauDas Ergebnis mit den ersten Angeboten der Saison, die gerade eine Bearbeitungsphase hat. Hat sie keine Angebote, nimmt fepli Beispielangebote. Ein PDF erscheint mit seinen Seiten, ein XML als Text.
VariablenDie Angaben, die sich einfügen lassen (Variablen). Ein Eintrag fügt seinen Text an der Schreibmarke ein.

Hat die Vorlage einen Fehler, zeigt die Vorschau „Vorschau nicht möglich“ mit der Meldung und dem Link Zur Zeile {Zeile}.


Variablen

Eine Variable ist ein Platzhalter, an dessen Stelle fepli eine Angabe des Angebots setzt. Die PDF-Vorlage erhält die Angebote als items, die XML-Vorlage als offers. In der Tabelle steht list für diese Liste.

VariableInhaltGilt in
listDie Angebote des Exports. Der Eintrag fügt eine Schleife for offer in … ein, die sich je Angebot wiederholt.PDF, XML
offer.nameTitelPDF, XML
offer.numberAngebotsnummerPDF, XML
offer.teaserKurzbeschreibungPDF, XML
offer.descriptionBeschreibung, aufbereitet wie auf der Website. Eingebettetes HTML und unsichere Links entfallen.PDF, XML
offer.datesTermine mit begin und endPDF, XML
offer.minAge, offer.maxAgeAlter von, Alter bisPDF, XML
offer.feeBeitrag in Euro oder Franken, wie eingestelltPDF, XML
offer.meetingPointTreffpunktPDF, XML
offer.bringMitbringenPDF, XML
offer.applyTextHinweis zur Anmeldung, wenn sie nicht über fepli läuftPDF, 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 der Instanz, z. B. <img src="var:tenantLogo" height="18mm" />PDF
loop.index, loop.lastZähler in SchleifenPDF, XML
dateFormatiert ein Datum, z. B. date('d.m.Y')XML
<![CDATA[ … ]]>Text mit SonderzeichenXML

Regeln

RegelInhalt
Erlaubtes TwigEine Vorlage darf nur eine Auswahl der Befehle von Twig nutzen. Eine Variable, die es nicht gibt, ist ein Fehler.
Bilder und Links im PDFIhre Adressen 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 Namen einer Schrift aus den Schriften.
Farben für den Druckcmyk(C, M, Y, K) mit Werten von 0 bis 100, z. B. color: cmyk(0, 85, 90, 0). Das PDF enthält sie in CMYK, Vorschau und PDF-Studio zeigen sie angenähert. Bilder behalten ihre Farben.
PDF-StudioDas PDF-Studio findet die Seiten der Angebote, wenn die Vorlage sie in einer Schleife über items schreibt, ein Abschnitt je Angebot.
Anpassungen aus dem PDF-StudioGelten für diese Vorlage und dieses Angebot, bis sich eins von beiden ändert (Herkunft).

Meldungen

MeldungBedeutung
„Variable „{Name}“ gibt es hier nicht.“Die Vorlage nutzt eine Variable, die es nicht gibt. Die Liste Variablen zeigt die richtigen Namen.
„Ein Feld „{Name}“ gibt es hier nicht.“Das Angebot hat kein Feld dieses Namens.
„Filter „{Name}“ gibt es nicht.“, „Funktion „{Name}“ gibt es nicht.“Twig kennt keinen Befehl dieses Namens.
„Tag „{Name}“ ist in Exportvorlagen nicht erlaubt.“, auch für Filter und FunktionenDen Befehl gibt es, aber Exportvorlagen dürfen ihn nicht nutzen.
„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. fepli schreibt die Datei nicht.