1. À quoi sert le module
Le module ajoute vos propres étiquettes sur les produits — « Meilleure vente », « Derniers articles », « Livraison offerte », « Fabriqué en France » — juste à côté des étiquettes « Nouveau » et « Promo » de votre thème. Chaque étiquette a son texte dans chaque langue et ses propres couleurs, et une règle décide quels produits la reçoivent : tous les produits, des catégories, des marques, une fourchette de prix, un stock faible ou une liste d’ID produits. Une étiquette peut commencer et s’arrêter à des dates précises, et c’est vous qui fixez leur ordre.
Les étiquettes apparaissent partout où votre thème affiche les siennes : listes de produits, résultats de recherche, fiche produit et aperçu rapide.
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_productlabels_v1.0.1.zipet attendez la confirmation. - Cliquez sur Configurer sur la fiche du module.
3. Fonctionnement
PrestaShop prépare pour chaque produit une liste de pastilles que le thème affiche sur l’image : « Nouveau », « Promo ! », la réduction, « Pack », etc. Le module ajoute vos étiquettes à la fin de cette liste, dans l’ordre de votre liste d’étiquettes. Le thème les affiche exactement comme les siennes — même emplacement, même police, même forme — et le module se contente d’appliquer les couleurs choisies. Si vous laissez les couleurs vides, l’étiquette ressemble aux autres étiquettes du thème.
Un produit reçoit chaque étiquette active dont il respecte la règle et dont les dates incluent l’instant présent :
- Tous les produits — chaque produit.
- Produits de catégories — les produits associés à au moins une des catégories cochées. Toutes les catégories cochées sur la fiche du produit comptent, pas seulement la catégorie principale.
- Produits de marques — les produits des marques cochées.
- Produits dans une fourchette de prix — le prix affiché aux clients, TTC et remises comprises, comparé dans la devise par défaut de la boutique et arrondi comme le prix affiché (au centime). Les clients qui paient dans une autre devise voient les mêmes produits étiquetés.
- Produits en stock faible — les produits dont il reste de 1 au nombre indiqué en stock. Les produits en rupture ne reçoivent pas l’étiquette. Cette règle demande la gestion des stocks dans Paramètres de la boutique → Produits ; si elle est désactivée, l’étiquette ne s’affiche sur aucun produit. Dans les listes de produits, c’est le stock de la déclinaison affichée (celle par défaut) qui compte ; sur la fiche produit, celui de la déclinaison choisie.
- Produits choisis — les ID produits que vous indiquez.
Les dates suivent l’heure de votre boutique (le fuseau horaire défini dans International → Localisation). Certains modules, comme les produits phares ou les meilleures ventes de la page d’accueil, gardent leurs blocs de produits dans le cache de PrestaShop. Le module vide ce cache chaque fois que vous enregistrez, activez, désactivez, déplacez ou supprimez une étiquette, à l’instant où une étiquette commence ou se termine, et quand vous activez, désactivez ou désinstallez le module : ces blocs affichent donc eux aussi le changement. Le module ne modifie pas les tables de PrestaShop et ne se connecte ni à addonspresta.com ni à aucun autre serveur.
Prérequis. Le module fonctionne avec tout thème qui affiche les pastilles produits de PrestaShop, comme Classic et Hummingbird. Un thème qui n’affiche pas les étiquettes « Nouveau » et « Promo » n’affichera pas non plus ces étiquettes.
4. Fonctions et réglages
Ouvrez Modules → Gestionnaire de modules → Étiquettes et badges produits → Configurer. Le cadre Aide en haut de la page renvoie vers ce manuel et vers la page du module sur addonspresta.com, dans la langue de votre back-office.
Liste des étiquettes
Chaque ligne montre l’étiquette dans ses couleurs, sa règle, ses dates et son état. Cliquez sur l’état pour activer ou désactiver une étiquette. Les flèches de la colonne Position la font monter ou descendre : les étiquettes s’affichent sur les produits dans cet ordre. Modifier ouvre l’étiquette, Supprimer l’efface après confirmation. Ajouter une étiquette ouvre un formulaire vide.
Texte
Jusqu’à 32 caractères dans chaque langue. Remplissez au moins la langue par défaut : les langues laissées vides
reprennent le même texte. Les caractères < et > ne sont pas acceptés.
Couleur de fond et couleur du texte
Couleurs hexadécimales comme #e4002b et #ffffff. Laissez un champ vide pour garder la couleur des étiquettes de
votre thème.
Afficher sur
La règle de l’étiquette. Les champs de la règle choisie apparaissent en dessous :
- Catégories — cochez les catégories dans l’arborescence.
- Marques — cochez les marques. Les marques s’ajoutent dans Catalogue → Marques et fournisseurs.
- Prix à partir de / Prix jusqu’à — dans la devise par défaut, TTC. Remplissez un champ ou les deux ; un champ vide signifie aucune limite de ce côté.
- Articles restants au maximum — par exemple 3 affiche « Derniers articles » tant qu’il reste 1, 2 ou 3 articles.
- ID produits — les ID de Catalogue → Produits, séparés par des virgules :
12, 15, 18.
Afficher à partir du / Afficher jusqu’au
Date et heure de début et de fin, facultatives. Une étiquette Black Friday peut commencer le vendredi à minuit et s’arrêter le lundi soir. Les heures se règlent à la minute près. La liste indique « Terminée le … » pour les étiquettes dont la date de fin est passée.
Active
Désactive l’étiquette sans la supprimer.
Masquer les étiquettes Nouveau, Promo et réduction du thème
Dans Options, sous la liste. Une fois activée, les produits n’affichent que vos étiquettes, plus les étiquettes Pack, Exclusivité web et Rupture de stock du thème. Désactivée par défaut.
5. Multiboutique
Chaque étiquette a un champ Boutiques : cochez les boutiques qui doivent l’afficher. La liste montre les étiquettes de la boutique ou du groupe de boutiques choisi dans l’en-tête du back-office ; choisissez Toutes les boutiques pour les voir toutes. L’ordre des étiquettes est le même dans toutes les boutiques : une flèche place l’étiquette à côté de sa voisine dans la boutique choisie, et les autres étiquettes gardent leur ordre partout. L’option qui masque les étiquettes du thème est enregistrée pour la boutique ou le groupe choisi, chaque boutique peut donc avoir son propre réglage. 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.
Un employé limité à certaines boutiques ne voit que les étiquettes de ses boutiques et ne peut cocher que celles-ci. Il ne peut ni modifier ni supprimer une étiquette utilisée aussi par une boutique hors de son accès : le changement toucherait aussi cette boutique, seul un employé ayant accès à toutes ses boutiques peut donc le faire.
6. Désinstallation
Gestionnaire de modules → Étiquettes et badges produits → Désinstaller supprime toutes vos étiquettes et les réglages du module. Pour garder les étiquettes, choisissez plutôt Désactiver.
7. Questions fréquentes et dépannage
Une étiquette ne s’affiche pas. Vérifiez que l’étiquette est active, que ses dates incluent l’heure actuelle de la boutique et que le produit respecte la règle. Pour la règle de stock faible, la gestion des stocks doit être activée. Videz ensuite le cache dans Paramètres avancés → Performances.
L’étiquette s’affiche, mais sans mes couleurs.
Vérifiez que les couleurs sont au format hexadécimal, par exemple #e4002b. Un thème aux styles d’étiquettes très
spécifiques peut demander d’ajouter les couleurs dans sa propre feuille de style : utilisez la classe
ap-productlabels- suivie de l’ID de l’étiquette.
Mon thème n’affiche pas du tout l’étiquette.
Le thème n’affiche pas les pastilles produits de PrestaShop. Demandez à son auteur d’ajouter le fichier standard
catalog/_partials/product-flags.tpl aux miniatures produits et à la fiche produit.
Puis-je modifier l’apparence des étiquettes ?
Oui. Chaque étiquette a sa propre classe ap-productlabels-<ID> ; ajoutez-lui du CSS dans votre thème, par
exemple des coins arrondis.
La règle de prix étiquette un produit dont le prix n’est pas celui attendu. La règle utilise le prix TTC, remises comprises, converti dans la devise par défaut, même si votre boutique affiche les prix HT. Les taxes sont celles du client : PrestaShop prend le pays de l’adresse de livraison et, tant que le client n’a pas d’adresse, le pays par défaut ou celui qu’il déduit de la langue du navigateur (International → Localisation). Un visiteur d’un pays sans taxe est donc comparé au prix hors taxe, celui qu’il voit.
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 étiquettes et 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.