Texte formatieren

Was sind Platzhalter & Befehle?

Verwende Platzhalter und Befehle, um Texte auf Rechnungen, Gutschriften und in E-Mails dynamisch zu erzeugen und zu formatieren.

Siehst du eine Raute bei einer Einstellung, kannst du Befehle und Platzhalter verwenden.

Platzhalter [VARIABLE]

Nutze Platzhalter, um Informationen zum Kunden oder zur Bestellung anzuzeigen. Auch eingelesene Kunden- und Unternehmensstandort-Metafelder stehen als Platzhalter bereit, beispielsweise [% METAFIELD.COMPANY_LOCATION.CUSTOM.INVOICE_EMAIL %]. Richte sie zuerst unter Metafelder lesen ein.

Zahlungsmethode: [% ORDER.GATEWAY %]

Zahlungsmethode: paypal

Obwohl die meisten Platzhalter Texte oder Zahlen sind, gibt es einige Platzhalter, die dynamische Informationen enthalten, z. B. ORDER.ATTRIBUTE.* oder ITEM.PROPERTY.*. Um auf die Inhalte dieser Objekte zuzugreifen, bestehen zwei Möglichkeiten:

Objekte: Alle Werte ausgeben

Nutze [% ORDER.ATTRIBUTES %] bzw. [% ITEM.PROPERTIES %], um alle Namen und Werte zeilenweise auszugeben.

[% ORDER.ATTRIBUTES %]

Key 1: Wert 1
Key 2: Wert 2

Objekte: Einzelne Werte ausgeben

Nutze [% ORDER.ATTRIBUTE.KEY_1 %] bzw. [% ITEM.PROPERTY.KEY_1 %], um nur den Wert des Schlüssels Key 1 auszugeben.

[% ORDER.ATTRIBUTE.KEY_1 %]

Wert 1

Bedingungen [IF/END/ELSE]

Mit Bedingungen können Texte abhängig von Platzhaltern ausgegeben werden.

Ein einfaches Beispiel ist die Darstellung des Zahlungsstatus:

[% IF ORDER.PAYMENT == 'paid' %]bezahlt[% END %]

bezahlt

Dabei wird der Ist-gleich-Operator (==) verwendet, um den Platzhalter ORDER.PAYMENT auf seinen Inhalt zu überprüfen. Sofern er paid entspricht, wird „bezahlt“ ausgegeben.

Operatoren

Bedingungen können zahlreiche Operatoren verwenden:

Unzutreffende Bedingung (ELSE)

Optional können Bedingungen um einen Sonst-Fall ergänzt werden:

Steuern enthalten: [% IF ORDER.PRICE.TAX %]ja[% ELSE %]nein[% END %]

Steuern enthalten: ja

Mehrere Bedingungen

Bedingungen können mit AND (bzw. &&) oder OR (bzw. ||) kombiniert werden:

[% IF ORDER.PAYMENT == 'paid' && ORDER.GATEWAY == 'paypal' %]
    PayPal-Zahlung vollständig
[% END %]

PayPal-Zahlung vollständig

Fallunterscheidung [SWITCH/CASE/DEFAULT/END]

Ähnlich der Bedingungen können Fallunterscheidungen verwendet werden, wenn ein Platzhalter mehreren unterschiedlichen Werten entsprechen kann.

[% SWITCH ORDER.CUSTOMER.LANGUAGE %]
    [% CASE de %]Willkommen
    [% DEFAULT %]Welcome
[% END %]

Willkommen

Fallunterscheidungen können einen Standardwert (DEFAULT) enthalten und sind daher in vielen Fällen eine übersichtliche Alternative zu Bedingungen.

Zusammenführen [JOIN(separator, ...items)]

Werte können mit einem Trennzeichen zusammengeführt werden, um mehrere Platzhalter übersichtlich darzustellen. Das erste Argument ist das Trennzeichen, gefolgt von einer unbestimmten Anzahl an Platzhaltern.

[% JOIN(' · ', ITEM.VENDOR, ITEM.NAME, ITEM.SKU) %]

Apple · iPhone · APL-IPH

Teilzeichenfolge [SUBSTRING(string, start, length)]

Extrahiert ab der Position start die angegebene Anzahl length von Zeichen.

[% SUBSTRING('0123456789', 1, 3) %]

123

Datumsformatierung [DATE_FORMAT(date, format)]

Formatiert ein Datum in das gewünschte Format.
Als erstes Argument wird ein Platzhalter oder ein Datumstext erwartet, als zweites Argument optional ein Format-String nach Day.js.

[% DATE_FORMAT(ORDER.CREATED_AT) %]

01.10.2025

[% DATE_FORMAT(ORDER.CREATED_AT, 'YYYY-MM-DD HH:mm') %]

2025-10-01 23:15

Beispiele für Formate