In diesen Artikel erklären wir Ihnen, wie Sie die Template-Sprache von Brevo nutzen können, um Platzhalter in Ihren E-Mails mit Filtern zu ändern.

🤔 Was sind Filter?

Filter ändern die Ausgabe eines Platzhalters. Sie werden in doppelten geschweiften Klammern
{{ }} verwendet und durch einen senkrechten Strich | getrennt, z. B. {{ contact.NAME|upper }}. Es können mehrere Filter aneinandergereiht werden und die Ausgabe eines Filters wird auf den nächsten angewendet. 

Um einen Filter zu einer E-Mail-Kampagne oder einem Template hinzuzufügen, müssen Sie ihn manuell hinzufügen. Im Drag & Drop Editor (Neu) müssen Sie den Platzhalter außerdem manuell eingeben und können keinen Filter zu einem Platzhalter hinzufügen, der über die Option Personalization (Personalisierung) hinzugefügt wurde.

Einen einfachen Platzhalter mit der Option Personalization (Personalisierung) hinzufügen
Einen Platzhalter mit Filtern manuell hinzufügen

💬 Einen Standardwert einfügen

default

Fügt einen Standard-Fallback-Wert ein, wenn der Wert "Variable" leer ist.

🔠 Groß- und Kleinschreibung

capfirst

Schreibt den ersten Buchstaben einer Variable groß.

title

Gibt den Wert als Titel aus. Die Wörter beginnen mit Großbuchstaben, alle weiteren Buchstaben werden kleingeschrieben.

upper

Schreibt jedes Zeichen einer Variable groß.

lower

Schreibt jedes Zeichen einer Variable klein.

truncatechars

Kürzt eine Variable, wenn sie die festgelegte Zeichenanzahl überschreitet. Abgeschnittene Variablen enden mit Auslassungspunkten (…), die in der Zeichenzahl inbegriffen sind.

🔢 Zahlen formatieren

floatformat

Rundet die Ausgabe der Float-Werte Ihrer Variable auf die angegebene Dezimalstelle.

Um korrekt zu funktionieren, müssen die Werte als Zahl statt als Zeichenfolge weitergegeben werden. Werte sollten nicht in Anführungszeichen als "Wert" weitergegeben werden.

integer

Konvertiert eine Zahl im String- oder Gleitkommaformat in eine Ganzzahl.

float

Konvertiert eine Zahl im String- oder Integer-Format in eine Gleitkommazahl.

lang_format

Formatiert Zahlen abhängig von der Sprache des Empfängers.

Hinweis:

• Um 2 Dezimalstellen zu erzwingen, fügen Sie nach der Sprachvariable ,%.2f hinzu.
• Für Französisch ist das Tausender-Trennzeichen ein geschütztes Leerzeichen.

📅 Datum und Uhrzeit formatieren

time_parse

Wandelt Ihr Datumsformat (als String übermittelt) in ein Standarddatumsformat um, das mit anderen Filtern verwendet werden kann.

Um Ihr aktuelles Datumsformat als Argument zu übermitteln, formatieren Sie das genaue Datum / die genaue Uhrzeit so, wie die Referenzzeit angezeigt würde, wenn sie der Wert wäre.

Hinweis: Wenn Ihr String mit RFC3339 formatiert ist, können Sie den dedizierten Parser time_parse_rfc3339 ohne Argument verwenden.

date

Konvertiert ein Datum in ein angegebenes Format.

Um mithilfe eines Strings ein Datum auszugeben, müssen Sie den Filter time_parse oder die aktuelle Zeit verwenden und das Datum des Filters an den Platzhalter time_now weitergeben.

date_i18n

Konvertiert ein Datum in ein angegebenes Format, die Ausgabe erfolgt jedoch in anderen Sprachen.

Derzeit werden die Sprachen en, fr, it, es, de und pt unterstützt. Dieser Filter ähnelt dem Filter "date". Der einzige Unterschied besteht darin, dass im Filter zuerst die Sprache und dann das Format angegeben werden sollte.

time_add_date

Fügt die Anzahl von Tagen zu einem Zeitstempel oder einem Datumsstring hinzu. Sie müssen alle Werte in der folgenden Reihenfolge an diesen Filter weitergeben: "Jahr, Monat, Tag".

time_in_location

Konvertiert einen Zeitstempel oder einen Datumsstring gemäß der Zeitzone, die an den Filter weitergegeben wurde. Sie müssen eine Zeitzone im folgenden Format an den Filter weitergeben: "Ort/Zeitzone".

time_add_duration

Fügt eine Zeitdauer zu einem Zeitstempel oder einem Datumsstring hinzu. Im Filter muss mindestens ein Wert (Stunde, Minute oder Sekunde) weitergegeben werden.

time_unix

Konvertiert einen Zeitstempel zum Unix Timestamp in Sekunden.

time_unix_nano

Konvertiert einen Zeitwert in den Unix Timestamp in Nanosekunden.

🧑‍💻 Daten codieren oder verschlüsseln

base64_encode oder decode

Codiert oder decodiert base 64:

• base64_decode decodiert einen String zu einem []Byte
• base64_decode codiert ein Byte zu einem []String

Die Filter base64_encode und base64_decode können einen optionalen Codierungsparameter verwenden:

• std: normale base64-Codierung,
• raw_std: normale base64-Codierung ohne die Füllzeichen =,
• url: sichere Version der base64-Codierung für URL, + und / werden mit - und _ ersetzt,
• raw_url: eine Kombination aus raw und url.

aes_128, 192, oder 256

Verschlüsselt einen Wert. Sie können diesen Filter verwenden, um verschlüsselte Kontaktinformationen wie beispielsweise eine E-Mail-Adresse oder eine ID in einer URL zu versenden.

Die verwendete AES-Variante hängt von der Länge des bereitgestellten Schlüssels ab:

Für die AES-256-Variante muss der Platzhalter beispielsweise als {{ contact.ATTRIBUTE | aes_256:"key" }} formatiert werden, wobei „key“ für den folgenden Schlüssel steht:

• Aus 32 Zahlen bestehen
• Zufällig generiert werden
• Auf Ihrer Seite fortbestehen, damit der Originalwert entschlüsselt werden kann

Wenn kein Codierungsparameter definiert wird, wird standardmäßig base64 std verwendet. Andernfalls wird Folgendes unterstützt:

• raw_std: normale base64-Codierung ohne die Füllzeichen =,
• url: sichere Version der base64-Codierung für URL, + und / werden mit - und _ ersetzt,
• raw_url: eine Kombination aus raw und url.

🔎 Andere Filter

first

Gibt das erste Element einer Sequenz, eines Mappings oder eines Strings wieder.

join

Kombiniert die Elemente in einem Datenfeld zu einem einzigen String, wobei das Argument als Trennzeichen verwendet wird.

Das Trennzeichen zwischen den Elementen ist standardmäßig eine leere Variable. Sie können es mit dem optionalen ersten Parameter definieren.

last

Gibt das letzte Element einer Sequenz, eines Mappings oder eines Strings wieder.

length

Gibt die Anzahl der Elemente einer Sequenz, eines Mappings oder die Länge eines Strings wieder.

safe

Kennzeichnet eine Zeichenfolge so, dass kein weiteres HTML-Escaping vor der Ausgabe erforderlich ist.

Ohne den Filter "safe" würde das HTML-Tag in der E-Mail des Empfängers als normaler String angezeigt: "<p>This is my test sentence</p>" oder "Welcome to <b>Brevo</b>, we're glad to have you here".

slice

Extrahiert ein Stück aus einer Sequenz, eines Mappings oder eines Strings.

Dieser Filter kann konfiguriert werden, um:

Denken Sie in jedem Beispiel daran, dass Ihr Array Folgendes enthält: ["a","b","c","d","e","f","g","h"...].

📖 Zusätzliche Ressourcen

Die Brevo Template Language basiert auf Pongo2, einer Re-Implementierung von Django in Go (einer Programmiersprache).

Alle unterstützten Tags

autoescape, comment, cycle, filter, firstof, for, if, ifchanged, now, set, spaceless, templatetag, with.

Alle unterstützten Filter

escape, safe, escapejs, add, addslashes, capfirst, center, cut, date, default, default_if_none, divisibleby, first, floatformat, get_digit, iriencode, join, last, length, length_is, linebreaks, linebreaksbr, linenumbers, ljust, lower, make_list, phone2numeric, pluralize, random, removetags, rjust, slice, stringformat, striptags, time, title, truncatechars, truncatechars_html, truncatewords, truncatewords_html, upper, urlencode, urlize, urlizetrunc, wordcount, wordwrap, yesno.

Alle unterstützten Filter für Hash-Funktionen

hash_md5, hash_sha256, hash_sha256_224, hash_sha512, hash_sha512_224, hash_sha512_256, hash_sha512_384, hash_sha3_224, hash_sha3_256, hash_sha3_384, hash_sha3_512.

⏩ Nächste Schritte

• So passen Sie Ihre transaktionsbezogenen E‑Mails an
• Autoescape deaktivieren und doppelte geschweifte Klammern in Ihren E-Mails anzeigen

🤔 Sie haben eine Frage?

Wenden Sie sich bei Fragen an unser Support-Team: Erstellen Sie einfach ein Ticket über Ihr Konto. Wenn Sie noch kein Konto haben, können Sie uns hier kontaktieren.

Wenn Sie Unterstützung bei einem Projekt mit Brevo suchen, können wir Sie mit dem richtigen zertifizierten Brevo-Expertenpartner zusammenbringen.