Aides personnalisées

Nous avons ajouté quelques aides personnalisées aux aides de base fournies par Handlebars. Elles seront utiles lors de la création de modèles de courriels pour Snipcart.

Aides au formatage

Ces aides peuvent être utilisées pour formater les valeurs.

money

Cette aide peut être utilisée pour mettre en forme des montants d'argent. Elles utiliseront la devise définie dans les paramètres de votre compte.

{{ money order.total }}

date

Cette aide peut être utilisée pour formater les dates. Le premier paramètre est la date elle-même, et le second, facultatif, est le format de la date.

{{ date order.completionDate }}

Utilisation du format de date :

{{ date order.completionDate 'yyyy-MM-dd HH:mm:ss'}}

cleanHtml

Cette aide peut être utilisée pour interpréter les balises HTML. Le seul paramètre accepté est la balise elle-même, qui est nettoyée et affichée directement dans le modèle.

{{ cleanHtml this.description }}

displayJsonValue

Cette aide peut être utilisée pour afficher une valeur d'un objet JSON, comme les métadonnées d'une commande. Le premier paramètre est l'objet JSON lui-même et le second est le nom de la propriété.

{{ displayJsonValue order.metadata "key" }}

Aides conditionnelles

Ces aides peuvent être utilisées pour afficher certaines informations en fonction d'une condition ou d'un déclencheur.

if_eq

Cette aide peut être utilisée pour vérifier si une valeur est égale à une valeur attendue. Le premier paramètre est la valeur, et le second, la valeur attendue.

{{ #if_eq order.paymentMethod 'CreditCard' }}
  <span>The payment method is Credit card!</span>
{{ else }}
  <span>The payment method is not credit card, it is {{order.paymentMethod }}.</span>
{{ /if_eq }}

has_any

Cette aide peut être utilisée pour s'assurer qu'un ensemble contient certains éléments.

{{ #has_any order.items }}
  <span>Items contain some elements!</span>
{{ else }}
  <span>Nothing in this...</span>
{{ /has_any }}

contains

Cette aide peut être utilisée pour s'assurer qu'un ensemble contient un élément spécifique.

{{ #contains this.categories 'Cat1' }}
  <span>Categories contain 'Cat1'</span>
{{ else }}
  <span>Doesn't contain 'Cat1' category.</span>
{{ /contains }}

is_absolute_url

Cette aide peut être utilisée si vous devez vous assurer qu'une URL est absolue.

{{ #is_absolute_url this.url }}
  <span>{{ this.url }} is an absolute URL.</span>
{{ else }}
  <span>{{ this.url }} is NOT an absolute URL.</span>
{{ /is_absolute_url }}

sum

Cette aide peut être utilisée lorsque vous avez besoin d'additionner le montant de certains champs.

<div>
  {{ sum order.summary.total order.summary.subtotal }}
</div>

sum_money

Cette aide fait la même chose que sum mais elle formate également le montant pour afficher une valeur en argent.

<div>
  {{ sum_money order.summary.total order.summary.subtotal }}
</div>