Guide de personnalisation des modèles d'e-mails Snipcart

Ce guide fournit un aperçu des aides personnalisées disponibles pour les modèles d'e-mails Snipcart, améliorant la fonctionnalité et la personnalisation de vos communications e-commerce.

Aides personnalisées pour les paramètres

Enrichissez vos modèles d'e-mails avec du contenu dynamique provenant de vos paramètres de tableau de bord Snipcart.

• Settings.Signature : Insère le texte de pied de page configuré dans la section Commandes & Factures.

  {{ Settings.Signature }}

• Settings.BusinessAddress : Accédez aux différents composants de l'adresse commerciale configurée dans la section Profil du tableau de bord. Utilisez {{ Settings.BusinessAddress.XXX }}, où XXX est le nom du champ. Les champs pris en charge sont :

  • Company : Nom commercial ou domaine si aucun nom n'est configuré.
  • Address1
  • Address2
  • City
  • Country : Code de pays à deux lettres.
  • PostalCode : Code postal ou ZIP.
  • Province : Province ou État (disponibilité variable selon le pays).
  • VatNumber : Numéro de TVA (disponibilité variable selon le pays).

    {{ Settings.BusinessAddress.Company }}

• Settings.LogoUrl : Récupère l'URL du logo pour utilisation dans une balise <img>, configuré dans la section Commandes & Factures.

  <img src="{{ Settings.LogoUrl }}" alt="Logo de l'entreprise">

• Settings.IncludeProductImagesInInvoice : Aide booléenne pour le modèle de facture par défaut.

Aides de formatage

Ces aides assistent dans la présentation des données de manière plus lisible et esthétique.

• money : Formate les valeurs monétaires selon la devise de votre compte.

  {{ money order.total }}

• date : Formate les dates. Vous pouvez spécifier un format de date si nécessaire.

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

• cleanHtml : Assainit et rend directement le balisage HTML dans le modèle.

  {{ cleanHtml this.description }}

• displayJsonValue : Affiche les valeurs d'un objet JSON, en spécifiant l'objet et la clé.

  {{ displayJsonValue order.metadata "key" }}

Aides conditionnelles

Utilisez ces aides pour contrôler l'affichage du contenu du modèle en fonction de conditions spécifiques.

• if_eq : Vérifie si une valeur est égale à une valeur attendue, facilitant le rendu conditionnel.

  {{ #if_eq order.paymentMethod 'CreditCard' }}
    <span>Le moyen de paiement est la carte de crédit!</span>
  {{ else }}
    <span>Le moyen de paiement n'est pas la carte de crédit, il est {{ order.paymentMethod }}.</span>
  {{ /if_eq }}

• has_any : Vérifie si un tableau contient des éléments, utile pour vérifier les listes non vides.

  {{ #has_any order.items }}
    <span>Les articles contiennent des éléments!</span>
  {{ else }}
    <span>Rien dans cela...</span>
  {{ /has_any }}

• contains : Détermine si un tableau inclut un élément spécifique, aidant à l'affichage de contenu ciblé.

  {{ #contains this.categories 'Cat1' }}
    <span>Les catégories contiennent 'Cat1'</span>
  {{ else }}
    <span>Ne contient pas la catégorie 'Cat1'.</span>
  {{ /contains }}

• has_items_from_category : Vérifie si le panier contient des articles d'une catégorie spécifiée.

  {{ #has_items_from_category order.items 'Cat1' }}
    <span>Le panier contient un article de la catégorie 'Cat1'</span>
  {{ else }}
    <span>Ne contient pas la catégorie 'Cat1'.</span>
  {{ /has_items_from_category }}

• is_absolute_url : Vérifie si une URL est absolue, assurant l'intégrité des liens.

{{ #is_absolute_url this.url }}
  <span>{{ this.url }} est une URL absolue.</span>
{{ else }}
  <span>{{ this.url }} n'est PAS une URL absolue.</span>
{{ /is_absolute_url }}

• sum et sum_money : Effectuent des opérations de somme, sum_money formate également le résultat comme une valeur monétaire.

<!-- Somme sans formatage -->
<div>{{ sum order.summary.total order.summary.subtotal }}</div>

<!-- Somme avec formatage monétaire -->
<div>{{ sum_money order.summary.total order.summary.subtotal }}</div>