Badges produit personnalisés : installation et aide

Suivez les étapes du Démarrage rapide.

Ouvrez Modules > "Module Manager" > Custom Product Badges > "Configure". Dans Paramètres des badges produit, Activer vaut Oui par défaut au niveau global. Choisissez Non pour masquer les badges dans le contexte sélectionné. Dans un contexte de groupe ou de boutique, Hériter supprime cette surcharge. Les boutiques héritent de leur groupe, puis des paramètres globaux. Cliquez sur Enregistrer.

Ouvrez la page Badges produits du module pour gérer les libellés, règles et attributions. Sélectionnez d’abord une seule boutique. L’éditeur refuse un contexte toutes boutiques ou groupe. Vous devez disposer de l’accès en lecture et de l’autorisation d’ajout, de modification ou de suppression correspondante. Votre employé doit avoir accès à la boutique sélectionnée.

Utilisez Nouveau badge pour commencer une définition.

Cliquez sur Enregistrer. Par exemple, créez Dernière chance, avec du texte blanc, un fond #111111 et l’emplacement En haut à droite. Le tableau Badges produits affiche Nom du badge, Actif, Position et Actions. Utilisez Modifier ou Supprimer dans ce tableau.

L’écran actuel des paramètres n’a pas de champ "Default badge presets (JSON)". Créez les définitions dans cet éditeur.

1. Dans Attributions groupées, sélectionnez Nom du badge.
2. Sélectionnez un ou plusieurs Produits avec le sélecteur de produits. Une sélection vide ne signifie pas tous les produits.
3. Choisissez Opération = Attribuer le badge ou Retirer l’attribution manuelle.
4. Cliquez sur Prévisualiser les attributions.
5. Vérifiez les ID produit et "Assignments to change" dans Aperçu de l’attribution.
6. Cliquez sur Confirmer les attributions pour appliquer la sélection.

L’aperçu est lié à votre employé et à votre boutique et expire après 15 minutes. Si les attributions ou les données du catalogue changent avant la confirmation, générez un nouvel aperçu. Retirer une attribution manuelle ne retire pas un badge encore fourni par une règle de catégorie.

Dans Règle de catégorie, choisissez un Nom du badge enregistré et sélectionnez Catégories. Inclure les sous-catégories vaut Non par défaut. Réglez-le sur Oui pour inclure les produits des catégories descendantes. Priorité vaut 0 par défaut. Les valeurs les plus basses apparaissent en premier. Actif vaut Oui par défaut.

Cliquez sur Enregistrer la règle. Utilisez Modifier, Supprimer ou Nouvelle règle pour gérer les règles. La correspondance des catégories utilise l’appartenance du produit aux catégories, y compris les descendantes si l’option est sélectionnée. Elle n’applique pas de conditions automatiques de nouveauté, remise, stock ou fabricant.

Les correspondances manuelles et par règle fusionnent par ID de badge. Le même badge n’apparaît qu’une fois. Les résultats sont triés par priorité, position, puis ID de badge. Un badge uniquement manuel a une priorité de repli élevée, ce qui permet à la priorité des règles de catégorie de placer les badges de règle en premier. Aucun champ de date de début ou de fin n’est présent.

Le module affiche des badges textuels. Il ne modifie pas les fichiers image et n’accepte pas de badges image téléversés. Son JavaScript place les groupes de badges dans les coins choisis des éléments pris en charge de la galerie produit et des miniatures de listes. L’emplacement dépend des sélecteurs et du balisage de votre thème.

Le module prend en charge displayProductAdditionalInfo, displayProductListReviews, displayLeftColumnProduct, displayRightColumnProduct et displayFooterProduct. Les hooks d’en-tête et de médias chargent les ressources et la configuration du point de terminaison des fragments. Le navigateur recherche aussi les fragments de badges manquants et réagit aux actualisations des listes de produits, des produits et aux aperçus rapides.

Utilisez .mprbadges-wrap, .mprbadges-tag et .mprbadges-corner dans le CSS de votre thème. Par exemple :

.mprbadges-wrap { gap: 6px; }
.mprbadges-tag { border-radius: 2px; font-size: 10px; line-height: 1.3; }

Le chemin de surcharge du modèle du thème est :

themes/your-theme/modules/mprproductbadges/views/templates/hook/badges.tpl

Partez du modèle actuel. Il reçoit mprbadges_groups, regroupé par coin, et mprbadges_product. Conservez data-mpr-badges, les classes de coin et les ID de badges nécessaires au code de montage du navigateur. L’ancienne boucle mprbadges_items ne correspond pas à cette version.

1. Créez un badge actif dans une seule boutique et attribuez-le à un produit connu via l’aperçu et la confirmation.
2. Ouvrez la page produit et une liste contenant ce produit. Vérifiez le texte, la traduction, les couleurs et le coin.
3. Actualisez la liste ou ouvrez un aperçu rapide et vérifiez que le badge reste associé au bon produit.
4. Ajoutez une règle de catégorie. Testez un membre direct de la catégorie et un membre d’une catégorie descendante avec les deux réglages d’inclusion des descendants.
5. Désactivez le badge individuel et vérifiez qu’il disparaît.

Si l’éditeur demande une seule boutique, modifiez le sélecteur multiboutique. Si l’enregistrement échoue, vérifiez les autorisations de l’employé et rouvrez la page pour actualiser le jeton. Recréez les aperçus expirés ou modifiés.

Si l’affichage dans la boutique manque, vérifiez Activer hérité, Actif du badge, l’attribution ou la règle active, l’appartenance à la boutique et le repli linguistique. Inspectez les ressources d’en-tête et le point de terminaison badges du module dans le panneau réseau du navigateur. Un thème personnalisé peut nécessiter une intégration des sélecteurs ou du modèle. Utilisez la page d’intégrité de l’installation pour les tables et hooks manquants.

Utilisez Activer = Non pour masquer les badges sans supprimer les définitions. Utilisez Actif = Non pour masquer un seul badge. Supprimer un badge retire ses attributions et règles de catégorie de la boutique courante ainsi que ses traductions de boutique.

Désinstallez depuis "Module Manager" pour supprimer la configuration du module, le menu et les tables de badges gérées par le schéma. Sauvegardez d’abord vos définitions, traductions, règles de catégorie et attributions si vous devez les conserver.

Nécessite PrestaShop 1.6 ou ultérieur et PHP 7.1 ou ultérieur.