La clé properties permet de modifier facilement les informations des entités affichées un peu partout (les informations d'une order, d'un parcel, ou de line items, ou même des pop-ins).
...
| formatter | effet | option | example |
|---|---|---|---|
arrayelement | Récupère l'élément d'un tableau à l'index défini en option | Index de l'élément | types|arrayelement:0 |
capitalize | Remplace toutes les lettres par des minuscules, sauf la première, en majuscule | features.name|capitalize | |
concat | Concatène une autre property, sans espace | Propriété à concaténer | carrier|concat:tracking_code |
concatraw | Concatène une string définie dans l'option | String à concaténer | state|concatraw:par l'entrepôt |
currency | Formatte un nombre en une currency, avec un symbole défini dans une autre propriété | La propriété contenant la currency | payment.price|currency:payment.currency |
currencyraw | Formatte un nombre en une currency, avec un symbole défini dans l'option | La currency à utiliser | payment.price|currencyraw:USD |
filter | Parcours un tableau et garde les éléments de ce tableau dont une propriété vaut une des valeurs fournies. | Une propriété=une liste de valeurs séparées par un virgule | line_items|filter:state=removed,mistaken|length|concatraw: items sont removed ou mistaken 5 items sont removed ou mistaken |
filterlength | Parcours un tableau et compte le nombre d'élèment de ce tableau dont une proprièté vaut une des valeurs fournies. (v5.5) | Une proprièrepropriété=une liste de valeurs séparées par une virgule | line_items|filterlength:state=removed,mistaken|transcount:order.cancel_count(5 canceled) |
forcount | Parcours un tableau et compte la taille d'une proprièté de chaque de ce tableau. (v5.5) | Une propriètépropriété | parcels|forcount:piece_ids|transcount:order.item_count5 items |
length | Retourne l'attribut length d'un tableau ou d'une string | piece_ids|length | |
| link | Formate le résultat sous forme de lien | Une propriété | delivery.carrier.name|link:delivery.carrier.tracking_url <a href="colissimoURL">colissimo</a> |
| link_blank | Formate le résultat sous forme de lien blank | Une propriété | delivery.carrier.name|link:delivery.carrier.tracking_url <a target="_blank" href="colissimoURL">colissimo</a> |
lowercase | Remplace toutes les lettres par des minuscules | features.name|lowercase | |
moment | Formatte un timestamp en utilisant un format de momentjs | Format de la date | date|moment:DD/MM/YYYY |
| prepend | Concatène une autre property à gauche | Une propriété | tracking_code|prepend:carrier ups64477466854 |
prependraw | Concatène une string définie dans l'option, à gauche | String à afficher | state|prependraw:L'etat est |
rawstring | Permet de remplacer le résultat par une string définie dans l'option | String à afficher | |rawstring:Charasse |
sum | Parcours un tableau et fais la somme de la propriété donnée en option | Une propriété | line_items|sum:payment.price |
trackingcode | Affiche le tracking code s'il y en a, traduit la clé passée en paramètre sinon | Clé à traduire s'il n'y a pas de tracking code | tracking_code|trackingcode:parcel.no_tracking_information"XV265564654" ou "Colis sans information de tracking" s'il n'y a pas de tracking code |
trans | Traduit le résultat (si la clé de traduction existe bien) | |rawstring:states.|concat:state|trans | |
transcount | Prend un nombre en entrée et appelle une traduction avec pluralisation | Clé de traduction | line_items|length|transcount:order.item_count |
transcountnotnull | Prend un nombre en entrée et appelle une traduction avec pluralisation. N'affiche rien si le nombre vaut 0. (v5.5) | Clé de traduction | line_items|length|transcount:order.item_countavec line_items = [] : |
unfilterlength | Parcours un tableau et compte le nombre d’élément de ce tableau dont une proprièté ne vaut pas une des valeurs fournies. (v5.5) | Une propriété=une liste de valeurs séparées par une virgule | line_items|unfilterlength:state=removed,mistaken|concatraw: not canceled5 not canceled |
uppercase | Remplace toutes les lettres par des majuscules | features.name|uppercase |
| Note | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
Attention à la façon dont les propriétés sont surchargées. Un tableau de 2 éléments surchargé par un tableau vide reste un tableau de 2 éléments.
L'avantage: il est possible de rajouter une ligne à l'order de la façon suivante, sans que les deux premières lignes ne soient écrasées.
|
...