Bon d’anniversaire – manuel d’utilisation du module PrestaShop

Page du module : Bon d’anniversaire PDF · 181 KB

1. À quoi sert le module

Un message d’anniversaire accompagné d’un petit cadeau fait partie des rares e-mails marketing que les clients sont contents de recevoir. Le module envoie à chaque client qui a indiqué sa date de naissance un code de réduction personnel pour son anniversaire — par exemple 15 % de remise valables 14 jours — par e-mail dans sa langue, une fois par an. Le code est un bon de réduction PrestaShop standard que seul ce client peut utiliser ; il le retrouve aussi dans la rubrique Bons de réduction de son compte.

Vous choisissez la réduction (pourcentage, montant fixe ou livraison gratuite), sa durée de validité, un panier minimal, combien de jours avant l’anniversaire l’envoyer et qui la reçoit (tous les clients, seulement les abonnés à la newsletter, seulement les clients ayant déjà commandé).

Compatible avec PrestaShop 1.7.8, 8.x et 9.x (PHP 7.2.5 ou plus récent), avec les thèmes Classic et Hummingbird et avec le multiboutique.

2. Installation

Téléchargez le module depuis Mon compte → Historique des commandes sur addonspresta.com.
Dans votre back-office, ouvrez Modules → Gestionnaire de modules et cliquez sur Installer un module.
Déposez le fichier ap_birthdaycoupon_v1.0.0.zip et attendez la confirmation.
Cliquez sur Configurer sur la fiche du module.

Le module fonctionne dès l’installation : le jour de leur anniversaire, les clients reçoivent un code de 15 % valable 14 jours, envoyé à la première visite du jour dans votre boutique. Consultez le panneau Dates de naissance et envoi quotidien : si PrestaShop ne demande pas encore la date de naissance, cliquez sur Activer le champ date de naissance.

3. Fonctionnement

PrestaShop demande la date de naissance dans le formulaire d’inscription et dans le compte client quand Paramètres de la boutique → Clients → Demander la date de naissance est activé. Une fois par jour, le module cherche les clients de chaque boutique dont c’est l’anniversaire aujourd’hui (ou dans le nombre de jours choisi) et crée pour chacun un code — un bon de réduction dans Catalogue → Réductions avec la description ap_birthdaycoupon <année>, réservé au client, utilisable une fois, mis en avant dans le panier — puis envoie l’e-mail d’anniversaire.

Une fois par an. Un client reçoit un code par anniversaire, quel que soit le nombre de lancements de l’envoi.
Clients avec un compte, actifs, avec une adresse e-mail valide. Les invités ne sont pas concernés.
29 février. Les clients nés un 29 février reçoivent leur code le 28 février les autres années.
Valable à partir de l’anniversaire pendant le nombre de jours choisi, jusqu’à la fin du dernier jour. Un code envoyé quelques jours à l’avance fonctionne dès son envoi.

L’envoi quotidien démarre de l’une de ces trois façons :

Une tâche cron (recommandé) : votre serveur appelle l’adresse affichée dans le panneau une fois par jour, à l’heure choisie.
La première visite du jour : sans tâche cron, le premier visiteur du jour le lance (activé par défaut).
Envoyer les codes du jour maintenant dans le panneau.

Un lancement par la tâche cron ou le bouton envoie au plus 200 codes, un lancement par une visite au plus 25 ; le suivant continue avec le reste. Le module ne se connecte ni à addonspresta.com ni à aucun autre serveur et ne dépose aucun cookie.

4. Fonctions et réglages

Ouvrez Modules → Gestionnaire de modules → Bon d’anniversaire → Configurer. Le cadre Aide, en haut, renvoie vers ce manuel et vers la page du module sur addonspresta.com, dans la langue de votre back-office.

Dates de naissance et envoi quotidien

Un avertissement et le bouton Activer le champ date de naissance quand PrestaShop ne demande pas la date de naissance dans une boutique de la sélection.
Pour chaque boutique : combien de clients ont indiqué leur date de naissance et quand l’envoi s’est terminé la dernière fois.
La tâche cron avec son adresse. Gardez-la secrète : elle contient un jeton, et quiconque la connaît peut lancer l’envoi quotidien (il ne peut rien faire d’autre avec).
Envoyer les codes du jour maintenant — lance l’envoi des boutiques sélectionnées dans l’en-tête. Les clients qui ont déjà leur code de l’année n’en reçoivent pas d’autre.

Codes d’anniversaire

Envoyer des codes d’anniversaire : désactive le module sans perdre les réglages ; les codes envoyés restent valables.
Envoyer le code … jours avant l’anniversaire : 0 l’envoie le jour même, jusqu’à 30 jours avant.
Uniquement les clients inscrits à la newsletter : un e-mail d’anniversaire avec une offre est du marketing. Dans l’UE, ne l’envoyez qu’aux clients qui l’ont accepté, par exemple en s’inscrivant à la newsletter.
Uniquement les clients ayant déjà commandé : clients ayant au moins une commande payée.
Lancer à la première visite du jour : pour les boutiques sans tâche cron. Avec une tâche cron, vous pouvez la désactiver.

Réduction

Type de réduction : Pourcentage des produits, Montant fixe ou Livraison gratuite.
Valeur de la réduction : un pourcentage de 0,01 à 100, ou un montant TTC dans la devise par défaut ; inutilisée pour la livraison gratuite.
Valable : de 1 à 365 jours, comptés à partir de l’anniversaire.
Montant minimal du panier pour utiliser le code : TTC ; 0 = sans minimum.
Pas sur les produits déjà en promotion : la réduction ignore les produits avec un prix spécifique ou une règle de prix catalogue.
Cumulable avec d’autres bons de réduction : désactivé, le code ne peut pas être utilisé avec un autre bon.
Nom du bon de réduction : dans chaque langue, visible dans le panier et dans la rubrique Bons de réduction. Par défaut « Joyeux anniversaire ! ».
Préfixe du code : jusqu’à 10 lettres, chiffres ou tirets avant 8 caractères aléatoires, par exemple BDAY-7KQ2M9XA.

Les modifications s’appliquent aux codes envoyés ensuite. Pour modifier un code déjà envoyé, passez par Catalogue → Réductions.

Codes créés

Les 50 derniers codes des boutiques sélectionnées dans l’en-tête : date, client, anniversaire (jour et mois), code, réduction, date de fin, état — Non utilisé, Utilisé, Expiré ou Supprimé — et l’envoi de l’e-mail.

5. Multiboutique

Les réglages sont enregistrés pour la boutique ou le groupe choisi dans l’en-tête du back-office. Choisissez Toutes les boutiques pour appliquer les mêmes règles partout, ou une seule boutique pour lui donner sa propre réduction et ses textes. Chaque client reçoit le code de la boutique où il s’est inscrit, valable uniquement dans cette boutique. L’adresse cron lance toutes les boutiques. Dans le contexte Toutes les boutiques ou groupe, seul un employé qui gère toutes ses boutiques peut enregistrer ou activer le champ date de naissance. Une licence couvre toutes les boutiques de l’installation.

6. Désinstallation

Gestionnaire de modules → Bon d’anniversaire → Désinstaller supprime les réglages du module et sa liste des codes créés. Les codes restent dans Catalogue → Réductions et fonctionnent jusqu’à leur expiration. Le champ date de naissance de PrestaShop reste tel quel. Pour garder les réglages, choisissez plutôt Désactiver. Supprimez aussi la tâche cron de votre serveur.

7. Questions fréquentes et dépannage

Aucun code n’est parti aujourd’hui. Vérifiez dans le panneau Dates de naissance et envoi quotidien que le champ date de naissance est activé, que des clients ont une date de naissance et quand l’envoi s’est terminé. Le client doit avoir un compte, être actif et correspondre aux options (newsletter, commandes précédentes). Sans tâche cron, l’envoi démarre à la première visite du jour ; Envoyer les codes du jour maintenant le lance tout de suite.

Le client n’a pas reçu l’e-mail. Vérifiez les réglages d’e-mail dans Paramètres avancés → E-mail (l’e-mail de test). Le panneau Codes créés indique si l’e-mail a été envoyé. Le code figure aussi dans la rubrique Bons de réduction du compte client.

Comment configurer la tâche cron ? Dans le panneau de votre hébergeur, ajoutez une tâche qui appelle l’adresse du panneau une fois par jour, par exemple curl -fsS "https://votre-boutique.fr/module/ap_birthdaycoupon/cron?token=…" à 8 h. Vous pouvez ensuite désactiver Lancer à la première visite du jour.

Le panier refuse le code. Le client doit être connecté au compte auquel appartient le code, le panier doit atteindre le montant minimal et le code ne doit être ni expiré ni utilisé. Avec Pas sur les produits déjà en promotion, un panier contenant uniquement des produits remisés n’obtient pas de réduction ; sans Cumulable avec d’autres bons de réduction, retirez d’abord l’autre bon.

Peut-on créer plusieurs comptes pour collecter des codes ? Chaque compte reçoit au plus un code par an, mais un nouveau compte dont l’anniversaire tombe demain en reçoit un aussi. Si c’est un risque pour votre boutique, activez Uniquement les clients ayant déjà commandé.

Puis-je modifier l’e-mail ? Copiez mails/<langue>/ap_birthdaycoupon.html et .txt du module dans themes/<votre-thème>/modules/ap_birthdaycoupon/mails/<langue>/ et modifiez les copies.

Un texte reste en anglais dans ma boutique en français. Remplissez le nom du bon de réduction de cette langue dans la configuration du module. Les autres textes se traduisent dans International → Traductions → Traductions des modules installés.

8. Mises à jour et assistance

Les mises à jour sont gratuites à vie : téléchargez les nouvelles versions depuis Mon compte → Historique des commandes sur addonspresta.com et installez-les comme un nouveau module. Vos réglages sont conservés.

L’assistance est incluse pendant 12 mois à compter de la commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact d’addonspresta.com (du lundi au vendredi, de 10 h à 16 h ; réponse généralement sous 2 jours ouvrés). Indiquez votre version de PrestaShop, la version du module et les étapes qui mènent au problème.

Retour : Manuels des modules