circle-exclamation
This documentation is currently under development. Certain sections are not yet complete and will be added shortly.

Liquid

DotLiquid dans l’éditeur de modèles The Wallet Crew

Ce guide montre comment utiliser DotLiquid dans la plateforme The Wallet Crew pour créer des Cartes plus intelligentes, personnaliser le contenu et automatiser le bon message au bon moment.

Aucun développeur n’est requis pour les bases.

Contenu

Les deux blocs de base

Tout dans DotLiquid repose sur deux types de balises :

Tout le reste n’est que du texte affiché tel quel.

Afficher une valeur sur une Carte

circle-info

Si vous tapez {{ }} vous verrez une liste des variables possibles.

Placez n’importe quel champ de données entre {{ }} et il s’affiche sur la Carte.

Ce que le client voit sur sa Carte :

circle-info

Si le champ est vide, rien ne s’affiche. Pas d’erreur, pas de libellé vide.

Assign et créez votre propre variable

Besoin de calculer quelque chose, de le nommer et de le réutiliser ? Utilisez assign.

Ou construisez-le à partir de données existantes :

if / elsif / else — contenu intelligent selon le client

C’est ici que les Cartes deviennent intelligentes. Affichez un contenu différent selon la personne qui détient la Carte.

Terminez toujours avec {% endif %}. C’est l’erreur la plus courante.

Cas d’usage réel The Wallet Crew : afficher un message différent au dos de la Carte selon le niveau.

condition unless

unless exécute le bloc lorsque la condition est pas vraie. Idéal pour la logique de désabonnement.

Se lit naturellement en anglais simple : unless la push est désactivée, affichez ceci.

Opérateurs, comment comparer des éléments

Opérateur
Ce qu’il fait
Exemple sur la Carte

==

Exactement égal

tier == "Gold"

!=

Différent de

tier != "Standard"

>

Supérieur à

points > 500

<

Inférieur à

points < 100

>=

Supérieur ou égal à

points >= 500

<=

Inférieur ou égal à

points <= 99

et

Les deux doivent être vrais

points > 100 and active == true

ou

Au moins un vrai

tier == "Gold" or tier == "Platinum"

contient

Inclut cette valeur

tags contains "event_guest"

case / when, logique propre à plusieurs niveaux

Lorsqu’on compare le même champ à de nombreuses valeurs possibles, case est plus propre que d’empiler des elsif.

Parfait pour les niveaux de fidélité, les catégories de billets d’événement ou les libellés de type coupon.

Filtres, transformez n’importe quelle valeur

Les filtres modifient une valeur avant de l’afficher. Utilisez la | barre verticale :

Enchaînez-les de gauche à droite :

Filtres de chaîne

Filtre
Ce qu’il fait
Exemple
Résultat

upcase

EN MAJUSCULES

{{ "hello" | upcase }}

HELLO

downcase

tout en minuscules

{{ "HELLO" | downcase }}

hello

capitalize

Première lettre en majuscule

{{ "marie" | capitalize }}

Marie

strip

Supprimer les espaces autour

{{ " hi " | strip }}

hi

replace

Remplacer un mot

{{ "Bonjour Monde" replace: "Monde", Marie" }}

Bonjour Marie

truncate

Raccourcir à N caractères

{{ "Long message here" | truncate: 10 }}

Long me

append

Ajouter à la fin

{{ "Gold" append: "Member" }}

Gold Member

prepend

Ajouter au début

{{ "Member" | prepend: "VIP" }}

VIP Member

Exemple réel : nettoyer un nom arrivé de façon désordonnée depuis un formulaire.

Filtres numériques

Filtre
Ce qu’il fait
Exemple
Résultat

plus

Ajouter

{{ customer.points

plus: 50 }}`

390

minus

Soustraire

{{ customer.points

minus: 200 }}`

140

times

Multiplier

{{ price

times: 1.2 }}`

120

divided_by

Diviser

{{ points

divided_by: 10 }}`

34

modulo

Reste

{{ points

modulo: 100 }}`

40

round

Arrondir à N décimales

{{ 9.876

round: 2 }}`

9.88

ceil

Toujours arrondir au supérieur

{{ 9.1

ceil }}`

10

floor

Toujours arrondir à l’inférieur

{{ 9.9

floor }}`

9

Afficher les points restants avant le prochain niveau :

Filtres de tableau

Filtre
Ce qu’il fait

first

Premier élément d’une liste

last

Dernier élément d’une liste

size

Nombre d’éléments

join

Combiner les éléments en une chaîne

sort

Trier par ordre alphabétique ou par champ

uniq

Supprimer les doublons

map

Extraire une propriété de tous les éléments

where

Filtrer les éléments selon la valeur d’un champ

Afficher combien de récompenses un client peut utiliser :

Lister tous les emplacements de magasin actifs :

Formatage des dates

Appliquez le date filtre avec une chaîne de format pour afficher les dates proprement sur une Carte.

Jetons de format :

Jeton
Ce qu’il produit
Exemple

%d

Jour

26

%M

Mois

3

%y

Année courte

25

%A

Nom complet du jour

Wednesday

%m

Minutes

30

%H

Heure UTC au format européen

13

%h

Heure UTC au format américain

1

%s

Secondes

18

%H:%M

Heure (24 h)

14:30

Jetons abrégés sans %:

Jeton
Ce qu’il produit
Exemple

D

Jour, mois, année

Thursday, March 26

H

Heure UTC au format européen

13

M

Mois

3

d

Jour

26

h

Heure UTC au format américain

1

m

Minutes

30

s

Secondes

18

y

Année courte

26

H:M

Heure (24 h)

14:30

Exemple réel de Carte :

Valide jusqu’au 31 décembre 2025

Date Formatting example in our template editor
Exemple de formatage des dates dans notre éditeur de modèles

Arithmétique des dates

Ajoutez ou soustrayez du temps à une date. L’astuce consiste d’abord à convertir en secondes, faire le calcul, puis reformater.

1 jour = 86400 secondes.

Référence pratique :

Durée
Secondes

1 jour

86 400

7 jours

604 800

30 jours

2 592 000

90 jours

7 776 000

1 an

31 536 000

Indicateurs de date — cette Carte est-elle encore valide ?

Comparez une date de Carte à aujourd’hui pour afficher des messages contextuels.

Cas d’usage d’un billet d’événement : afficher un libellé différent avant et après l’événement.

circle-exclamation

now / today

'now' donne le moment actuel. Utilisez-le partout où la date d’aujourd’hui est nécessaire.

Avec un format convivial :

Marie, voici votre statut au mercredi 25 mars 2025.

Combiner des filtres de date

Enchaînez plusieurs étapes pour calculer, comparer et afficher des dates dans un seul flux.

Afficher les jours restants sur un coupon :

Afficher un rappel de renouvellement 30 jours avant l’expiration :

capture — construire un bloc de message

capture vous permet de construire une chaîne complète et de la conserver pour plus tard. Rien n’est affiché tant que la variable n’est pas rendue.

Idéal pour construire le corps d’une notification push, une description au dos de la Carte ou tout bloc de contenu qui doit être assemblé par étapes avant d’être affiché.

Des questions ? Contactez votre interlocuteur Wallet Crew ou consultez la Base de connaissancesarrow-up-right. Bon templating

Mis à jour