Statistiques Live des ventes & vues de produits : installation et aide

1. Téléversez le ZIP de Product Sales & Views Live Stats via "Modules > Module Manager".
2. Ouvrez "Configure".
3. Gardez "Enable module" activé et choisissez les compteurs à afficher.
4. Laissez "Minimum count to display" à 0 pour votre premier test, puis enregistrez.
5. Consultez un produit dans un navigateur normal avec un identifiant visiteur PrestaShop. Rechargez et vérifiez le widget.
6. Testez la pastille de ventes sur un produit ayant une commande valide et ouvrez sa fenêtre d'achats récents.

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

Chaque statistique produit apparaît uniquement si elle est activée et supérieure à zéro. Un seuil de 0 n'affiche pas de pastilles à valeur nulle. Les pastilles de liste peuvent apparaître indépendamment du réglage "Show sales count" de la page produit.

Le hook displayHeader enregistre une vue uniquement sur les pages produit ayant un identifiant produit et un identifiant visiteur. Les contrôles des robots précèdent l'insertion. Le même visiteur, produit et magasin ne sont pas enregistrés à nouveau pendant 30 minutes.

La statistique de vues affichée compte les identifiants visiteurs distincts sur toute la période, même si un visiteur possède plusieurs enregistrements. La statistique de ventes compte les commandes distinctes avec valid = 1 sur cette période et dans cette boutique. Les commandes valides existantes peuvent contribuer immédiatement ; les vues antérieures à l'installation ne sont pas importées.

Les visiteurs en direct sont les visiteurs distincts enregistrés dans la fenêtre récente. Il ne s'agit pas d'un suivi continu de présence en ligne. Le navigateur n'envoie pas de signal périodique pour maintenir un visiteur en direct, et la suppression des doublons peut empêcher les nouvelles vues d'actualiser l'horodatage pendant 30 minutes.

Le filtrage des robots utilise une table partagée mpr_sessions compatible lorsqu'elle est disponible. Sinon, il compare le user-agent à des motifs courants de robots et d'automatisation.

Le formulaire marchand actuel expose les sept paramètres d'affichage ci-dessus. Les valeurs suivantes existent dans le stockage du module, sans commandes séparées dans ce formulaire. Ces noms sont des clés de stockage, pas un fichier de configuration importable.

Les vues et ventes affichées utilisent max(0, round(raw * multiplier) + flat). Gardez les multiplicateurs à 1.0 et les ajouts à 0 pour obtenir les compteurs bruts. Une intégration par un développeur peut définir une période de 24 heures, 30 jours ou 3 mois. Il n'existe ni compteur initial par produit, ni champ de motif textuel, ni paramètre d'exclusion de produits ou catégories.

La fenêtre charge les détails de commandes valides récentes du produit sélectionné : nom de l'acheteur masqué par défaut, ville, pays, temps relatif, nom du produit et quantité. Une ligne d'achat récent correspond à une ligne de détail de commande ; plusieurs déclinaisons dans une commande peuvent produire plusieurs lignes. Cette unité diffère du total de ventes en commandes distinctes.

Le widget produit utilise displayProductAdditionalInfo. L'affichage en liste utilise displayProductListReviews ; les ressources sont préparées pour les pages catégorie, recherche, fabricant, fournisseur, nouveautés, meilleures ventes et promotions lorsque l'affichage en liste est actif.

Pour un thème personnalisé omettant ces hooks, ajoutez une seule fois l'appel approprié :

{hook h='displayProductAdditionalInfo' product=$product}
{hook h='displayProductListReviews' product=$product}

Le contrôleur AJAX prend en charge action=getRecentOrders et action=getStats, chacun avec id_product. Générez l'URL du module avec les outils de liens PrestaShop dans vos intégrations personnalisées. Le script fourni charge la fenêtre d'achats ; l'existence d'un endpoint de statistiques ne signifie pas que le widget s'actualise en continu.

• Utilisez un navigateur normal pour les tests de vues. Les outils automatisés peuvent être filtrés comme robots. Vérifiez que le navigateur possède un identifiant visiteur PrestaShop.
• Consultez deux fois le même produit en 30 minutes. Cela ne doit pas ajouter une seconde vue enregistrée. Utilisez une autre session visiteur pour tester le comptage des visiteurs distincts.
• Comparez les ventes aux commandes valides créées durant l'intervalle, plutôt qu'aux unités totales commandées ou à tous les états de commande.
• Si aucune pastille n'apparaît, vérifiez les réglages activés, les compteurs nuls, le seuil et les hooks du thème.
• Si la fenêtre échoue, inspectez sa réponse AJAX, les erreurs JavaScript et la connexion à la base de données. Gardez à l'esprit que l'anonymisation masque uniquement les noms.

Utilisez .mprpsvls-widget, .mprpsvls-bar et .mprpsvls-listing-badge dans la feuille de style du thème. Theme Detector fournit notamment les variables --mprpsvls-primary, --mprpsvls-bg et --mprpsvls-border.

.mprpsvls-widget { margin: 12px 0 18px; }
.mprpsvls-bar { --mprpsvls-primary: #1f7a4d; }
.mprpsvls-listing-badge { font-size: 0.75rem; }

Désactivez "Enable module" pour arrêter l'affichage et le suivi normaux. La désinstallation supprime la configuration du module, son menu, son inscription à Theme Detector et la table de suivi des vues. Sauvegardez cette table si vous avez besoin de son historique. Les commandes PrestaShop existantes restent intactes.