Calendrier de l’Avent – manuel d’utilisation du module PrestaShop

Page du module : Calendrier de l’Avent PDF · 187 KB

1. Ce que fait ce module

Le module ajoute à votre boutique une page calendrier avec des cases numérotées, une par jour de votre opération. Derrière chaque case, vous placez une offre qui existe déjà dans la boutique : un code promo, un produit avec sa remise, ou votre propre message avec un lien. Une case s’ouvre le jour venu ; les cases à venir restent scellées ; les cases passées restent ouvertes ou expirent, selon votre choix. Un compte à rebours indique aux clients quand la prochaine case s’ouvre, et une bannière sur la page d’accueil les conduit au calendrier pendant l’opération et quelques jours avant.

Les offres sont vos propres règles panier et produits, donc le calendrier dit toujours vrai : désactivez une règle panier et la case annonce que l’offre n’est pas disponible ; changez un prix et la case produit suit. Le module ne crée ni codes promo ni prix et ne touche pas au panier.

Un calendrier de l’Avent classique va du 1er au 24 décembre, mais le premier jour et le nombre de jours vous appartiennent : douze jours avant Noël, une semaine de bonnes affaires en janvier, un compte à rebours d’anniversaire.

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 en 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_adventcalendar_v1.0.0.zip et attendez la confirmation.
Cliquez sur Configurer sur la fiche du module.

Dès l’installation, la page du calendrier est en ligne à l’adresse /advent-calendar dans chaque langue de la boutique (par exemple votreboutique.fr/fr/advent-calendar), avec 24 cases à partir du 1er décembre et sans offres.

3. Fonctionnement

Préparez les offres dans PrestaShop. Pour un code promo, ouvrez Catalogue → Réductions → Règles panier, cliquez sur Ajouter une nouvelle règle panier, saisissez un nom, un code que les clients taperont dans le panier (par exemple JOUR5), les dates de validité, les conditions et l’action (un pourcentage, un montant, la livraison offerte ou un cadeau), puis enregistrez. Pour une promotion sur un produit, définissez un prix spécifique dans Catalogue → Produits, onglet Prix du produit, avec les dates de la promotion. Seules les règles panier avec un code peuvent se trouver derrière une case : une règle sans code n’est pas utilisable par un client.

Ajoutez les cases. Sur la page de configuration du module, cliquez sur le bouton + de la liste des cases, choisissez le jour et le type d’offre, sélectionnez la règle panier ou saisissez l’ID du produit, ajoutez un titre et un texte si vous le souhaitez, puis enregistrez. Une case par jour ; les jours sans case affichent « Pas d’offre aujourd’hui ».

Ce que voient les clients. La case n s’ouvre à minuit le jour (premier jour + n − 1), heure de la boutique (International → Localisation), et porte la mention Aujourd’hui jusqu’à la fin de ce jour, son offre dépliée sur la page. Les cases précédentes s’ouvrent d’un clic (ou annoncent que l’offre est terminée quand les jours passés ne restent pas ouverts). Les cases à venir montrent un cadenas et leur date d’ouverture ; leur contenu n’est même pas envoyé au navigateur, personne ne peut tricher. Un compte à rebours indique quand la prochaine case s’ouvre ; arrivé à zéro, la page se rafraîchit d’elle-même en quelques secondes.

Une case code promo affiche le nom de la règle panier, ce qu’elle offre (par exemple « −10 % · Livraison offerte »), le code avec un bouton Copier le code, la date de fin de la règle, votre texte et un bouton facultatif avec un lien. Tant que la règle est désactivée, pas encore valable, expirée ou épuisée, la case indique que l’offre n’est pas disponible au lieu de montrer un code mort.
Une case produit affiche la fiche produit de votre thème — image, nom, prix avec l’ancien prix barré, bouton d’ajout au panier si le thème en a un — avec votre titre au-dessus et votre texte en dessous.
Une case texte affiche votre titre, votre texte et un bouton facultatif avec un lien, par exemple vers une catégorie ou un article de blog.

Avant et après. Avant le premier jour, la page montre le nom du calendrier, votre texte et un compte à rebours jusqu’à la première case, toutes les cases étant fermées. Après le dernier jour, la page affiche votre texte de clôture ; les cases restent comme au dernier jour. La page garde son adresse toute l’année, si bien que les liens et le référencement passent au calendrier suivant : l’année prochaine, changez le premier jour et mettez à jour les cases.

Bannière d’accueil. D’un nombre de jours choisi avant le premier jour jusqu’à la fin du dernier, une bannière sur la page d’accueil affiche le nom du calendrier, votre texte, le titre de l’offre du jour, le compte à rebours et un bouton vers la page.

Le module ne contacte ni addonspresta.com ni aucun autre serveur et ne dépose aucun cookie.

4. Fonctionnalités et réglages

Ouvrez Modules → Gestionnaire de modules → Calendrier de l’Avent → Configurer. L’encadré Aide en haut renvoie à ce manuel et à la page du module sur addonspresta.com, dans la langue de votre back-office.

État

L’encadré au-dessus des réglages indique où en est le calendrier (avant le premier jour, le jour en cours avec le temps restant avant la prochaine case, ou terminé), combien de cases ont une offre et quelle est l’offre du jour. Il vous avertit des jours sans case, des offres que les clients ne peuvent pas utiliser pour le moment (règle panier désactivée, expirée ou épuisée, produit désactivé ou manquant), des règles panier désactivées dans la boutique et d’un calendrier terminé. Voir la page du calendrier l’ouvre dans un nouvel onglet et Règles panier mène à vos codes promo.

Calendrier

Nom du calendrier — le titre de la page et de la bannière, par exemple « Calendrier de l’Avent ». Obligatoire dans la langue par défaut.
Premier jour — le jour de la case 1, par exemple 2026-12-01. Les cases s’ouvrent à minuit, heure de la boutique.
Nombre de jours — de 1 à 31 ; 24 pour un calendrier de l’Avent classique.
Les jours passés restent ouverts — oui : les clients peuvent ouvrir toutes les cases jusqu’à aujourd’hui ; non : seule la case du jour a une offre, les précédentes indiquent que l’offre est terminée. La validité d’un code promo reste décidée par sa règle panier.
Texte au-dessus des cases — affiché avant et pendant le calendrier, par exemple « Une nouvelle case s’ouvre chaque jour. Revenez demain pour la prochaine offre ! »
Texte après le dernier jour — remplace le texte au-dessus des cases une fois le calendrier terminé.

Les balises HTML sont retirées de tous les textes ; les retours à la ligne sont conservés.

Page du calendrier

Adresse de la page — la fin de l’adresse dans chaque langue, par exemple calendrier-avent : minuscules, chiffres et tirets, en commençant par une lettre. Une adresse déjà utilisée par une autre page de la boutique est refusée. La même page se retrouve dans Paramètres de la boutique → Trafic et SEO.
Titre de la page (meta title) et Méta-description — ce qu’affichent l’onglet du navigateur et les résultats de recherche.

Promotion dans la boutique

Bannière sur la page d’accueil — le nom du calendrier, votre texte, l’offre du jour, le compte à rebours et un bouton vers la page. À l’installation, la bannière est placée en premier sur la page d’accueil ; vous pouvez la déplacer dans Apparence → Positions (hook displayHome).
Afficher la bannière avant le premier jour — combien de jours avant le premier jour la bannière apparaît, par exemple 7. 0 ne l’affiche qu’à partir du premier jour. Elle disparaît après le dernier jour.
Texte de la bannière d’accueil — par exemple « Une nouvelle offre chaque jour jusqu’à Noël. Ouvrez la case du jour ! »
Libellé du bouton — par exemple « Ouvrir le calendrier ». Obligatoire dans la langue par défaut.
Couleur des cases et Couleur du texte des cases — des couleurs hexadécimales comme #1f3a2e et #ffffff. La page vous avertit quand les deux couleurs sont peu lisibles ensemble.
Couleur d’accent — la couleur du badge de la case du jour, du compte à rebours, de l’encadré du code et des boutons, par exemple #c8102e. Laissez vide pour garder les couleurs de votre thème. Le texte des boutons est noir ou blanc, selon ce qui se lit le mieux.

Cases

La liste en bas montre chaque case avec son jour et sa date, son type, son offre (la règle panier et son code, le produit et son ID, ou le titre), sa boutique en multiboutique et son état. Cliquez sur le bouton + pour ajouter une case, Modifier pour la changer, l’icône d’état pour la désactiver ou l’activer, Supprimer pour la retirer.

Dans le formulaire d’une case :

Jour — un jour du calendrier avec sa date ; une case par jour.
Type d’offre — Code promo, Produit ou Votre propre texte et lien. Les champs suivants dépendent du type.
Règle panier — l’une de vos règles panier avec un code, non réservées à un seul client et utilisables dans la boutique de la case, les plus récentes en premier (les règles désactivées sont signalées). La case affiche le nom de la règle, ce qu’elle offre, son code et sa date de fin.
ID du produit — l’ID de Catalogue → Produits. La case affiche la fiche produit avec son prix actuel.
Titre — facultatif ; vide = le nom de la règle panier, le nom du produit ou « Jour N ».
Texte — facultatif, quelques lignes, par exemple les conditions d’un code promo (« Commande minimum 50 € »).
Lien et Libellé du bouton — un bouton facultatif sous l’offre (cases code promo et texte) : une adresse complète (https://…) ou un chemin de votre boutique (/fr/12-categorie) ; le libellé par défaut est « Acheter ».
Activée — une case désactivée compte comme un jour sans offre.

5. Multiboutique

Les réglages sont enregistrés pour la boutique sélectionnée dans l’en-tête du back-office. Les cases ajoutées avec Toutes les boutiques sélectionné appartiennent à chaque boutique ; les cases ajoutées avec une seule boutique sélectionnée lui appartiennent et l’emportent sur la case pour toutes les boutiques le même jour. Les règles panier et les produits sont ceux de la boutique. Une licence couvre toutes les boutiques de l’installation.

6. Désinstallation

Gestionnaire de modules → Calendrier de l’Avent → Désinstaller supprime les réglages du module, ses cases et la page du calendrier. Vos règles panier et vos produits ne sont pas touchés. Pour garder les cases pour l’année prochaine, utilisez Désactiver.

7. FAQ et dépannage

Une case affiche « Cette offre n’est pas disponible ». Sa règle panier est désactivée, hors de ses dates ou épuisée, ou son produit est désactivé ou invisible dans la boutique. L’encadré État liste ces jours. Vérifiez la règle dans Catalogue → Réductions → Règles panier (état, dates, quantité) ou le produit dans Catalogue → Produits.

Le code ne fonctionne pas dans le panier. Vérifiez les conditions de la règle panier (montant minimum, groupe de clients, produits, transporteurs, utilisations par client) et que les règles panier sont activées dans votre boutique (l’encadré État vous avertit sinon). Le module affiche seulement le code ; c’est PrestaShop qui l’applique.

Une case s’ouvre au mauvais moment. Les cases s’ouvrent à minuit dans le fuseau horaire de la boutique défini dans International → Localisation. Vérifiez le fuseau horaire et le premier jour.

Je veux que l’offre du jour reste une surprise jusqu’au clic. La case du jour est dépliée sur la page pour que l’offre soit visible tout de suite, aussi pour les moteurs de recherche. Si vous préférez une case fermée, surchargez le gabarit views/templates/front/calendar.tpl depuis votre thème (voir ci-dessous).

Puis-je afficher un calendrier différent dans chaque boutique ? Oui : sélectionnez la boutique dans l’en-tête du back-office avant d’enregistrer les réglages et d’ajouter les cases.

Puis-je ajouter la page au menu principal ? Oui : dans Modules → Gestionnaire de modules → Menu principal → Configurer, ajoutez un lien personnalisé avec l’adresse de la page du calendrier (Voir la page du calendrier dans l’encadré État).

Puis-je changer l’apparence des cases ? Oui. Utilisez les réglages de couleurs, ajoutez du CSS pour les classes .ap-adventcalendar dans votre thème, ou copiez les gabarits de views/templates/ du module vers themes/<votre-theme>/modules/ap_adventcalendar/views/templates/ et modifiez les copies.

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 et vos cases sont conservés.

L’assistance est incluse pendant 12 mois à partir de votre commande : écrivez à mail@addonspresta.com ou utilisez le formulaire de contact sur addonspresta.com (du lundi au vendredi, 10 h–16 h CET ; nous répondons 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