{{ mirror }}

Insère un lien qui permet de visualiser votre email dans une page web.

Il n’est pas obligatoire d’utiliser cette variable.

Elle est le plus souvent positionnée en haut de l’email.

Ex : Cliquez ici pour visualiser ce message dans votre navigateur.

{{ unsubscribe }}

Insère un lien pour se désabonner de vos emails.

Les emails non transactionnels envoyés via HOSTEUR Emailing doivent tous contenir un lien de désabonnement.

En général, cette variable est placée en bas de page de l’email.

Ex : Se désabonner de nos emails

{{ update_profile }}

Insère un lien qui permet à vos contacts de mettre à jour leurs informations.

Vous pouvez insérer un lien vers le formulaire de mise à jour dans les paramètres de votre campagne.

Cette variable est fréquemment positionnée au bas de l’email.

Ex : Mettre à jour vos informations.

if

Permet de vérifier si une valeur est vraie ou si un tableau n’est pas vide.

Ex1 :

{% if contact.ACTIVE %} Félicitations ! Vous avez atteint votre objectif ce mois-ci.{% endif %}

Ex2 :

{% if params.tutors %}
The following tutors are available to help you :

{% for tutor in params.tutors %}

1. {{ tutor.name }}

{% endfor %}

==

Permet de vérifier si une expression est vraie.

Ex1 :

{% if coupon == "WELCOME" %}

Bienvenue sur notre liste ! Code de réduction : WELCOME10

Ex2 :

{% if contact.DONOR == true %}
Thank you for your support!
{% endif %}

if, in

Permet de vérifier si une valeur (sous-chaîne) existe au sein d’une chaîne ou si une variable existe dans un tableau.

Ex1 :

{% if “@exemple.com" in "paul@exemple.com" %}
Ceci apparaît puisque "@exemple.com" est une sous-chaîne de "paul@example.com"
{% endif %}

Ex2 :

{% if "Piano" in params.types %}
Attention ! Vous avez commandé des objets lourds. Vous devez être présent lors de la livraison de votre commande.
{% endif %}

not

Permet de vérifier les valeurs fausses.

Ex :

{% if not user.subscribed %}

Vous ne faites pas encore partie de nos membres VIP. Inscrivez-vous ici.

and / or

Permet d’utiliser plusieurs conditions.

Ex1 :

{% if temperature > 25 and temperature < 40 %}

Quelle chaleur ! Recevez un bon de réduction de 25% sur nos glaces, utilisable uniquement aujourd'hui.

Ex2 :

{% if contact.LANGUE == “FR” and contact.PAYS == “Canada” %}
{% endif %}

Ex3 :

{% if contact.PAYS == “USA” or contact.PAYS == “Canada” %}
{% endif %}

elif, else

Permet d’utiliser plusieurs alternatives.

Ex1 :

{% if contact.GENRE == “Homme” %} Bonjour Monsieur {{ contact.NOM }},
{% elif contact.GENRE == “Femme” %} Bonjour Madame {{ contact.NOM }},
{% else %} Bonjour, {% endif %}

Ex2 :

{% if event.paid %} Votre réservation est confirmée. Merci pour votre paiement.
{% elif event.registered %} Votre réservation est confirmée. Veuillez passer au paiement avant le 15 Juin.
{% else %} Vous avez encore le temps de réserver votre place ! Cliquez ici.
{% endif %}

for, in

Pour afficher une liste.

Ex :

   {% for user in params.USERS %}
       
• {{ user.username }}

   {% endfor %}

else

Pour exécuter un bloc de remplacement si la séquence est vide.

Ex :

   {% for user in params.USERS %}
       
• {{ user.username }}

   {% else %}
       
• aucun utilisateur trouvé

   {% endfor %}

• Affiche « aucun utilisateur trouvé »

reversed

Pour inverser l’ordre de saisie des éléments d’une séquence.

Ex : {% for country in params.countries reversed %} {% end for %}

• Affiche une liste des pays dans l’ordre inverse de la liste d’origine

forloop.Counter

Correspond à un nombre entier qui représente le nombre d'entrées dans la boucle. Le compte démarre à 1 : après la première entrée dans la boucle, forloop.Counter est égal à 1.

Cette expression peut être utilisée pour numéroter les éléments d'une boucle :

{% for product in params.products %}
{{ forloop.Counter }}- {{ product.name }}

{% endfor %}

• Affichera une liste telle que celle-ci :

1- Produit A
2- Produit B
3- Produit C, etc.

forloop.Counter0

Itération actuelle de la boucle (en commençant par 0).

forloop.Revcounter

Correspond à un nombre entier qui représente le nombre d'éléments restants dans la boucle. Après la première entrée dans la boucle, forloop.Revcounter est égal au nombre total d'éléments dans la séquence traversée. Après la dernière entrée dans la boucle, forloop.Revcounter est égal à 1.

forloop.Revcounter0

Nombre d'itérations jusqu'à la fin de la boucle (en terminant par 0)

forloop.First

La valeur booléenne indique True s'il s'agit du premier passage dans la boucle.

Cette fonctionnalité est particulièrement pratique pour appliquer un format spécifique au premier élément d'une liste, comme par exemple pour appliquer un filtre « upper » (décrit dans la partie « 3. Filtres » plus bas) uniquement au premier élément de cette liste de produits :

{% for product in params.products %}
{{ forloop.Counter }}. {% if forloop.First %} {{ product.name|upper }}

{% else %} {{ product.name }}

{% endif %} - {{ product.price }}
{% endfor %}

• Affiche une liste de produits telle que celle-ci :

1. PREMIER PRODUIT - 6,00 €
2. Deuxième produit - 3,00 €
3. Troisième produit - 5,00 €

forloop.Last

La valeur booléenne indique True s'il s'agit du dernier passage dans la boucle. Un caractère de séparation (comme « , » ou « | ») est souvent utilisé dans une liste d'éléments.

forloop.Parentloop

Référence l'objet forloop par rapport à une boucle parente, en cas de boucles imbriquées.

Ex :

{% for country in countries %}

capfirst

Applique une majuscule au premier caractère.

Le premier caractère sera en majuscule, et tous les autres caractères seront en minuscules.

{{ contact.NAME|capfirst }}

• jean dupont deviendra Jean dupont

title

Applique une majuscule à chaque début de mot.

Le premier caractère de chaque mot sera en majuscule, les autres caractères seront en minuscules.

{{ contact.NAME|title }}

• jean dupont deviendra Jean Dupont

upper

Applique des majuscules à tous les caractères.

{{ contact.NAME|upper }}

• jean dupont deviendra JEAN DUPONT

lower

Applique des minuscules à tous les caractères.

{{ contact.NAME|lower }}

• JEAN DUPONT deviendra jean dupont

trunchars

Tronque une chaîne de caractères si celle-ci dépasse le nombre de caractères spécifié.

Les chaînes tronquées se termineront par « … »

{{ value|truncatechars:7 }}

• Si « value » = anniversaire, la valeur deviendra anniver…

floatformat

Arrondit les valeurs float de votre paramètre ou attribut de contact à la décimale spécifiée.

Pour fonctionner convenablement, les valeurs doivent être traitées en tant que nombre, et non en tant que chaîne de caractères. Les valeurs ne doivent pas être comprises entre guillemets, comme dans “valeur”.

Si votre template comprend {{ contact.BALANCE }} et que la valeur du résultat est égale à 52,630000, celle-ci peut être arrondie à la décimale « n » comme ceci :
{{ contact.BALANCE | floatformat: n}}

Ex :

{{ contact.BALANCE | floatformat: 2}} prendra la forme 52,63 au lieu de 52,630000
 

{{ contact.BALANCE | floatformat: 0}} prendra la forme 52 au lieu de 52,630000

time_parse

Convertit le format de la date (en tant que chaîne de caractères) en un format standard qui peut être utilisé avec d'autres filtres.

Utilisez le format actuel de la date en tant qu'argument : indiquez la date et l'heure exactes de Monday January 2 15:04:05 -0700 MST 2006 au format qui s'afficherait si cette valeur était utilisée :

• {{ params.my_date|time_parse:"15:04 02/01/2006” }}
• {{ params.my_date|time_parse:"Monday 02 January 2006” }}

Remarque : les jours et les mois doivent être en anglais pour être reconnus.

Si votre chaîne est au format RFC3339, vous pouvez utiliser le paramètre dédié time_parse_rfc3339 sans argument.

date

Saisit la date au format spécifié.

Définissez votre propre format en indiquant comment la date et l'heure de référence, définies à Mon Jan 2 15:04:05 - 0700 MST 2006, s'afficheraient selon le format que vous souhaitez utiliser.

Vous devez ajouter une date à ce filtre.

Vous obtenez une date à partir d'une chaîne de caractères qui utilise le filtre time_parse.

Ex :

{{ "14:01 01/06/2018"|time_parse:"15:04 02/01/2006"|date:"Mon Jan 2 15:04:05 2006"}}

• Ceci donnera : Fri Jun 1 14:01:00 2018

Remarque : les jours et les mois doivent être en anglais pour être reconnus.

first

Retourne le premier élément d'une séquence, d'un mappage ou d'une chaîne de caractères.

Si votre template comprend {{params.array|first}}

Et si votre demande de l'API comprend : 

“params” :
{
“array” : [ 1,2,3,4 ]
}

• Cela donnera 1

join

Retourne une chaîne de caractères qui regroupe les éléments d'une séquence.

Par défaut, le séparateur des éléments est une chaîne vide. Vous pouvez définir un autre séparateur à l'aide du premier paramètre optionnel.

• {{ [1, 2, 3]|join }} donnera la forme 123
• {{ [1, 2, 3]|join('|') }} donnera la forme 1|2|3

last

Retourne le dernier élément d'une séquence, d'un mappage ou d'une chaîne de caractères.

• {{ [1, 2, 3, 4]|last }} donnera 4

lenght

Retourne le nombre d'éléments d'une séquence ou d'un mappage, ou la longueur d'une chaîne de caractères.

{% if users|length > 10 %}
   ...
{% endif %}

safe

Permet d'indiquer qu'une chaîne de caractères ne nécessite pas d'échappement HTML avant l'affichage du résultat.

{{ params.htmltest | safe }}

"params" :{HtmlTest: "

Ceci est un test.

• Ceci affichera un paragraphe formaté dans l'email du destinataire : Ceci est un test. 

{{ params.htmltest }}

"params" :{HtmlTest: "

Ceci est un test.

• Ceci s’affichera comme suit dans l'email du destinataire :

  Ceci est un test.

slice

Extrait certains éléments d’une séquence, d’un mappage ou d’une chaîne de caractères.

Ce filtre peut être configuré pour :

A. Passer en boucle uniquement les « n » premiers éléments d'un groupe.

B. Passer en boucle les éléments entre deux positions spécifiques (« n » et « m ») dans le groupe.

Dans ces deux cas, n'oubliez pas qu'à chaque élément d'un groupe est attribué un numéro de position unique, en commençant par « 0 » à la première position.

C. Le filtre peut aussi être configuré pour passer en boucle les éléments entre des éléments spécifiques d'un groupe.

Ex : imaginons que le groupe contient les éléments suivants : ["a","b","c","d","e","f","g","h",...]

A.
{% for product in params.products|slice:’:5’ %}
{{ product.name }} - {{ product.price }}
{% endfor %}
passera en boucle les 5 premières positions (0-4), c'est-à-dire : ["a","b","c","d","e"]

B.
{% for product in params.products|slice:’2:3’ %}
{{ product.name }} - {{ product.price }}
{% endfor %}
passera en boucle les positions (2-3), c'est-à-dire : ["c","d"]

C.
{% for product in params.products|slice:’b:d’ %}
{{ product.name }} - {{ product.price }}
{% endfor %}
passera en boucle les éléments spécifiés  : ["b","c","d"]