Assistant de configuration et tableau de bord
Lors de la première installation d'Order Payment Reminders Pro, une liste de contrôle en quatre étapes vous guide à travers tout ce dont le module a besoin avant de pouvoir commencer à envoyer des e-mails.
Disponible depuis la v1.2.0
Vue d'ensemble
Le tableau de bord Module Setup est le premier écran que vous voyez en ouvrant la configuration du module. Il affiche une barre de progression et un badge indiquant combien des quatre étapes requises ont été complétées — par exemple, « 2/4 étapes terminées ». Tant que les quatre étapes ne sont pas toutes effectuées, le module est inactif et n'envoie aucun rappel à vos clients.
Une fois toutes les étapes terminées, le badge devient vert et une bannière de statut confirme « Le module est actif et prêt à envoyer des rappels de paiement ! » À partir de ce moment, le tableau de bord reste accessible comme référence rapide. Vous pouvez rouvrir n'importe quelle étape à tout moment pour ajuster les paramètres.
L'ancien assistant de configuration (v1.1.0) a été remplacé par ce tableau de bord de liste de contrôle dans la v1.2.0. Si vous effectuez une mise à niveau depuis une version antérieure à la 1.2.0, le tableau de bord s'affiche automatiquement la prochaine fois que vous ouvrez la configuration du module.
Quand utiliser cet écran
- Première installation : complétez les quatre étapes avant de planifier la tâche cron. Le module n'enverra pas d'e-mails tant que l'étape 4 (Test et vérification) n'est pas effectuée.
- Après avoir modifié votre hôte de messagerie ou vos paramètres SMTP : refaites l'étape 4 pour confirmer que les e-mails arrivent toujours dans votre boîte de réception.
- Après avoir ajouté un nouveau mode de paiement à votre boutique : rouvrez l'étape 2, cochez le nouveau module de paiement et enregistrez.
- Après avoir changé le style du modèle d'e-mail : rouvrez l'étape 1, sélectionnez un autre modèle prédéfini et enregistrez.
Configuration
La liste de contrôle de configuration ne comporte pas de bouton d'activation global — elle est elle-même la configuration. Suivez chaque étape ci-dessous.
Étape 1 — Modèle d'e-mail
Cette étape définit l'enveloppe HTML qui entoure chaque e-mail de rappel de paiement. Considérez-la comme le design de l'enveloppe — le sujet et le corps de chaque message y sont insérés.
Badge de statut : « Requis » (orange) tant qu'aucun fichier de modèle valide n'est enregistré ; « Configuré » (vert) après l'enregistrement.
- Cliquez sur l'en-tête Étape 1 : Modèle d'e-mail pour le développer.
- Choisissez l'une des quatre options dans le menu déroulant Sélectionnez un modèle prédéfini ou personnalisez le vôtre :
| Option | Description |
|---|---|
| Minimal — Épuré et simple | Mise en page en tableau simple, sans décoration. Compatible avec tous les clients de messagerie. |
| Professionnel — Style business | Mise en page avec bordures, barre d'en-tête grise et pied de page. Idéal pour les boutiques formelles. |
| Convivial — Chaleureux et personnel | Fond crème, police à empattements, pied de page chaleureux. |
| Personnalisé — Repartir de zéro | Ouvre un éditeur vierge pour écrire votre propre HTML. |
- Après avoir sélectionné un modèle prédéfini, l'éditeur charge le HTML correspondant. Vous pouvez modifier les couleurs, les polices ou la mise en page selon vos souhaits.
- Le modèle doit contenir
{wr_title}et{wr_message}exactement tels qu'écrits. L'enregistrement échoue avec une alerte si l'un ou l'autre espace réservé est absent. - Cliquez sur Enregistrer le modèle. La page se recharge et l'étape 1 affiche le badge vert « Configuré ».
{wr_title}est remplacé au moment de l'envoi par le sujet de ce rappel spécifique.{wr_message}est remplacé par le corps que vous rédigez lors de la création d'un message à l'étape 3.
Si vous choisissez Personnalisé, l'éditeur s'ouvre vide. Collez votre propre HTML et incluez les deux espaces réservés requis avant d'enregistrer.
Étape 2 — Modules de paiement
Cette étape indique au module quels modes de paiement doivent déclencher des rappels. Seules les commandes passées avec l'un des modules de paiement sélectionnés recevront des e-mails.
Badge de statut : « Requis » (orange) tant qu'aucun module n'est enregistré ; « Configuré » (vert) après l'enregistrement.
- Cliquez sur l'en-tête Étape 2 : Modules de paiement pour le développer.
- Une case à cocher s'affiche pour chaque module de paiement actuellement installé dans votre boutique.
- Cochez chaque mode de paiement dont les commandes impayées doivent recevoir des rappels. Pour la plupart des boutiques, il s'agit du module Virement bancaire. Si vous utilisez également un module de paiement par facture personnalisé, cochez-le aussi.
- Cliquez sur Enregistrer les modules de paiement. La page se recharge et l'étape 2 affiche le badge vert « Configuré ».
Vous pouvez sélectionner plusieurs modules de paiement. Chaque message de rappel individuel que vous créerez ultérieurement pourra être filtré pour s'appliquer à un module de paiement spécifique ou à tous les modules sélectionnés.
Si un module de paiement est installé mais non coché ici, les commandes de ce module sont complètement ignorées — aucun rappel, aucune annulation automatique.
Étape 3 — Créer des messages
Cette étape crée au moins un message de rappel. Un message définit le délai (nombre de jours ou d'heures après la commande), le sujet, le corps, et si la commande doit être annulée après l'envoi de ce message.
Badge de statut : « Requis » (orange) tant qu'aucun message n'existe ; affiche le nombre de messages en vert dès qu'au moins un est enregistré.
Deux options s'offrent à vous :
Option A — Utiliser un modèle prérédigé
L'étape affiche trois catégories de modèles de messages prêts à l'emploi :
| Catégorie | Objectif |
|---|---|
| Rappel doux | Premiers rappels amicaux, peu de pression. |
| Relance persistante | Deuxièmes ou troisièmes rappels pour les commandes sans réponse. |
| Urgent / Final | Messages de dernière chance envoyés peu avant l'annulation automatique. |
Sélectionnez un modèle dans le menu déroulant de n'importe quelle catégorie pour le charger automatiquement dans le formulaire de création de message.
Option B — Créer de zéro
Cliquez sur Créer un nouveau message. Cela vous amène au formulaire de message où vous définissez le délai, le sujet, le corps et l'option d'annulation pour ce rappel spécifique.
Une fois qu'au moins un message existe, la page se recharge et l'étape 3 affiche le badge avec le nombre de messages (par exemple, « 3 messages »).
Vous pouvez ajouter d'autres messages à tout moment après la configuration. Une séquence type comprend trois messages : un à 2 jours, un à 5 jours, et un avertissement final à 8 jours avec annulation automatique activée.
Étape 4 — Test et vérification
Cette étape envoie un vrai e-mail via le système de messagerie de votre boutique pour confirmer que la distribution fonctionne. Vous cliquez sur un lien de vérification dans cet e-mail, et le module se marque comme vérifié et actif.
Badge de statut : « Verrouillé » (gris) tant que les étapes 1 à 3 sont incomplètes ; « Requis » (orange) une fois les étapes 1 à 3 terminées ; « Vérifié » (vert) après avoir cliqué sur le lien dans l'e-mail de test.
- Complétez d'abord les étapes 1, 2 et 3 — l'étape 4 est verrouillée tant que les trois premières ne sont pas terminées.
- Cliquez sur l'en-tête Étape 4 : Test et vérification pour le développer.
- Dans le champ Adresse e-mail, saisissez une adresse e-mail que vous pouvez consulter immédiatement. L'e-mail administrateur de votre boutique est pré-rempli.
- Cliquez sur Envoyer l'e-mail de test. Le bouton se désactive pendant l'envoi.
- Consultez votre boîte de réception pour l'objet « Test Email - Order Payment Reminders ». Ouvrez l'e-mail.
- Cliquez sur le bouton Vérifier la livraison de l'e-mail dans l'e-mail. Cela vous amène à une page de confirmation sur la partie publique de votre boutique.
- Retournez dans le Back Office et actualisez la page de configuration du module. L'étape 4 affiche désormais le badge vert « Vérifié », et l'alerte de statut global indique « Le module est actif et prêt à envoyer des rappels de paiement ! »
Le lien de vérification expire après 24 heures. Si vous ne le cliquez pas à temps, revenez à l'étape 4 et envoyez un nouvel e-mail de test pour générer un nouveau lien.
Si l'e-mail de test n'arrive jamais, vérifiez les paramètres de messagerie de votre boutique sous Paramètres avancés > E-mail. Le module utilise la même configuration de messagerie que tous les autres e-mails transactionnels PrestaShop.
Fonctionnement
Logique de complétion de la configuration
Le module vérifie les quatre conditions en temps réel. Chaque fois que vous ouvrez la page de configuration, il vérifie si le fichier de modèle existe et contient les deux espaces réservés requis, si au moins un module de paiement est enregistré, si au moins un message de rappel existe dans la base de données, et si l'indicateur de vérification est activé. Les quatre conditions doivent être remplies avant que le tableau de bord affiche le statut « Module actif ».
Le tableau de bord s'affiche automatiquement dès qu'une de ces conditions n'est pas satisfaite — que vous ayez déjà visité la configuration ou non. Si vous supprimez tous vos messages de rappel, par exemple, le tableau de bord réapparaît à la prochaine ouverture du module.
Après la fin de la configuration
Une fois les quatre étapes vérifiées, deux choses changent :
- Le badge de progression en haut affiche « 4/4 étapes terminées » avec un fond vert.
- L'alerte de statut passe à « Le module est actif et prêt à envoyer des rappels de paiement ! »
Le panneau Statistiques de récupération apparaît sous la liste de contrôle une fois que le module a traité des commandes. Avant que des données soient disponibles, le panneau affiche un message de substitution. Lorsque les statistiques sont disponibles, vous verrez :
| Statistique | Description |
|---|---|
| Commandes relancées | Commandes uniques ayant reçu au moins un rappel au cours des 6 derniers mois. |
| Commandes récupérées | Commandes qui ont été payées par la suite après avoir reçu un rappel. |
| Chiffre d'affaires récupéré | Valeur totale de ces commandes récupérées, dans la devise de votre boutique. |
| Taux de récupération | Commandes récupérées ÷ Commandes relancées × 100. Affiché en vert au-dessus de 20 %, en orange en dessous. |
Un tableau de répartition mensuelle affiche les mêmes chiffres par mois calendaire.
Compatibilité avec l'ancien assistant
Si l'indicateur wr_first est encore à 1 (boutiques configurées avant la v1.2.0 n'ayant jamais terminé l'ancien assistant), le module continue d'afficher l'ancien assistant pour assurer la compatibilité ascendante. En cliquant sur Ignorer l'assistant, wr_first est mis à 0 et la page se recharge, affichant alors le tableau de bord moderne.
Exemples d'utilisation
Exemple : Nouvelle boutique avec paiement par virement bancaire
Installez le module et ouvrez sa configuration. Le tableau de bord affiche 0/4 étapes terminées. Sélectionnez le modèle « Professionnel » à l'étape 1 et cliquez sur Enregistrer le modèle. À l'étape 2, cochez Virement bancaire (ps_wirepayment) et cliquez sur Enregistrer les modules de paiement. À l'étape 3, sélectionnez le modèle « Rappel doux » dans le menu déroulant pour créer votre premier rappel à 3 jours. Cliquez sur Créer un nouveau message et enregistrez-le. À l'étape 4, saisissez votre adresse e-mail et envoyez l'e-mail de test. Cliquez sur le lien de vérification. Le tableau de bord affiche 4/4 étapes terminées et vous êtes prêt à planifier la tâche cron.
Exemple : Ajout d'un second mode de paiement ultérieurement
Après avoir ajouté un nouveau plugin de paiement par facture à votre boutique, vous constatez qu'il ne déclenche pas de rappels. Retournez dans la configuration du module — le tableau de bord affiche toujours 4/4 car votre module de paiement existant est toujours sélectionné. Cliquez sur l'en-tête Étape 2, cochez le nouveau module de paiement par facture en plus des modules existants, et cliquez sur Enregistrer les modules de paiement. Aucune autre étape ne nécessite de modification.
Exemple : Récupération après une migration de serveur de messagerie
Après avoir migré vers un nouveau serveur de messagerie, vous souhaitez confirmer que les rappels sont toujours envoyés correctement. Ouvrez la configuration du module. Même si le tableau de bord affiche 4/4, cliquez sur l'en-tête Étape 4, saisissez votre e-mail et cliquez sur Envoyer l'e-mail de test. Cliquez sur le nouveau lien de vérification. L'état vérifié est actualisé et vous pouvez être sûr que les e-mails parviennent à vos clients.
Remarques importantes
- Les étapes doivent être complétées dans l'ordre — l'étape 4 est verrouillée et ne peut pas être cliquée tant que les étapes 1 à 3 n'affichent pas toutes le badge vert.
- Le tableau de bord est propre à chaque boutique dans une configuration multi-boutiques. La configuration de chaque boutique doit être effectuée indépendamment lors de l'utilisation du mode multi-boutiques.
- La suppression de tous les messages de rappel entraîne la réapparition du tableau de bord au prochain chargement de page, car l'étape 3 n'est plus satisfaite.
- L'indicateur
wr_first(l'ancien indicateur de l'assistant) et la cléwr_setup_completecoexistent. Pour les nouvelles installations après la v1.2.0, le tableau de bord est le seul flux que vous verrez. Lors des mises à niveau, les deux indicateurs peuvent être présents, mais la logique du tableau de bord a la priorité.
Résolution des problèmes
| Problème | Solution |
|---|---|
| L'étape 4 affiche « Verrouillé » même si j'ai terminé les étapes 1 à 3 | Rechargez la page. Les trois étapes précédentes doivent toutes afficher le badge vert. Si l'étape 2 affiche toujours « Requis », cliquez à nouveau sur Enregistrer les modules de paiement avec au moins un module coché. |
| L'e-mail de test n'arrive jamais | Accédez à Paramètres avancés > E-mail dans votre Back Office et envoyez un test depuis là. Si cela échoue également, votre configuration SMTP ou d'hébergement bloque les e-mails sortants. Corrigez les paramètres de messagerie avant de revenir à l'étape 4. |
| J'ai cliqué sur le lien de vérification mais l'étape 4 affiche toujours « Requis » | Le lien a peut-être expiré (valide 24 heures). Retournez à l'étape 4, envoyez un nouvel e-mail de test et cliquez sur le nouveau lien. |
Alerte « Le modèle doit contenir les espaces réservés {wr_title} et {wr_message} » lors de l'enregistrement | La zone de texte du modèle est manquante d'un ou des deux espaces réservés requis. Recherchez {wr_title} et {wr_message} dans l'éditeur et ajoutez-les si absents. |
| Le modèle a été enregistré mais le badge affiche toujours « Requis » après le rechargement | Le fichier de modèle n'a pas pu être écrit sur le disque. Vérifiez que modules/wiretransferreminder/mails/template/ est accessible en écriture par l'utilisateur du serveur web. |
| Le lien de vérification donne une erreur « page introuvable » | Le lien utilise le système d'URL conviviales de votre boutique. Assurez-vous que le fichier .htaccess est en place et que les URL conviviales du front-office sont activées sous Préférences > SEO et URLs. Si votre boutique est en mode maintenance, désactivez-le temporairement au moment de cliquer sur le lien. |
| Les statistiques de récupération affichent zéro même si des rappels ont été envoyés | Les statistiques comptabilisent uniquement les commandes dont le statut de paiement est passé à un état payé après l'envoi d'un rappel. Les commandes payées avant la livraison du rappel ne sont pas comptées comme des récupérations. |
Foire aux questions
Puis-je modifier le modèle d'e-mail après la fin de la configuration ?
Oui. Ouvrez la configuration du module, cliquez sur l'en-tête Étape 1 : Modèle d'e-mail, sélectionnez un nouveau modèle prédéfini ou modifiez le HTML existant, puis cliquez sur Enregistrer le modèle. La modification s'applique immédiatement à tous les futurs e-mails de rappel et n'affecte pas les messages que vous avez déjà créés.
Que se passe-t-il si je passe l'étape 4 et active la tâche cron quand même ?
Le point d'accès cron n'est pas bloqué par l'indicateur de vérification — il tentera d'envoyer des rappels dans tous les cas. Si aucun message n'existe encore, rien n'est envoyé. Complétez les quatre étapes avant de planifier la tâche cron pour éviter d'envoyer des e-mails mal configurés.
Le changement de modèle d'e-mail affecte-t-il les messages que j'ai déjà créés ?
Non. Le modèle n'est que l'enveloppe visuelle extérieure. Les messages existants conservent leur propre sujet et corps. Seul le conteneur de design qui les entoure change.
Puis-je utiliser un design HTML entièrement personnalisé pour le modèle ?
Oui. Choisissez Personnalisé — Repartir de zéro dans le menu déroulant des modèles, collez votre propre HTML dans l'éditeur et enregistrez. La seule exigence est que votre HTML contienne {wr_title} et {wr_message} quelque part dans le corps.
J'ai sélectionné le modèle Professionnel mais je veux changer la couleur de l'en-tête. Est-ce possible ?
Oui. Après avoir sélectionné Professionnel dans le menu déroulant, le HTML se charge dans l'éditeur. Trouvez la couleur d'arrière-plan dans les attributs de style et remplacez-la par n'importe quelle valeur de couleur CSS valide. Enregistrez normalement.
Comment réinitialiser l'état de vérification si quelque chose s'est mal passé lors de la première configuration ?
Ouvrez la configuration du module et refaites l'étape 4 — cliquez sur l'en-tête de l'étape 4, envoyez un nouvel e-mail de test et cliquez sur le nouveau lien de vérification. Chaque enregistrement dans n'importe quelle étape écrase la valeur précédente, il n'est donc pas nécessaire de désinstaller et réinstaller le module.
Le tableau de bord continue de réapparaître même si j'ai complété les quatre étapes auparavant.
Le module vérifie les quatre conditions en direct à chaque chargement de la page de configuration. La cause la plus fréquente est que tous les messages de rappel ont été supprimés (l'étape 3 échoue) ou que le fichier de modèle a été supprimé ou corrompu (l'étape 1 échoue). Vérifiez le badge de chaque étape pour trouver quelle condition n'est plus satisfaite.