DataFirefly Advent Calendar : calendrier de l’Avent pour PrestaShop
Installation et mise à jour, réglages et cron des rappels, modèles prêts à l'emploi, cases et codes promo, gain instantané, aperçu, e-mails, tirage au sort, statistiques et dépannage.
Installation et mise à jour
Installez le module depuis Modules > Gestionnaire de modules > Installer un module en envoyant le fichier ZIP, ou déposez le dossier dfadventcalendar dans le répertoire /modules/ de votre boutique puis cliquez sur Installer. Le même ZIP fonctionne de PrestaShop 1.7.8 à 9.x.
L’installation crée les tables du module, enregistre ses hooks, crée la page du calendrier (une adresse par langue) et ajoute l’onglet Catalogue > Réductions > Calendrier de l’Avent. Les images des cases sont stockées dans /img/dfadventcalendar/, hors du dossier du module.
Mise à jour depuis la 1.0.0 : envoyez le nouveau ZIP, PrestaShop lance la migration. Calendriers, cases, participants et codes sont conservés. L’ancienne adresse de la page est gardée dans toutes les langues pour que les liens déjà envoyés par e-mail continuent de fonctionner.
Réglages du module
La page de configuration du module (bouton Configurer) réunit les réglages communs à tous les calendriers.
- Adresse de la page du calendrier : une adresse par langue, par exemple
/calendrier-de-l-aventen français et/advent-calendaren anglais. Le module refuse une adresse déjà utilisée par une autre page. Le titre SEO de la page se règle dans Paramètres de la boutique > Trafic et SEO. - Fuseau horaire et heure de la boutique : les cases s’ouvrent dans ce fuseau, quel que soit celui du visiteur ou du serveur.
- Rappels par passage du cron : nombre maximum d’e-mails envoyés à chaque appel (150 par défaut).
- Conserver les données à la désinstallation : calendriers, cases, participants et images restent en base, prêts pour une réinstallation.
- Horloge de test (mode debug uniquement) : tout le calendrier se comporte comme s’il était la date et l’heure saisies. Le BO affiche un avertissement tant qu’elle est renseignée. Ne la laissez jamais active sur une boutique en production.
Rappel quotidien : tâche cron
Copiez l’adresse cron affichée et programmez-la toutes les 15 minutes dans le panneau de votre hébergeur :
*/15 * * * * curl -s "https://www.votre-boutique.fr/module/dfadventcalendar/cron?token=VOTRE_JETON" > /dev/null
Le calendrier fonctionne sans cron : seuls les e-mails de rappel en dépendent. La date du dernier passage est affichée, et la liste de lancement du tableau de bord signale un cron arrêté.

Créer un calendrier
Ouvrez Catalogue > Réductions > Calendrier de l’Avent. Le plus rapide est de partir d’un modèle : les dates, le nombre de cases, le thème et le titre dans toutes vos langues sont préparés. Il ne reste qu’à remplir les cases.
- Calendrier de l’Avent, 24 cases ou 25 cases avec le jour de Noël, à partir du 1ᵉʳ décembre ;
- Les 12 jours de Noël, du 13 au 24 décembre ;
- Semaine du Black Friday, 7 cases jusqu’au dernier vendredi de novembre ;
- Compte à rebours d’événement, 10 cases avant un lancement ou une vente privée.
Le bouton Calendrier vierge ou Nouveau calendrier laisse choisir chaque réglage.

Dates et ouverture
- Date de la première case et nombre de cases (de 1 à 60) : une case par jour à partir de cette date.
- Heure d’ouverture des cases : 00:00 pour minuit, ou une heure de rendez-vous comme 08:00. Avant cette heure, la case de la veille reste la case du jour.
Apparence
Neuf thèmes sont proposés : Forêt de sapins, Papier kraft, Givre, Nuit d’hiver, Sucre d’orge, et quatre thèmes hors Noël (Noir et or, Black Friday, Pastel de printemps, Lagon d’été). L’option Couleurs personnalisées active quatre couleurs. Trois styles de cases sont disponibles : portes battantes, paquets cadeaux avec ruban, tuiles épurées. Le décor anime le fond : neige, étoiles, confettis ou aucun. Un aperçu en direct montre le résultat pendant vos réglages.
Avec les tailles variées, la grille se remplit sans trou sur 6 ou 4 colonnes. Sur mobile, elle passe à 4 colonnes régulières. Les animations sont coupées pour les visiteurs qui demandent moins de mouvement sur leur appareil.

Participation
- E-mail obligatoire pour ouvrir les cases : si désactivé, les visiteurs ouvrent librement, mais les codes personnels et les jeux restent réservés aux inscrits.
- Réservé aux comptes clients : seuls les clients connectés participent, et leurs codes sont rattachés à leur compte. C’est la meilleure protection contre la collecte de codes avec des adresses jetables.
- Confirmer l’adresse e-mail (double opt-in) et case newsletter facultative, non cochée.
- Autoriser l’ouverture des cases passées : les codes partagés restent alors valables jusqu’à la fin du calendrier.
- Texte de consentement : ajoutez-y le lien vers votre politique de confidentialité.
Configurer les cases
Le tableau de bord du calendrier présente les cases sous forme de cartes : date, type, récompense, code, ouvertures, codes dévoilés et commandes. Les filtres À configurer, Avec un code, Gain instantané, Aujourd’hui et à venir et Passées, ainsi que la recherche, retrouvent une case en un instant. Chaque carte permet de modifier la case, de l’ouvrir en aperçu ou de l’activer.

Types de case
- Message : texte, image et bouton facultatif.
- Code promo : le code est mis en avant sur un ticket à copier ou à ajouter au panier.
- Produit dévoilé : fiche produit avec prix et bouton d’ajout au panier.
- Gain instantané : le participant tente sa chance et gagne la récompense selon la probabilité choisie.
Récompense et code
Remise en pourcentage, remise en montant, livraison offerte, produit offert, ou règle panier existante de la boutique, avec ses propres conditions. Pour les récompenses créées par le module :
- Code personnel : une règle panier à usage unique est générée à l’ouverture de la case. Elle est rattachée au compte client s’il est connu et vaut jusqu’à minuit, plus la validité supplémentaire choisie.
- Même code pour tous : une règle panier par case, synchronisée automatiquement. Laissez le champ vide pour un code automatique (préfixe, année et numéro, par exemple
ADVENT26-07). - Montant minimum de commande et limitation au produit dévoilé en option.
Les boutons Case précédente et Case suivante enchaînent la saisie. Pressé ? Remplir les cases vides applique un plan prêt à l’emploi traduit dans toutes vos langues.
Gain instantané
Réglez la chance de gagner (de 1 à 100 %), le nombre de lots (0 pour illimité) et le message de défaite. Le tirage est fait sur le serveur à l’ouverture de la case, une seule fois par participant. Rouvrir la case redonne le même résultat. Quand tous les lots sont gagnés, les participants suivants voient le message de défaite.

Prévisualiser et lancer
Le tableau de bord réunit tout ce qu’il faut pour lancer le calendrier :
- Aperçu au : choisissez une date et ouvrez le calendrier tel qu’il sera ce jour-là. Les codes affichés sont des exemples et rien n’est enregistré. Les liens d’aperçu expirent au bout de 7 jours.
- Liste de lancement : calendrier actif, cases configurées, cron des rappels et e-mails de la boutique.
- Plus > M’envoyer les e-mails de test : les quatre e-mails (rappel, bienvenue, confirmation, lien d’accès) partent vers l’employé connecté, dans sa langue.

Ce que voit le client
La page du calendrier s’ouvre sur un compte à rebours jusqu’à la prochaine case, avec la case du jour mise en avant. Une fois inscrit, le participant voit son anneau de progression, sa série de jours d’affilée et l’interrupteur du rappel quotidien.

Les cases ont cinq états : aujourd’hui (halo animé), à rattraper, ouverte (contenu visible), à venir (cadenas et date) et manquée. Une étoile signale les cases de jeu.

À l’ouverture, une fenêtre présente la surprise : produit avec son prix, code sur un ticket, boutons Ajouter à mon panier et Copier. Si le panier est vide, le code est gardé 14 jours et appliqué au premier produit ajouté.

Le récapitulatif Vos codes liste les codes obtenus, avec leur validité et leur état (utilisé, expiré).

Sur mobile, la grille passe à 4 colonnes régulières et les panneaux s’empilent.

Jeu à gain instantané
Une case de jeu laisse le participant tenter sa chance. S’il gagne, il reçoit le code comme pour une case classique. Sinon, il voit le message de défaite et pourra jouer sur la prochaine case de jeu. Un visiteur non inscrit est invité à laisser son e-mail : une seule chance par participant.

Bannière d’accueil et bouton flottant
La bannière s’affiche sur la page d’accueil pendant le calendrier et, si vous le souhaitez, quelques jours avant le début. Le bouton flottant, à activer dans les réglages du calendrier, rappelle la case du jour sur toutes les pages. Le visiteur peut le masquer jusqu’au lendemain. Pour placer la bannière ailleurs, ajoutez {hook h='displayDfAdventCalendar'} dans un template de votre thème.

Compte à rebours hors Noël
Le même module anime n’importe quel temps fort : semaine du Black Friday, lancement d’une collection, soldes, anniversaire de la boutique. Choisissez un modèle « compte à rebours », un thème comme Noir et or, des tuiles épurées et une heure d’ouverture. Avant le début, la page affiche le compte à rebours jusqu’à la première case.

Rappels et e-mails
Chaque jour, à partir de l’heure choisie (jamais avant l’ouverture des cases), un e-mail court annonce la case du jour aux participants confirmés qui ne l’ont pas encore ouverte. Un participant reçoit au plus un rappel par jour, et aucun le jour de son inscription : l’e-mail de bienvenue suffit. Les e-mails reprennent les couleurs du thème du calendrier.

Quatre modèles sont fournis en huit langues dans mails/ : dfadvent_reminder (rappel), dfadvent_welcome (bienvenue), dfadvent_confirm (confirmation de l’adresse) et dfadvent_access (lien d’accès). Un participant qui ressaisit son adresse reçoit un lien d’accès : le module ne connecte jamais quelqu’un sur la seule saisie d’une adresse, et une même adresse ne reçoit pas plus d’un e-mail toutes les 2 minutes. Pour personnaliser les modèles, copiez-les dans themes/votre-theme/modules/dfadventcalendar/mails/.

Participants
La liste des participants se filtre en un clic : confirmés, en attente de confirmation, rappels actifs, newsletter, comptes clients, gagnants du tirage. Elle indique les cases ouvertes et les codes obtenus par chacun, et s’exporte en CSV.

Tirage au sort final
Dans les réglages du calendrier, fixez le nombre minimum de cases ouvertes pour participer (0 désactive le tirage) et décrivez le lot. Le tableau de bord indique le nombre d’éligibles. Le bouton Tirer un gagnant au sort choisit au hasard parmi les participants confirmés éligibles, en excluant les gagnants précédents. Chaque tirage est enregistré.
Un tirage au sort et un jeu à gain instantané relèvent de la réglementation des jeux concours. Publiez un règlement sur votre boutique avant le lancement.
Statistiques
Le tableau de bord affiche les participants (confirmés, avec un compte client), les cases ouvertes et la moyenne par participant, les codes dévoilés et la part de codes personnels utilisés, les commandes valides passées avec un code, le chiffre d’affaires HT de ces commandes et les rappels actifs. Le graphique d’activité montre, case par case, les ouvertures et les inscriptions du jour.
Si Google Tag Manager est présent, le module envoie ces événements dans le dataLayer : dfadv_join, dfadv_door_open, dfadv_code_copy, dfadv_code_apply et dfadv_share.
Le menu Plus > Dupliquer pour l’année suivante copie le calendrier et ses cases avec un an de décalage, inactif, sans participants ni codes.
Données personnelles
- La case de consentement est obligatoire, la case newsletter est séparée et non cochée.
- Chaque e-mail de rappel contient un lien de désinscription en un clic.
- L’adresse IP n’est conservée que hachée, pour limiter les inscriptions à 5 par heure et par connexion.
- Le module répond aux demandes d’export (codes compris) et de suppression des données personnelles de PrestaShop.
Dépannage
Les rappels ne partent pas
Vérifiez la liste de lancement du tableau de bord : cron exécuté dans les dernières 24 heures, e-mails de la boutique activés. Les rappels partent à partir de l’heure choisie, et seulement aux participants confirmés qui n’ont pas encore ouvert la case du jour.
La page du calendrier renvoie une erreur 404
Vérifiez que les URL simplifiées sont activées, puis videz le cache. Si l’adresse entre en conflit avec une autre page, changez-la dans les réglages du module.
Une case reste fermée alors que c’est le jour
Vérifiez l’heure d’ouverture du calendrier et le fuseau horaire de la boutique (International > Localisation). Une case non configurée ou inactive reste fermée.
Le code n’est pas ajouté au panier
Le message affiché est celui de PrestaShop : minimum de commande non atteint, code expiré ou code lié à un autre compte client. Si le panier est vide, le code reste en attente et s’applique au premier produit.
Compatibilité
- PrestaShop 1.7.8 à 9.x, le même ZIP pour toutes les versions.
- Thèmes Classic, Hummingbird et thèmes dérivés.
- Multiboutique (un calendrier par boutique) et multidevise (montants convertis dans la devise du visiteur).
- Architecture ModuleAdminController, sans dépendance Composer.
- Module traduit en anglais, français, espagnol, allemand, italien, néerlandais, polonais et portugais.