Aides personnalisées des modèles de courriel

En plus de la syntaxe standard de Handlebars.js, les modèles de courriel Snipcart exposent un ensemble d'aides personnalisées pour formater des valeurs et faire du rendu conditionnel.

Accéder à vos données

Chaque modèle reçoit des objets comme order, settings et message. Ils sont documentés sous forme de types réutilisables — voir Settings pour les paramètres de la boutique (signature, adresse commerciale, logo, …) et la référence Données de modèle pour la liste complète des objets et des champs. Les aides ci-dessous opèrent sur ces données.

Aides de formatage

Ces aides formatent une valeur pour l'affichage.

money — formate une valeur monétaire selon les paramètres de devise de votre compte.
```
{{ money order.summary.total }}
```
date — formate une date (par défaut yyyy-MM-dd); passez un deuxième argument pour un format personnalisé. Les dates sont converties dans le fuseau horaire de votre compte.
```
{{ date order.completionDate 'yyyy-MM-dd HH:mm:ss' }}
```
cleanHtml — assainit une valeur et l'affiche en HTML.
```
{{ cleanHtml this.description }}
```
displayJsonValue — lit une valeur dans un objet JSON par clé (passez des clés supplémentaires pour accéder aux objets imbriqués).
```
{{ displayJsonValue order.metadata "key" }}
```
sum — additionne ses arguments numériques et affiche le total.
```
{{ sum order.summary.total order.summary.subtotal }}
```
sum_money — comme sum, mais formate le total comme une valeur monétaire.
```
{{ sum_money order.summary.total order.summary.subtotal }}
```

Aides conditionnelles

Des aides de bloc qui affichent leur bloc interne lorsque la condition est remplie (chacune accepte une branche {{ else }}).

if_eq — affiche lorsque tous les arguments sont égaux.

{{ #if_eq order.paymentMethod 'CreditCard' }}
  Payé par carte de crédit.
{{ else }}
  Payé avec {{ order.paymentMethod }}.
{{ /if_eq }}

if_not_eq — affiche lorsque les arguments ne sont PAS égaux (l'inverse de if_eq).

{{ #if_not_eq order.summary.discountInducedTaxesVariation 0 }}
  Les taxes ont été ajustées par un rabais.
{{ /if_not_eq }}

has_any — affiche lorsqu'un tableau contient au moins un élément.

{{ #has_any order.items }}
  Votre commande :
{{ else }}
  Aucun article.
{{ /has_any }}

contains — affiche lorsqu'un tableau contient une valeur précise.

{{ #contains this.categories 'Cat1' }}
  Dans la catégorie Cat1.
{{ /contains }}

has_items_from_category — affiche lorsque la commande contient au moins un article de la catégorie donnée.

{{ #has_items_from_category order.items 'Cat1' }}
  Contient un article de Cat1.
{{ /has_items_from_category }}

has_downloadable_items — affiche lorsque la commande contient au moins un article téléchargeable (numérique).

{{ #has_downloadable_items order.items }}
  Vos liens de téléchargement sont ci-dessous.
{{ /has_downloadable_items }}

has_shippable_items — affiche lorsque la commande contient au moins un article expédiable.
```
{{ #has_shippable_items order.items }}
  Détails de livraison :
{{ /has_shippable_items }}
```
is_absolute_url — affiche lorsqu'une valeur est une URL absolue (commence par http:// ou https://).
```
{{ #is_absolute_url this.image }}
  <img src="{{ this.image }}" />
{{ /is_absolute_url }}
```