Variables de modèle d'e-mail
Les espaces réservés vous permettent de personnaliser chaque rappel automatiquement — le module remplace chaque {variable} par des données en temps réel issues de la commande, du client ou de votre boutique avant l'envoi.
Disponible depuis la v1.0.0
Vue d'ensemble
Lorsque vous rédigez un message de rappel, vous pouvez insérer des variables n'importe où dans l'objet ou le corps du message en entourant le nom de la variable d'accolades : {reference}, {name}, {totalamount}, etc.
Au moment de l'envoi, le module recherche chaque valeur dans la commande en cours et la substitue. Aucune configuration n'est nécessaire — la substitution s'effectue automatiquement à condition que l'espace réservé soit correctement orthographié, accolades comprises et avec la casse exacte indiquée dans ce guide.
Un panneau de référence des variables rétractable est intégré à l'éditeur de messages du Back Office, vous n'avez donc pas besoin de mémoriser les noms. Cliquez sur Variables disponibles au-dessus du champ Objet ou Message pour déployer la liste, puis cliquez sur n'importe quel nom de variable pour le copier dans le presse-papiers.
Les variables qui génèrent du HTML — à savoir {shop_logo}, {order_products} et {urgency_banner} — ne doivent être placées que dans le corps du message, jamais dans l'objet. Une ligne d'objet ne peut pas afficher du HTML ; ces trois variables sont donc intentionnellement masquées dans le sélecteur de variables de l'objet.
Configuration
Aucune activation n'est nécessaire — les variables sont toujours disponibles dans chaque message de rappel. Pour en insérer une :
- Allez dans Modules > Gestionnaire de modules > Order Payment Reminders Pro > Configurer.
- Cliquez sur Modifier sur n'importe quel message de la liste.
- Placez votre curseur dans le champ Objet ou Message à l'endroit où vous souhaitez faire apparaître la valeur.
- Cliquez sur Variables disponibles au-dessus du champ pour déployer le panneau de référence.
- Cliquez sur le nom de la variable — il est copié dans votre presse-papiers.
- Collez-le à la position du curseur, puis cliquez sur Enregistrer.
Vous pouvez également saisir une variable directement. Veillez à inclure les deux accolades et à respecter le nom exact — {reference} fonctionne ; { reference } ou {Reference} ne fonctionnera pas.
Les variables personnalisées (coordonnées bancaires, téléphone d'assistance, etc.) doivent d'abord être définies dans l'onglet Variables personnalisées avant d'être disponibles en tant qu'espaces réservés. Voir Variables personnalisées.
Fonctionnement
Lorsque le module envoie un e-mail de rappel, il construit une table de données à partir de la commande en cours : le nom du client, la référence de commande, le montant total, la date de passation, etc. Chaque espace réservé dans votre objet et votre corps est ensuite remplacé par la valeur correspondante dans cette table.
Les variables personnalisées que vous définissez dans l'onglet Variables personnalisées sont fusionnées dans cette table sous le nom que vous leur avez attribué. Si un nom de variable personnalisée correspond à un espace réservé dans le message, sa valeur le remplace. Si aucune correspondance n'est trouvée, l'espace réservé reste inchangé — votre client voit le texte littéral {variable_name}.
Informations sur la boutique
Ces variables affichent des informations sur votre boutique et sont disponibles à la fois dans l'objet et dans le corps du message.
| Variable | Résultat | Exemple | Objet ? |
|---|---|---|---|
{shop_name} | Le nom de votre boutique tel que défini dans Paramètres de la boutique > Contact | Ma Boutique En Ligne | Oui |
{shop_url} | L'URL complète de votre boutique avec barre oblique finale | https://maboutique.com/ | Oui |
{shop_logo} | Une balise <img> pointant vers le logo de votre boutique | (balise image HTML) | Non |
Ne placez pas
{shop_logo}dans une ligne d'objet — il apparaîtra comme une balise HTML brute. Utilisez-le uniquement dans le corps du message.
Informations sur le client
Ces variables utilisent le nom et les coordonnées du client qui a passé la commande.
| Variable | Résultat | Exemple | Objet ? |
|---|---|---|---|
{name} | Prénom du client | Jean | Oui |
{surname} | Nom de famille du client | Dupont | Oui |
{completename} | Nom complet du client (prénom + nom) | Jean Dupont | Oui |
Utilisez {name} pour un ton informel ("Bonjour {name},") et {completename} pour les communications formelles ("Cher/Chère {completename},").
Informations sur la commande
Ces variables reflètent la commande spécifique pour laquelle le rappel est envoyé.
| Variable | Résultat | Exemple | Objet ? |
|---|---|---|---|
{reference} | Le numéro de référence de la commande | GDQFM-LMQDB | Oui |
{totalamount} | Montant total de la commande TTC, formaté dans la devise de la commande | 129,90 € | Oui |
{order_products} | Un tableau HTML stylisé listant chaque produit avec son image, sa quantité et son prix | (tableau HTML) | Non |
{order_products_text} | Une liste de produits en texte brut, un par ligne | - T-Shirt Bleu x2 — 29,00 € | Non |
{order_products} affiche un tableau de produits complet avec des images miniatures, conçu pour être utilisé dans le corps d'un e-mail HTML. Si la commande ne contient aucun produit, il génère une chaîne vide plutôt qu'un tableau incomplet.
{order_products_text} génère un produit par ligne au format - Nom du produit xQté — Prix, suivi d'une ligne de total. Utilisez-le dans les sections en texte brut de votre e-mail plutôt que dans le corps HTML.
Délai et annulation
Ces variables reflètent l'ancienneté de la commande et la fenêtre d'annulation automatique configurée. Si aucun délai d'annulation n'est défini dans la Configuration globale, {daysleft} et {hoursleft} affichent 0.
| Variable | Résultat | Exemple | Objet ? |
|---|---|---|---|
{cancel_days} | Nombre total de jours configurés pour l'annulation automatique | 7 | Oui |
{daysleft} | Jours entiers restants avant le délai d'annulation automatique | 3 | Oui |
{hoursleft} | Heures restantes avant le délai d'annulation automatique | 68 | Oui |
{hoursleft} est la valeur brute en heures — par exemple, 3 jours restants peuvent représenter 68 heures. Utilisez {hoursleft} dans les messages de dernier avertissement où les heures créent plus d'urgence que les jours.
Formats de date
Toutes les variables de date affichent la date à laquelle la commande a été passée, et non la date du jour.
| Variable | Format | Exemple | Objet ? |
|---|---|---|---|
{date} | d-m-Y | 09-05-2026 | Oui |
{date_us} | Y-m-d | 2026-05-09 | Oui |
{date_english} | Anglais ordinal | 9th, May 2026 | Oui |
{date_short} | Court localisé (sans année) | sam. 9 mai | Oui |
{date_full} | Complet localisé (sans année) | samedi 9 mai | Oui |
{date_short_year} | Court localisé avec année | sam. 9 mai 2026 | Oui |
{date_full_year} | Complet localisé avec année | samedi 9 mai 2026 | Oui |
{date_short} et {date_full} (ainsi que leurs variantes _year) utilisent la langue de votre boutique pour les noms de mois et de jours. La langue de sortie correspond à la langue utilisée par le client lors de la passation de la commande, et non à la langue du Back Office. Une boutique française affichera "samedi, 9 mai" tandis qu'une boutique anglophone affichera "Saturday, 9 May".
{date_short_year} et {date_full_year} fonctionnent de façon identique à {date_short} et {date_full} mais incluent l'année. Ces quatre variables n'apparaissent pas dans le sélecteur de variables intégré à l'application, mais fonctionnent correctement dans n'importe quel message.
Bandeau d'urgence
| Variable | Résultat | Objet ? |
|---|---|---|
{urgency_banner} | Un bloc HTML de bandeau coloré résumant les jours restants avant l'annulation | Non |
Le bandeau d'urgence est un bloc HTML autonome avec des styles inline — compatible avec tous les principaux clients de messagerie. Sa couleur change automatiquement en fonction de {daysleft} :
- Vert (plus de 5 jours) : "Votre commande sera maintenue pendant encore N jours."
- Orange (2 à 5 jours) : "Votre commande sera maintenue pendant encore N jours."
- Rouge (moins de 2 jours) : "Votre commande est sur le point d'être annulée."
Le bandeau ne s'affiche que lorsque l'annulation automatique est configurée (Annuler la commande après N jours > 0). S'il n'y a pas de délai d'annulation, {urgency_banner} génère une chaîne vide et ne laisse aucun espace visible dans votre e-mail.
Placez {urgency_banner} près du haut du corps de votre message pour une visibilité maximale, en particulier dans les messages de dernier avertissement.
Variables personnalisées
Toute entrée que vous définissez dans l'onglet Variables personnalisées devient disponible en tant qu'espace réservé sous le nom que vous lui avez attribué. Trois noms conventionnels utilisés dans les messages de modèle préchargés sont :
| Variable | Résultat | Exemple |
|---|---|---|
{account_info} | Nom du titulaire du compte bancaire | Smart Modules SL |
{account_number} | Numéro de compte bancaire ou IBAN | ES91 2100 0418 4502 0005 1332 |
{bank_address} | Adresse bancaire ou coordonnées de l'agence | CaixaBank, Barcelone |
Ces espaces réservés ne fonctionnent que si vous avez créé des entrées correspondantes dans l'onglet Variables personnalisées avec ces noms exacts. Si une variable personnalisée correspondante n'existe pas, l'espace réservé est remplacé par une chaîne vide.
Vous pouvez définir n'importe quel nom de variable personnalisée — par exemple, une variable nommée support_phone devient {support_phone} dans vos messages. Consultez Variables personnalisées pour des instructions pas à pas.
Variables internes de modèle
Les variables suivantes sont utilisées par le modèle HTML d'enveloppe d'e-mail (mails/template/template.html), et non dans l'éditeur de messages lui-même. Elles sont documentées ici à titre de référence lors de la modification de la conception du modèle d'e-mail.
| Variable | Utilisation |
|---|---|
{wr_title} | Remplacé par l'objet du message dans l'en-tête du modèle HTML |
{wr_message} | Remplacé par le corps complet du message dans le modèle HTML |
{wr_subject} | Identique à {wr_title} — également disponible dans le modèle HTML |
{wr_cancel_order} | Indicateur interne — génère 1 ou 0 ; ne pas utiliser dans le texte du message |
N'utilisez pas {wr_cancel_order} dans un objet ou un corps de message — c'est une valeur interne qui s'affichera comme 0 ou 1 auprès de vos clients.
Exemples d'utilisation
Exemple : Premier rappel informel avec coordonnées bancaires
Objet : Rappel de paiement pour votre commande {reference}
Corps :
Bonjour {name},
Juste un petit mot — votre commande {reference} passée le {date} attend toujours son paiement.
Montant dû : {totalamount}
Merci de virer la somme à :
Titulaire du compte : {account_info}
IBAN : {account_number}
Cordialement,
{shop_name}
Exemple : Relance formelle avec liste de produits
Objet : Commande {reference} — paiement en attente
Corps :
Cher/Chère {completename},
Nous faisons suite à votre commande {reference}.
Voici un récapitulatif de votre commande :
{order_products}
Total dû : {totalamount}
Nous vous remercions de bien vouloir effectuer votre paiement dans les meilleurs délais.
Cordialement,
{shop_name}
Exemple : Dernier avertissement avec bandeau d'urgence et compte à rebours en heures
Objet : DERNIER RAPPEL : La commande {reference} sera annulée dans {daysleft} jours
Corps :
Cher/Chère {name},
{urgency_banner}
Votre commande {reference} sera automatiquement annulée dans {daysleft} jours ({hoursleft} heures) si nous ne recevons pas votre paiement.
Montant dû : {totalamount}
{shop_name}
Remarques importantes
- Toutes les variables sont sensibles à la casse.
{Name}et{NAME}ne seront pas remplacées — utilisez les noms en minuscules exacts indiqués dans ce guide. - Les variables qui génèrent du HTML (
{shop_logo},{order_products},{urgency_banner}) ne doivent être utilisées que dans le corps du message, jamais dans l'objet. {daysleft}et{hoursleft}affichent0lorsqu'aucun délai d'annulation automatique n'est configuré. Évitez de les utiliser dans des messages où l'annulation n'est pas pertinente — ils afficheront "0 jours restants", ce qui pourrait dérouter les clients.{order_products}peut générer une chaîne vide si les données produit de la commande ne sont pas disponibles en raison d'une erreur de contexte cron. Cela est géré de façon transparente — aucun HTML corrompu n'est laissé en place.- Les noms de variables personnalisées ne sont résolus que lorsqu'une entrée correspondante existe dans l'onglet Variables personnalisées. Une variable personnalisée manquante génère silencieusement une chaîne vide.
- Multi-boutique : les variables sont résolues dans le contexte de la boutique à laquelle appartient la commande. Les variables personnalisées sont propres à chaque boutique ; un espace réservé défini sur la Boutique A ne sera pas disponible sur la Boutique B.
{date_short_year}et{date_full_year}n'apparaissent pas dans le sélecteur de variables intégré à l'application, mais fonctionnent correctement dans n'importe quel corps de message ou objet.
Résolution des problèmes
| Problème | Solution |
|---|---|
Une variable apparaît en texte littéral (ex. {reference} n'est pas remplacée) | Vérifiez l'orthographe et la casse — le nom de la variable doit correspondre exactement aux noms indiqués dans ce guide, y compris les deux { et } sans espaces à l'intérieur. |
{daysleft} ou {hoursleft} affiche 0 dans chaque e-mail | L'annulation automatique n'est pas configurée. Allez dans Configuration globale et définissez une valeur pour Annuler la commande après N jours. |
{order_products} n'affiche rien | Cela peut se produire lorsque la commande ne contient aucun produit, ou lorsqu'une erreur de formatage de prix survient dans le contexte cron. Vérifiez Paramètres avancés > Journaux pour les entrées de WireTransferReminder. |
{account_info} ou {account_number} n'affiche rien | Ce sont des variables personnalisées. Allez dans l'onglet Variables personnalisées et créez des entrées avec exactement ces noms. Voir Variables personnalisées. |
{urgency_banner} n'affiche rien | Le bandeau ne s'affiche que lorsqu'un délai d'annulation est défini. Activez Annuler la commande après N jours dans la Configuration globale. |
{shop_logo} apparaît comme du HTML brut dans un e-mail | La balise <img> du logo s'affiche uniquement dans les corps d'e-mails HTML. Ne la placez pas dans l'objet. Certains clients de messagerie bloquent également les images distantes par défaut — les clients peuvent avoir besoin de cliquer sur "afficher les images". |
| Une variable personnalisée que j'ai définie n'est pas remplacée | Vérifiez que le nom de la variable dans l'onglet Variables personnalisées correspond exactement à l'espace réservé, y compris la casse. Confirmez également qu'elle est enregistrée dans la boutique correcte si vous utilisez une configuration multi-boutique. |
Foire aux questions
Puis-je utiliser des variables dans l'objet de l'e-mail ?
La plupart des variables fonctionnent dans l'objet, notamment {reference}, {name}, {completename}, {totalamount}, {daysleft}, {hoursleft} et tous les formats de date. Les exceptions sont les variables qui génèrent du HTML — {shop_logo}, {order_products} et {urgency_banner} — qui sont réservées au corps du message. Le sélecteur de variables intégré à l'application n'affiche que les variables compatibles avec l'objet lorsque vous le déployez au-dessus du champ Objet.
Que se passe-t-il si j'utilise un nom de variable inconnu comme {monchamp} ?
Si monchamp ne correspond à aucune variable intégrée et n'est pas défini en tant que Variable personnalisée, l'espace réservé reste inchangé — vos clients verront le texte littéral {monchamp}. Testez toujours avec un e-mail de test avant d'activer un message.
Comment ajouter mon IBAN et le nom du titulaire du compte à mes e-mails ?
Créez deux Variables personnalisées dans l'onglet Variables personnalisées — une nommée account_info avec le nom du titulaire du compte, et une nommée account_number avec votre IBAN. Utilisez ensuite {account_info} et {account_number} dans le corps de votre message. Consultez Variables personnalisées pour des instructions pas à pas.
Est-ce que {totalamount} inclut les taxes ?
Oui. {totalamount} affiche le total TTC de la commande, formaté dans la devise de la commande.
Puis-je afficher à la fois les jours et les heures restants dans le même message ?
Oui. Utilisez {daysleft} et {hoursleft} ensemble — par exemple : "Votre commande sera annulée dans {daysleft} jours ({hoursleft} heures)." Les deux valeurs proviennent du même calcul et sont toujours cohérentes entre elles.
Les variables de date affichent la date de la commande, pas la date du jour — existe-t-il un moyen d'afficher la date du jour ?
Toutes les variables de date ({date}, {date_us}, etc.) reflètent la date à laquelle la commande a été passée, et non la date actuelle. Il n'existe pas de variable {today} intégrée. Si vous souhaitez communiquer une notion d'urgence, utilisez plutôt {daysleft} et {hoursleft}.
Les formats de date localisés ({date_short}, {date_full}) sont-ils traduits automatiquement ?
Oui. Ces variables utilisent la langue choisie par le client lors de la passation de la commande pour formater les noms de mois et de jours. Une commande en français affichera "samedi, 9 mai" tandis qu'une commande en anglais affichera "Saturday, 9 May" — indépendamment de la langue de votre Back Office.
Puis-je créer mes propres variables pour des éléments comme un numéro de téléphone d'assistance ou un lien de paiement ?
Oui. Toute entrée que vous ajoutez dans l'onglet Variables personnalisées devient disponible en tant qu'espace réservé sous le nom de variable que vous avez choisi. Par exemple, une variable personnalisée nommée support_phone devient {support_phone} dans le corps de votre message. Consultez Variables personnalisées.
Quelle est la différence entre {wr_title} et {wr_subject} ?
Ils génèrent la même valeur — l'objet du message de rappel en cours. Les deux sont utilisés dans le modèle HTML d'enveloppe d'e-mail, et non dans l'éditeur de messages lui-même. Vous n'avez pas besoin d'utiliser l'un ou l'autre dans les champs Objet ou Corps de votre message.