Variables Personnalisées
Les variables personnalisées vous permettent de définir des espaces réservés réutilisables — comme votre numéro de compte bancaire, votre IBAN ou votre téléphone d'assistance — une seule fois, puis de les insérer dans n'importe quel e-mail de rappel en tapant {nom_variable}.
Disponible depuis la v1.2.0
Présentation
Chaque rappel de paiement doit indiquer à vos clients où envoyer leur règlement. Saisir manuellement vos coordonnées bancaires dans chaque message est fastidieux et source d'erreurs. Si votre numéro de compte change, vous devrez mettre à jour chaque message individuellement.
Les variables personnalisées résolvent ce problème. Vous définissez un espace réservé nommé une seule fois — par exemple account_number — puis vous écrivez {account_number} à l'endroit voulu dans l'objet ou le corps d'un e-mail. Lorsque le module envoie un rappel, il remplace automatiquement l'espace réservé par la valeur réelle.
Il existe deux types de variables. Valeur statique stocke un texte fixe que vous saisissez directement. Clé de configuration lit sa valeur en direct depuis une clé de configuration PrestaShop, ce qui est utile lorsqu'une valeur est déjà stockée dans PrestaShop et que vous souhaitez que vos e-mails restent synchronisés automatiquement sans maintenir deux copies de la même information.
Les variables sont limitées à votre boutique. Dans un contexte multiboutique, chaque boutique gère sa propre liste de variables, ce qui vous permet d'avoir des comptes bancaires ou des coordonnées différents par boutique.
Configuration
Ajouter une Variable
- Rendez-vous dans Modules > Gestionnaire de modules, trouvez Order Payment Reminders Pro et cliquez sur Configurer.
- Faites défiler jusqu'à la section Variables Personnalisées sur la page principale du tableau de bord (en dessous de la liste de vérification de configuration).
- Remplissez le formulaire Ajouter une nouvelle variable en bas du panneau :
| Champ | Obligatoire | Description |
|---|---|---|
| Nom de la variable | Oui | Un identifiant court contenant uniquement des lettres, des chiffres et des tirets bas. Doit commencer par une lettre ou un tiret bas. Exemples : account_number, bank_address, support_phone. Maximum 64 caractères. |
| Type | Oui | Valeur statique — stocker le texte directement. Clé de configuration — lire la valeur depuis une clé de configuration PrestaShop à chaque envoi d'e-mail. |
| Valeur | Oui | Pour Valeur statique : le texte à insérer (255 caractères max, balises HTML supprimées). Pour Clé de configuration : le nom de la clé de configuration en majuscules, par ex. PS_SHOP_EMAIL. |
- Cliquez sur Ajouter.
Le tableau se rafraîchit immédiatement et votre nouvelle variable apparaît. La colonne Aperçu affiche la valeur résolue afin que vous puissiez vérifier qu'elle est correcte.
Les noms de variables sont sensibles à la casse dans les modèles. Une variable nommée
account_numberdoit être écrite{account_number}— pas{Account_Number}ni{ACCOUNT_NUMBER}.
Modifier une Variable
- Dans le tableau Variables Personnalisées, cliquez sur l'icône crayon (modifier) sur la ligne que vous souhaitez changer.
- Mettez à jour le nom, le type ou la valeur selon vos besoins.
- Cliquez sur Enregistrer.
Si vous modifiez le nom d'une variable après qu'elle a été utilisée dans des messages, l'ancien espace réservé ne sera plus remplacé. Mettez d'abord à jour le contenu des messages, puis renommez la variable.
Supprimer une Variable
- Dans le tableau Variables Personnalisées, cliquez sur l'icône de corbeille rouge sur la ligne que vous souhaitez supprimer.
- Confirmez la suppression.
La suppression est immédiate et définitive. Tout espace réservé {nom_variable} déjà écrit dans vos modèles de messages apparaîtra en texte brut dans les e-mails. Supprimez-les de vos messages avant de supprimer une variable.
Utiliser une Variable dans un E-mail
- Ouvrez le message de rappel que vous souhaitez modifier (dans la section Messages de la configuration du module).
- Dans le champ Objet ou le corps du message, tapez
{nom_variable}à l'endroit exact où vous souhaitez que la valeur apparaisse. - Enregistrez le message.
Lorsque la tâche cron s'exécute, chaque espace réservé {nom_variable} est remplacé par sa valeur résolue avant que l'e-mail ne soit envoyé au client. Vous pouvez combiner librement les variables personnalisées avec les variables intégrées ({totalamount}, {completename}, {daysleft}, etc.) aussi bien dans l'objet que dans le corps.
Fonctionnement
Lorsque votre tâche cron s'exécute et qu'un rappel est dû, le module récupère toutes les variables personnalisées définies pour cette boutique. Pour chaque variable de type Valeur statique, il utilise le texte que vous avez enregistré. Pour chaque variable de type Clé de configuration, il lit la valeur actuelle depuis la table de configuration de PrestaShop à ce moment précis — ainsi, si le paramètre sous-jacent a changé depuis que vous avez enregistré la variable, l'e-mail utilise automatiquement la valeur mise à jour.
Après avoir collecté toutes les valeurs résolues, le module effectue un seul passage sur l'objet et le corps de l'e-mail, en remplaçant chaque occurrence du motif {nom_variable} trouvé. Les espaces réservés sans variable correspondante sont laissés tels quels et apparaissent en texte brut dans l'e-mail envoyé.
Variables de Type Valeur Statique
Lorsque vous choisissez Valeur statique, le texte que vous saisissez est stocké directement et utilisé tel quel dans chaque e-mail. Les balises HTML sont automatiquement supprimées lors de l'enregistrement, de sorte que la valeur est toujours du texte brut. C'est le bon choix pour les coordonnées de paiement, les numéros IBAN, les codes BIC, les noms de banque et tout autre texte que vous gérez et mettez à jour manuellement.
Variables de Type Clé de Configuration
Lorsque vous choisissez Clé de configuration, vous saisissez le nom d'une clé de configuration PrestaShop en majuscules (par exemple PS_SHOP_NAME ou PS_SHOP_EMAIL). Lorsque vous quittez le champ, le module valide immédiatement la clé et affiche un aperçu de sa valeur actuelle. Si la clé est introuvable, un message d'erreur rouge « Non trouvée » s'affiche.
Au moment de l'envoi de l'e-mail, la valeur est lue en direct depuis la table de configuration, de sorte que vos rappels reflètent automatiquement toute modification du paramètre PrestaShop sous-jacent. C'est le bon choix pour toute valeur déjà stockée et maintenue ailleurs dans votre boutique — le nom de votre boutique, votre numéro de téléphone ou une valeur définie par un autre module installé.
Seules les valeurs de configuration de type chaîne de caractères simple ou numérique sont prises en charge. Les clés de configuration contenant des données complexes (tableaux ou objets JSON) sont rejetées.
Exemples d'Utilisation
Exemple : Instructions de virement bancaire
Une boutique utilisant le virement bancaire souhaite que chaque rappel inclue ses coordonnées de paiement. Créez trois variables :
| Nom de la variable | Type | Valeur |
|---|---|---|
iban | Valeur statique | DE89 3704 0044 0532 0130 00 |
bic | Valeur statique | COBADEFFXXX |
bank_name | Valeur statique | Commerzbank AG |
Dans le corps du message, écrivez :
Please transfer the outstanding amount of {totalamount} to:
Bank: {bank_name}
IBAN: {iban}
BIC/SWIFT: {bic}
Reference: Order #{reference}
Payment must be received within {daysleft} days.
Si vos coordonnées bancaires changent, mettez à jour les trois variables une seule fois et tous les futurs rappels reflètent le changement immédiatement.
Exemple : Téléphone du service client via une clé de configuration PrestaShop
Votre numéro de téléphone est déjà défini dans Paramètres de la boutique > Coordonnées. Plutôt que de le dupliquer, créez une variable :
| Nom de la variable | Type | Valeur |
|---|---|---|
support_phone | Clé de configuration | PS_SHOP_PHONE |
Insérez ensuite {support_phone} dans le pied de page de votre message : « Des questions ? Appelez-nous au {support_phone}. » Si vous mettez à jour le numéro de téléphone dans les paramètres de boutique de PrestaShop, tous les futurs rappels utilisent automatiquement le nouveau numéro — aucune autre action n'est nécessaire.
Exemple : Lien vers un portail de paiement
Votre boutique propose une page de paiement hébergée où les clients peuvent finaliser leur paiement en ligne. Stockez l'URL une seule fois :
| Nom de la variable | Type | Valeur |
|---|---|---|
payment_portal_url | Valeur statique | https://pay.yourstore.com/complete |
Dans l'objet de votre rappel : « Finalisez votre paiement sur {payment_portal_url} ». Tous les messages de rappel, pour toutes vos méthodes de paiement, incluront la même URL à jour.
Remarques Importantes
- Le HTML n'est pas autorisé dans les valeurs de variables. Toute balise HTML dans une Valeur statique est automatiquement supprimée lors de l'enregistrement. Si vous avez besoin d'un lien cliquable dans un e-mail, écrivez la balise
<a>directement dans le corps du message et utilisez une variable uniquement pour la partie URL. - Les noms de variables sont uniques par boutique. Vous ne pouvez pas avoir deux variables avec le même nom dans la même boutique. Tenter d'enregistrer un nom en doublon génère une erreur.
- Les variables de type Clé de configuration sont validées à la saisie. Si la clé n'existe pas ou contient une valeur complexe (tableau ou objet), le module la rejette avec un message d'erreur explicite.
- Multiboutique : Chaque boutique possède sa propre liste de variables indépendante. Changer de boutique dans le Back Office affiche uniquement les variables de cette boutique. Les variables ne sont pas partagées entre boutiques.
- Les variables sans valeur résolue sont ignorées silencieusement. Si une Clé de configuration est ultérieurement supprimée de PrestaShop, l'espace réservé apparaîtra en texte brut dans les e-mails plutôt que d'insérer une valeur vide. Supprimez les espaces réservés obsolètes de vos modèles de messages si vous supprimez la clé de configuration sous-jacente.
- Les noms de variables sont sensibles à la casse.
{iban}et{IBAN}sont traités comme des espaces réservés différents.
Résolution des Problèmes
| Problème | Solution |
|---|---|
{nom_variable} apparaît en texte brut dans l'e-mail envoyé | Le nom dans le modèle d'e-mail ne correspond pas exactement au nom de la variable dans le tableau. Vérifiez les fautes de frappe, les majuscules ou les espaces. Les noms de variables sont sensibles à la casse. |
| Erreur « Le nom de variable ne peut contenir que des lettres, des chiffres et des tirets bas » | Le nom saisi contient un espace, un tiret ou un caractère spécial. Utilisez des tirets bas à la place (ex. bank_address et non bank address). |
| La Clé de configuration affiche « Non trouvée » dans l'aperçu | La clé saisie n'existe pas dans la table de configuration de PrestaShop. Vérifiez l'orthographe et assurez-vous que le module qui crée cette clé est installé et a été configuré au moins une fois. |
| La Clé de configuration affiche « La valeur de configuration n'est pas d'un type simple » | La clé contient un tableau ou un objet JSON (ex. un module de paiement stockant une configuration complexe). Seules les valeurs de type chaîne de caractères simple ou numérique sont prises en charge. Utilisez plutôt une variable de type Valeur statique et mettez-la à jour manuellement. |
| Variable supprimée, les e-mails affichent maintenant l'espace réservé brut | Vous avez supprimé une variable encore référencée dans un modèle de message. Modifiez les messages concernés et supprimez ou remplacez l'espace réservé {nom_variable}. |
| La valeur de la variable a changé mais les e-mails affichent toujours l'ancienne valeur | Pour les variables Statiques, ouvrez la variable et enregistrez-la à nouveau avec la nouvelle valeur. Pour les variables Clé de configuration, confirmez que la configuration PrestaShop sous-jacente a bien été mise à jour et enregistrée. |
| Erreur de nom en doublon lors de l'enregistrement | Chaque nom de variable doit être unique au sein de la même boutique. Choisissez un nom différent ou modifiez la variable existante. |
Foire Aux Questions
Combien de variables personnalisées puis-je créer ?
Il n'y a pas de limite fixe. Vous pouvez créer autant de variables que votre boutique en a besoin.
Puis-je utiliser une variable personnalisée dans l'objet de l'e-mail ainsi que dans le corps ?
Oui. Les variables personnalisées sont remplacées aussi bien dans l'objet que dans le corps de chaque e-mail de rappel avant son envoi.
Que se passe-t-il si j'utilise {account_number} dans un message mais que je n'ai pas encore créé cette variable ?
L'espace réservé est laissé en texte brut dans l'e-mail envoyé — votre client verra {account_number} dans le message. Vérifiez toujours que vos variables existent et s'affichent correctement en aperçu avant d'activer un message.
Puis-je stocker un texte multiligne comme une adresse postale complète dans une variable ?
Non. Les valeurs de variables sont du texte brut stocké dans un champ sur une seule ligne (255 caractères maximum). Pour un contenu multiligne tel qu'une adresse postale complète, rédigez-le directement dans le corps du message à l'aide de l'éditeur de texte enrichi.
Une variable de type Clé de configuration se met-elle à jour automatiquement lorsque le paramètre PrestaShop change ?
Oui. La valeur est lue depuis la table de configuration à chaque exécution de la tâche cron et envoi d'e-mail, de sorte que toute modification du paramètre PrestaShop sous-jacent prend effet dès le prochain cycle de rappel, sans aucune action de votre part.
Puis-je utiliser la même variable dans plusieurs messages de rappel ?
Oui. Une variable définie une seule fois est disponible dans chaque message de rappel pour cette boutique. Insérez {nom_variable} dans autant de messages que nécessaire.
Quelle est la différence entre les Variables Personnalisées et les variables intégrées comme {totalamount} ?
Les variables intégrées sont alimentées automatiquement à partir des données de commande en temps réel — nom du client, total de la commande, jours restants, etc. Les variables personnalisées sont des textes que vous définissez vous-même, généralement des informations propres à votre boutique telles que les coordonnées de paiement ou les informations de contact qui ne proviennent pas d'une commande individuelle.
Les variables personnalisées sont-elles substituées dans les e-mails envoyés en Mode Test ?
Oui. Lorsque vous envoyez un e-mail de test depuis la section Mode Test, les variables personnalisées sont résolues et substituées exactement comme elles le seraient dans un rappel réel.
Que se passe-t-il si une Clé de configuration que j'ai utilisée est désinstallée ou supprimée ?
La variable continuera d'exister dans votre liste, mais l'espace réservé apparaîtra en texte brut dans les e-mails envoyés car la clé n'existe plus. Supprimez ou remplacez l'espace réservé dans vos modèles de messages, puis supprimez la variable de la liste pour garder les choses en ordre.