Modificateurs de variables
Changer la langue du pays, la casse ou prévoir une valeur de repli directement dans une variable.
Un modificateur transforme la valeur d'une variable au moment de l'affichage.
Il s'écrit après la variable, séparé par une barre verticale | :
{{user.addressCountry|lang:fr}}Les modificateurs fonctionnent partout où les variables fonctionnent : signature, page de profil, carte digitale, fiche contact (vCard) et carte NFC.
Liste des modificateurs
| Modificateur | Effet | Exemple | Résultat |
|---|---|---|---|
lang:fr | Pays en français | {{user.addressCountry|lang:fr}} | Allemagne |
lang:en | Pays en anglais | {{user.address|lang:en}} | 1 Unter den Linden, Berlin, Germany |
lang:native (ou lang:auto) | Pays dans sa langue d'origine (par défaut) | {{user.addressCountry|lang:native}} | Deutschland |
upper | Tout en majuscules | {{user.lastName|upper}} | DUPONT |
lower | Tout en minuscules | {{user.email|lower}} | jean.dupont@exemple.fr |
capitalize | Majuscule à chaque mot | {{user.firstName|capitalize}} | Jean-Pierre |
initials | Initiales | {{user.firstName|initials}} | JP |
truncate:N | Coupe après N caractères (ajoute « … ») | {{user.jobTitle|truncate:20}} | Directeur commercial… |
default:valeur | Valeur affichée si la variable est vide | {{user.image|default:https://…/logo.png}} | l'image de repli |
Sans modificateur, le pays s'affiche dans sa langue d'origine (« Deutschland », « United Kingdom »).
Enchaîner plusieurs modificateurs
Les modificateurs s'appliquent de gauche à droite :
{{user.addressCountry|lang:en|upper}} → GERMANY
{{user.city|default:Paris|upper}} → PARIS si la ville est videPlacez lang en premier : il repart du pays enregistré et ignore ce qui a été
fait avant lui.
Bon à savoir
langagit sur le pays seul (addressCountry) et sur les adresses complètes (address,address_2,address_3) — pour l'utilisateur comme pour ses groupes ({{user.groupauto.address|lang:fr}}).defaultaccepte une URL (https://…). Une valeur dangereuse (javascript:…) est ignorée.- Un modificateur mal orthographié (
|uper) rend la variable invalide : elle est signalée dans l'éditeur et reste affichée telle quelle.