Popularité Panier — Documentation
Installer et configurer le module de comptage de paniers sur la fiche produit.
Le module Popularité Panier affiche sur la fiche produit un badge de preuve sociale indiquant le nombre de paniers contenant le produit, par exemple « Dans + de 20 paniers ». Ce guide couvre l’installation, la configuration de chaque réglage, le fonctionnement du comptage et le dépannage.
Installation
Le module s’installe comme tout module PrestaShop, sans dépendance externe.
- Depuis le back-office, ouvrez Modules > Module Manager.
- Cliquez sur Téléverser un module et sélectionnez le fichier
dfcartpopularity.zip. - Une fois l’installation terminée, cliquez sur Configurer.
Compatible PrestaShop 8.0 à 9.x. Aucune dépendance Composer ni bibliothèque JavaScript externe n’est requise.
Configuration
La page de configuration regroupe tous les réglages d’affichage et de comptage.
Texte affiché
Le message présenté dans le badge, traduisible par langue. Utilisez le marqueur {count} pour insérer dynamiquement le nombre. Exemple : Dans + de {count} paniers. Les traductions française, anglaise, espagnole, allemande et italienne sont fournies par défaut.
Seuil d’affichage
Nombre minimum de paniers à partir duquel le badge apparaît. En dessous de ce seuil, rien ne s’affiche, ce qui évite de montrer un chiffre peu valorisant. Valeur par défaut : 20.
Mode d’affichage du nombre
- Palier arrondi : le compteur est arrondi vers le bas selon un palier (ex. 23 paniers affiche « + de 20 »). Idéal pour un effet crédible qui évolue par tranches.
- Nombre exact : le chiffre réel est affiché, pour les boutiques qui préfèrent la transparence totale.
Palier d’arrondi
Utilisé uniquement en mode palier. Détermine la tranche d’arrondi : un palier de 10 transforme 23 en « + de 20 », 37 en « + de 30 ».
Fenêtre temporelle (heures)
Ne compte que les paniers mis à jour dans cette fenêtre. Par exemple, 168 = 7 jours. Réglez sur 0 pour ne poser aucune limite de temps.
Paniers actifs uniquement
Lorsque cette option est activée, les paniers déjà transformés en commande sont exclus du comptage. Vous ne reflétez ainsi que la demande active.
Emplacement
Choisissez où le badge s’affiche sur la fiche : sous le bloc d’ajout au panier (infos additionnelles) ou près des boutons d’achat.
Durée du cache (secondes)
Durée de conservation du comptage avant recalcul. Par défaut 600 secondes (10 minutes). Réglez sur 0 pour recalculer à chaque affichage, ce qui est déconseillé en production.
À chaque enregistrement des réglages, le cache de comptage est vidé automatiquement afin d’appliquer immédiatement vos nouveaux paramètres.
Comment fonctionne le comptage
Le module compte les paniers réels contenant le produit. Le comptage est dédoublonné par panier — un même panier n’est jamais compté deux fois — et limité à la boutique courante en contexte multiboutique. La fenêtre temporelle et l’option « paniers actifs uniquement » affinent ce comptage pour qu’il reflète la demande pertinente.
Performance et cache
Pour éviter une requête de comptage à chaque vue produit, le résultat est stocké dans une table de cache dédiée avec une durée de vie paramétrable. Le comptage n’est recalculé qu’à l’expiration du cache, ce qui préserve les performances même sur les boutiques à fort trafic.
Multiboutique et multilingue
En multiboutique, le comptage est scopé sur la boutique consultée. Côté langues, le texte du badge est entièrement traduisible : il se règle indépendamment pour chaque langue active de la boutique, avec le marqueur {count} pour le nombre.
Intégration dans le thème
Le badge est rendu côté serveur via un gabarit du module. Si vous souhaitez le repositionner précisément dans votre thème, la variable Smarty {$dfcp_message} contient le message prêt à l’emploi et peut être insérée dans un override de fiche produit.
Dépannage
Le badge ne s’affiche pas
Vérifiez que le nombre réel de paniers contenant le produit atteint le seuil défini. Si le seuil est à 20 mais que le produit n’est que dans 5 paniers, aucun badge n’apparaît, c’est le comportement attendu. Réduisez temporairement le seuil pour tester l’affichage.
Le nombre ne se met pas à jour immédiatement
C’est l’effet du cache. Attendez l’expiration de la durée configurée, ou enregistrez les réglages pour forcer un vidage immédiat du cache.
Le compteur semble trop bas
Si l’option « paniers actifs uniquement » est activée et la fenêtre temporelle courte, seuls les paniers récents et non commandés sont comptés. Élargissez la fenêtre temporelle ou désactivez l’option pour un comptage plus inclusif.