Les variables, également appelées tags de personnalisation ou tags de fusion, vous permettent d’insérer des données personnalisées pour chaque destinataire, comme son prénom ou son achat le plus récent. Les filtres modifient la façon dont ces données apparaissent. 

Comment utiliser les filtres ?

Vous utilisez les filtres à l’intérieur de doubles accolades {{ }} avec une barre verticale |. Par exemple :

Vous pouvez enchaîner plusieurs filtres, de sorte que la sortie d’un filtre soit transmise au suivant. Par exemple :

Pour insérer une variable avec des filtres dans un message, deux choix s'offrent à vous :

• Taper manuellement la variable et les filtres, ou

  

• Sélectionner une variable existante et modifier sa syntaxe dans l’onglet Paramètres avancés.

  

💬 Insérer une valeur par défaut

default

Insère une valeur de repli si une variable est vide.

🔠 Format de la casse

capfirst

Met en majuscule le premier caractère.

title

Met en majuscules la première lettre de chaque mot.

upper

Convertit tous les caractères en majuscules.

lower

Convertit tous les caractères en minuscules.

truncatechars

Raccourcit une chaîne en N caractères. Les valeurs tronquées se termineront par des points de suspension (...) inclus dans le nombre de caractères.

🔢 Format des numéros

floatformat

Arrondit les valeurs flottantes jusqu’à un nombre spécifié de décimales.

integer

Convertit un nombre au format chaîne de caractères ou virgule flottante en un nombre entier.

float

Convertit un nombre au format chaîne ou entier en un nombre à virgule flottante.

lang_format

Met en forme les nombres selon une langue.

📅 Format de la date et de l'heure

time_parse

Convertit une chaîne de dates en un horodatage standard pouvant être utilisé avec d’autres filtres, comme date ou date_i18n.

Lorsque vous utilisez votre format de date comme argument, écrivez la date et l’heure exactement comme l’heure de référence le serait si c’était la valeur.

date

Convertit un horodatage ou une date analysée en un format spécifié. Utilisez-le avec une date analysée via time_parse ou avec l’heure actuelle en utilisant time_now.

date_i18n

Convertit un horodatage ou une date analysée en un format spécifié, la sortie s'affichant dans une langue spécifique. Ce filtre fonctionne comme date, mais vous devez d’abord spécifier la langue, suivie du format.

Les langues prises en charge sont en, fr, it, es, de et pt.

time_add_date

Ajoute des années, des mois et des jours à un horodatage ou une date analysée. Vous devez préciser l’heure à ajouter dans l'ordre année, mois, jour.

time_in_location

Convertit un horodatage ou une date analysée en un fuseau horaire spécifié. Vous devez spécifier le fuseau horaire au format lieu/fuseau horaire.

time_add_duration

Ajoute des heures, minutes et secondes à un horodatage ou une date analysée. Vous devez spécifier la valeur au format h,m,s et transmettre au moins une valeur (heure, minute ou seconde) dans le filtre.

time_unix

Convertit une valeur de temps en horodatage Unix en secondes.

time_unix_nano

Convertit une valeur de temps en horodatage Unix en nanosecondes.

🧑‍💻 Encoder ou encrypter des données

base64_encode ou decode

Encode ou décode la base 64 :

• base64_decode décode une chaîne de caractères vers un []byte
• base64_encode encode un []byte en une chaîne de caractères.

Les filtres base64_encode et decode peuvent prendre un paramètre d'encodage optionnel :

• std: encodage normal base64,
• raw_std: encodage normal base64, sans les caractères de remplissage =,
• url: version sécurisée de l'encodage base64 pour les URL, + et / sont remplacés par - et _ respectivement,
• raw_url: une combinaison de raw et url.

aes_128, 192, ou 256

Encrypte une valeur. Par exemple, vous pouvez utiliser ce filtre pour envoyer des informations de contact cryptées dans une URL, comme une adresse email ou un identifiant.

La variante AES utilisée dépend de la longueur de la clé fournie :

Par exemple, pour la variante AES-256, la variable doit être mise en forme comme suit {{ contact.ATTRIBUTE | aes_256:'key' }}, où la clé doit :

• être composée de 32 chiffres ;
• être générée de façon aléatoire ;
• doit persister de votre côté afin de pouvoir décrypter la valeur d'origine.

Par défaut, si aucun paramètre d'encodage n'est défini, base64 std sera utilisé. Les paramètres suivants sont également pris en charge :

• raw_std: encodage normal base64, sans les caractères de remplissage =,
• url: version sécurisée de l'encodage base64 pour les URL, + et / sont remplacés par - et _ respectivement,
• raw_url: une combinaison de raw et url.

🔎 Autres filtres

first

Renvoie le premier élément d'une séquence, d'un mappage ou d'une chaîne.

join

Combine les éléments d'un tableau en une seule chaîne de caractères en utilisant l'argument comme séparateur.

Le séparateur entre les éléments est vide par défaut. Vous pouvez le définir avec le premier paramètre facultatif.

last

Renvoie le dernier élément d'une séquence, d'un mappage ou d'une chaîne.

length

Renvoie le nombre d'éléments d'une séquence ou d'un mappage, ou la longueur d'une chaîne.

safe

Marque une chaîne de caractères comme ne nécessitant pas d'échappement HTML supplémentaire avant la sortie.

  Sans le filtre safe, la balise HTML s'afficherait comme une chaîne normale dans l'e-mail du destinataire : "<p>This is my test sentence</p>" ou "Welcome to <b>Brevo</b>, we're glad to have you here".

slice

Extrait une tranche d'une séquence, d'un mappage ou d'une chaîne.

Ce filtre peut être configuré pour :

Dans chaque exemple, considérez que votre tableau contient les éléments suivants : ["a","b","c","d","e","f","g","h"...].

verbatim

Dans Brevo, les variables s’écrivent à l’aide de doubles accolades comme {{ params.property }}. Lorsque vous incluez des doubles accolades comme {{ this }} dans votre email, Brevo considère cela comme un élément de template.

Pour afficher {{ }} en texte brut dans votre email, enveloppez le contenu dans un bloc {% verbatim %} :

autoescape

Par défaut, Brevo échappe tout le contenu variable, y compris HTML et JavaScript. Cela signifie que si votre variable contient du code HTML (par exemple, <h1>Mon titre</h1>), elle sera affichée en texte brut plutôt qu’en HTML.

Pour permettre le rendu HTML, vous devez désactiver l’autoescape avec le tag {% autoescape off %}. Enveloppez la variable dans ce bloc et fermez-la avec {% endautoescape %} :

{% autoescape off %}{{ params.my_html }}{% endautoescape %}

📖 Ressources complémentaires

 Le langage de template de Brevo est basé sur Pongo2, qui est une réimplémentation de Django en Go (un langage de programmation).

Tags supportés

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

Filtres supportés

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.

Filtres supportés pour les algorithmes de hachage

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.

🤔 Vous avez des questions ?

Pour toute question, n’hésitez pas à contacter notre service client en créant un ticket à partir de votre compte. Si vous n’avez pas encore de compte, vous pouvez nous contacter ici.

Si vous avez besoin d'aide pour un projet impliquant Brevo, nous pouvons vous mettre en relation avec une agence partenaire Brevo.