Barre d'annonce – manuel d’utilisation du module PrestaShop

1. À quoi sert le module

Le module ajoute au-dessus de l’en-tête de votre boutique une fine barre pour vos promotions et informations : « Livraison offerte ce week-end », « Commandes passées aujourd’hui expédiées lundi », « Black Friday −20 % — Voir l’offre ». Vous pouvez diffuser jusqu’à trois messages à la fois, chacun dans toutes les langues de la boutique, avec ses propres couleurs, un lien facultatif et ses propres dates de début et de fin. Quand plusieurs messages sont en cours, la barre les affiche l’un après l’autre. Le client peut fermer la barre : elle reste alors masquée pendant le nombre de jours que vous avez choisi.

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

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

Juste après l’installation, la barre n’est pas encore visible : les trois messages restent désactivés tant que vous n’avez pas rédigé et activé le premier.

3. Fonctionnement

La barre s’affiche dans le hook displayBanner, que le thème Classic (PrestaShop 1.7.8, 8 et 9) et le thème Hummingbird (PrestaShop 9) placent tout en haut de chaque page, au-dessus de l’en-tête. Classic n’affiche pas ce hook dans l’en-tête simplifié de la commande : sur la page de commande de Classic, la barre n’apparaît donc pas. Elle reprend les polices de votre thème ; ses couleurs viennent des réglages de chaque message.

À chaque affichage de page, la boutique vérifie quels messages sont activés et se trouvent dans leurs dates. Les dates suivent le fuseau horaire de la boutique, défini dans International → Localisation. Un message sans texte dans la langue du visiteur est ignoré pour cette langue. Si aucun message n’est en cours, la barre n’apparaît pas du tout.

Avec un seul message en cours, la barre l’affiche simplement. Avec deux ou trois, elle montre chacun pendant le nombre de secondes choisi, sans aucune animation. La rotation s’arrête tant que la souris ou le focus clavier se trouve sur la barre. De petites flèches permettent de passer d’un message à l’autre ; les visiteurs dont le système demande moins d’animations n’ont pas de rotation automatique et utilisent les flèches.

Quand un client ferme la barre, son navigateur s’en souvient (dans le stockage local, sans cookies) pendant le nombre de jours choisi. Ce souvenir porte sur les messages actuels : dès que vous modifiez un message, la barre réapparaît pour tout le monde.

Le module ne modifie pas les tables de PrestaShop, ne dépose aucun cookie et ne se connecte ni à addonspresta.com ni à aucun autre serveur.

4. Fonctions et réglages

Ouvrez Modules → Gestionnaire de modules → Barre d’annonce → Configurer. Le cadre Aide, en haut, mène à ce manuel et à la page du module sur addonspresta.com, dans la langue de votre back-office. En dessous, des avis vous signalent quand la barre est masquée, quand un message attend sa date de début ou a pris fin, et quand le texte se lit mal sur la couleur de fond.

Message 1, 2 et 3

• Afficher ce message — active ou désactive le message sans perdre son contenu.
• Texte — texte simple, 200 caractères au maximum, dans chaque langue. Il est obligatoire dans la langue par défaut quand le message est activé. Laissez-le vide dans une autre langue pour ne rien afficher dans celle-ci.
• URL du lien — facultative. Une adresse complète commençant par https:// ou une page de votre boutique commençant par /, par exemple /fr/content/1-livraison. Les autres types de liens sont refusés.
• Texte du lien — facultatif, par exemple « Voir l’offre ». S’il est rempli, le lien suit le texte. Sinon, c’est tout le message qui devient le lien.
• Couleur de fond et Couleur du texte — codes hexadécimaux comme #111111 et #ffffff (valeurs par défaut). Un avis vous prévient quand le contraste descend sous 4,5:1, le minimum pour une lecture confortable.
• Début et Fin — date et heure facultatives, dans le fuseau horaire de la boutique, par exemple 2026-11-27 08:00. Une date de fin sans heure correspond à la fin de cette journée. Laissez-les vides pour afficher le message tant qu’il est activé.

Comportement de la barre

• Changer de message toutes les — durée d’affichage de chaque message avant le suivant, de 2 à 60 secondes (5 par défaut).
• Le client peut fermer la barre — ajoute un bouton de fermeture.
• Masquée après fermeture pendant — nombre de jours pendant lesquels la barre reste masquée dans ce navigateur (7 par défaut). Avec 0, elle n’est masquée que jusqu’à la fermeture du navigateur.
• Afficher sur — toutes les pages, ou la page d’accueil uniquement.

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 diffuser les mêmes messages partout, ou une seule boutique pour lui donner ses propres messages, couleurs et dates. Un client qui ferme la barre dans une boutique la voit toujours dans les autres. Dans le contexte Toutes les boutiques ou groupe, seul un employé qui gère toutes ses boutiques peut enregistrer. Une licence couvre toutes les boutiques de l’installation.

6. Désinstallation

Gestionnaire de modules → Barre d’annonce → Désinstaller supprime la barre ainsi que tous ses réglages et messages. Pour les conserver, utilisez plutôt Désactiver.

7. Questions fréquentes et dépannage

La barre ne s’affiche pas. Lisez les avis en haut de la page de configuration : au moins un message doit être activé, avoir un texte dans la langue du visiteur et se trouver dans ses dates. Si vous avez choisi Page d’accueil uniquement, regardez la page d’accueil. Si vous avez vous-même fermé la barre, ouvrez la boutique dans une fenêtre de navigation privée. Videz ensuite le cache dans Paramètres avancés → Performances.

Un message apparaît trop tôt ou trop tard. Les dates suivent le fuseau horaire de la boutique dans International → Localisation → Configuration, et non l’horloge de votre ordinateur. Si votre boutique utilise un cache de pages complètes (Varnish ou un module de cache, par exemple), la barre ne change qu’au rafraîchissement de ce cache.

J’ai modifié le texte, mais un client qui avait fermé la barre ne la voit toujours pas. La barre réapparaît dès que la page affiche le nouveau texte. Si vous utilisez un cache de pages complètes, videz-le.

Dans mon thème, la barre n’est pas en haut de la page. La barre utilise le hook displayBanner. Certains thèmes ne l’affichent pas ou le placent ailleurs ; le développeur de votre thème peut alors ajouter {hook h='displayBanner'} au début du gabarit de l’en-tête.

Puis-je modifier l’apparence de la barre ? Oui. Copiez views/templates/hook/bar.tpl dans themes/<votre-thème>/modules/ap_announcementbar/views/templates/hook/ et modifiez la copie, puis videz le cache (Paramètres avancés > Performances > Vider le cache). Vous pouvez aussi ajouter à votre thème des styles pour les classes .ap-announcementbar.

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