E-Mails

Mit TWIG kannst du Inhalte in Aivie Themes dynamisch aufbauen, Werte formatieren, Berechnungen durchführen und Bedingungen verwenden. TWIG kommt insbesondere in den Template Dateien für E-Mails, Landing Pages, Formulare und Systemmeldungen zum Einsatz.

Wie funktioniert ein TWIG Filter?

Ein Filter wird mit einem senkrechten Strich an einen Wert angehängt:

{{ value|filter }}

Zum Beispiel:

{{ firstname|default('Guten Tag') }}
{{ title|upper }}

Mehrere Filter können miteinander kombiniert werden:

{{ title|trim|upper }}

Text bearbeiten

Für Texte stehen unter anderem folgende Filter zur Verfügung:

Filter	Verwendung
upper	Text in Grossbuchstaben umwandeln
lower	Text in Kleinbuchstaben umwandeln
title	Wörter mit Grossbuchstaben beginnen
capitalize	Den ersten Buchstaben gross schreiben
trim	Leerzeichen am Anfang und Ende entfernen
replace	Text ersetzen
striptags	HTML Tags entfernen
nl2br	Zeilenumbrüche in HTML umwandeln
length	Anzahl Zeichen oder Elemente bestimmen
default	Einen Ersatzwert verwenden, wenn kein Wert vorhanden ist

Beispiel:

{{ company|default('deinem Unternehmen')|trim }}

Zahlen formatieren und Berechnungen durchführen

Twig unterstützt die normalen Rechenoperatoren:

{{ a + b }}
{{ a - b }}
{{ a * b }}
{{ a / b }}
{{ a // b }}
{{ a % b }}
{{ a ** b }}

Zusätzlich sind folgende Filter und Funktionen hilfreich:

Filter oder Funktion	Verwendung
int	Einen Wert in eine ganze Zahl umwandeln
abs	Den Absolutwert bestimmen
round	Eine Zahl runden
number_format	Eine Zahl für die Ausgabe formatieren
min()	Den kleinsten Wert bestimmen
max()	Den grössten Wert bestimmen

Beispiel mit Schweizer Zahlenformat:

{{ (price|int * quantity|int)|number_format(2, '.', "'") }}

Eine Zahl kannst du so runden:

{{ value|round(2) }}
{{ value|round(0, 'ceil') }}
{{ value|round(0, 'floor') }}

Datumswerte verwenden

Mit date und date_modify kannst du Datumswerte formatieren oder verändern:

{{ "now"|date("d.m.Y") }}
{{ dateValue|date("d.m.Y") }}
{{ dateValue|date_modify("+30 days")|date("d.m.Y") }}

Listen und Arrays verarbeiten

Für Listen stehen unter anderem diese Filter zur Verfügung:

Filter	Verwendung
first	Erstes Element ausgeben
last	Letztes Element ausgeben
join	Elemente zu einem Text verbinden
split	Einen Text in Elemente aufteilen
keys	Schlüssel eines Arrays ausgeben
merge	Listen oder Arrays zusammenführen
slice	Einen Ausschnitt verwenden
sort	Elemente sortieren
reverse	Reihenfolge umkehren
batch	Elemente in Gruppen aufteilen

Beispiel:

{{ tags|join(', ') }}

Bedingungen und Schleifen verwenden

Mit Bedingungen kannst du Inhalte abhängig von einem Wert anzeigen:

{% if points|int >= 100 %}
    Du hast mindestens 100 Punkte erreicht.
{% else %}
    Dir fehlen noch einige Punkte.
{% endif %}

Listen kannst du mit einer Schleife ausgeben:

{% for item in items %}
    {{ item }}
{% endfor %}

Auch eine Summe lässt sich sicher mit einer Schleife berechnen:

{% set total = 0 %}

{% for value in values %}
    {% set total = total + (value|int) %}
{% endfor %}

{{ total|number_format(2, '.', "'") }}

Einige Funktionen sind aus Sicherheitsgründen gesperrt

Einige Filter können ausführbare Funktionen als Argument entgegennehmen. Aivie sperrt sie deshalb, um zu verhindern, dass unerlaubter Programmcode ausführt wird. Zum Beispiel:

• map
• filter
• reduce

Ebenfalls gesperrt sind Funktionen, die auf die Systemkonfiguration, Datenbank, Dateien oder interne PHP Funktionen zugreifen könnten.

Falls du eine bestimmte Berechnung oder Datenumwandlung benötigst, die mit den verfügbaren Möglichkeiten nicht umsetzbar ist, kontaktiere uns. Wir prüfen dann, ob dafür ein sicherer, klar begrenzter Filter ergänzt werden kann.

Wichtig: Nicht jedes Textfeld im Aivie Editor verarbeitet TWIG. Für die normale Personalisierung von E-Mails verwendest du weiterhin die verfügbaren Aivie beziehungsweise Mautic Tokens.

Kurz gesagt

Aivie unterstützt die üblichen TWIG Funktionen für Texte, Zahlen, Daten, Listen, Bedingungen und Schleifen. Gefährliche Funktionen und Filter mit frei ausführbaren Callbacks sind in hochgeladenen Themes aus Sicherheitsgründen gesperrt.

Weitere Informationen findest du auf der Website von TWIG.