Guides d’achat PrestaShop 8 & 9 : documentation

Présentation

Le module crée des pages de guide d’achat à partir de votre catalogue. Chaque guide répond à une question de client, par exemple « Quel robot aspirateur choisir pour un appartement avec animaux ? ». Vous choisissez les produits comparés et les critères, le module calcule un score sur 100 pour chaque produit, désigne trois sélections et génère le classement, le tableau comparatif, les statistiques et la FAQ. Le classement est recalculé quand le catalogue change.

Installation

1. Dans Modules > Gestionnaire de modules, cliquez sur Installer un module et sélectionnez dfbuyingguide-1.1.0.zip.
2. L’installation crée l’onglet Catalogue > Guides d’achat, les tables du module et le dossier img/dfbuyingguide/ des images de couverture.
3. Le bouton Configurer du module ouvre directement cet onglet.

Depuis la version 1.0.0, déposez simplement le ZIP 1.1.0 : le script de mise à jour ajoute les colonnes et les tables de statistiques sans toucher à vos guides.

Réglages généraux

Le panneau Réglages, sous la liste des guides, contient :

• Préfixe d’URL : guides par défaut. Les guides sont servis à /guides/url-du-guide et l’index de tous les guides à /guides.
• Âge maximum d’un classement : 12 heures par défaut. Passé ce délai, un classement est recalculé à la visite suivante même sans modification du catalogue, ce qui suit les promotions programmées.
• Produits analysés par guide : 300 par défaut. Les produits les plus vendus du périmètre sont analysés en premier. Augmentez la valeur pour les grandes catégories, jusqu’à 5 000.
• Afficher le badge du guide sur les fiches produits : les produits qui détiennent une sélection ou une place dans le top 3 affichent un lien vers le guide.
• Afficher les guides sur les pages catégories : un bloc en bas des catégories liste les guides dont le périmètre contient la catégorie.
• Mesurer l’audience et les ventes : active les statistiques et le cookie d’attribution dfbg_attr (voir plus bas).

Créer un guide

Cliquez sur Ajouter un guide d’achat. Les champs principaux :

• Titre : écrivez-le comme la question du client. Un guide n’est publié que dans les langues où il a un titre.
• URL simplifiée : générée depuis le titre si elle reste vide.
• Image de couverture : affichée en haut du guide, sur la page des guides et dans les partages. Format paysage, 1 200 px de large minimum. Elle est redimensionnée à 1 600 px de large au plus.
• Auteur et Fonction de l’auteur : affichés sous le titre et repris dans les données structurées.
• Introduction : à qui s’adresse le guide et ce qui compte pour cet usage.
• Produits comparés : les catégories du périmètre. Aucune catégorie cochée signifie tout le catalogue. L’option Inclure les sous-catégories est active par défaut.
• Prix minimum et Prix maximum : 0 signifie sans limite. Le prix est celui affiché aux visiteurs, dans la devise par défaut. Utile pour un guide « les meilleurs modèles à moins de 300 € ».
• Produits en stock uniquement : écarte les produits en rupture quand la gestion des stocks est active.
• Produits dans le classement : de 1 à 20, 5 par défaut. Les sélections sont toujours affichées, même hors de ce classement.
• Seuil de la sélection petit budget : 50 % par défaut (voir « Les trois sélections »).
• Laisser les visiteurs adapter le classement, Afficher le tableau comparatif, Afficher la FAQ.
• Questions supplémentaires : une question par ligne, sous la forme Question | Réponse. Elles s’ajoutent après les questions générées.
• Conclusion, Meta title et Meta description : le titre et le début de l’introduction servent de valeur par défaut.
• Publié : un guide non publié reste accessible en aperçu depuis le back-office.

Cliquez sur Enregistrer et rester : les panneaux des critères, du classement actuel, de l’audience et de l’historique apparaissent sous le formulaire.

Les critères

Sans critère, les produits sont classés par ventes. Cliquez sur Ajouter un critère et choisissez un type.

Types de critères

• Caractéristique : valeurs préférées : vous attribuez de 0 à 100 points à chaque valeur d’une caractéristique, par exemple Matière : inox 100, aluminium 70, plastique 30. Après le premier enregistrement, le formulaire affiche toutes les valeurs de la caractéristique avec un curseur et des boutons pour remplir toutes les valeurs d’un coup. Un produit qui a plusieurs valeurs garde la meilleure.
• Caractéristique : valeur numérique : le module lit le nombre contenu dans la valeur (« 90 min », « 1 200 W », « 2,5 kg ») et compare les produits. Choisissez dans Valeurs à privilégier si le plus haut ou le plus bas est le mieux. Valeur minimum et Valeur maximum excluent les produits hors plage ou sans valeur. Unité s’ajoute aux chiffres des statistiques.
• Prix (le plus bas est le mieux).
• Ventes (popularité) : basé sur les quantités vendues.
• Produits récents : basé sur la date d’ajout du produit.

Poids, obligation et textes

• Poids : de 0 à 10. Le poids 0 affiche le critère dans le tableau comparatif sans l’utiliser dans le score.
• Obligatoire (critères de caractéristique) : les produits sans cette caractéristique, ou dont la valeur vaut 0 point, sont exclus du guide.
• Libellé affiché aux visiteurs : le nom de la caractéristique est utilisé s’il reste vide.
• Conseil d’achat : explique pourquoi ce critère compte. Il apparaît dans la section « Comment choisir », au-dessus des statistiques du catalogue.

Les flèches de la liste des critères changent leur ordre d’affichage dans le tableau comparatif et la section « Comment choisir ».

Calcul du score

Pour chaque critère, les valeurs des produits sont ramenées sur une échelle de 0 à 100 : le meilleur produit du périmètre obtient 100 et le moins bon 0 pour les critères numériques, le prix, les ventes et la nouveauté, et les points que vous avez donnés pour les critères de valeurs. Le score global est la moyenne des scores pondérée par le poids des critères. Les prix sont comparés dans la devise par défaut.

Le panneau Classement actuel affiche les 20 premiers produits avec leur score global, leur prix, leur sélection et une colonne de score par critère. Utilisez-le pour régler les poids avant de publier.

Les trois sélections

• Meilleur choix : le produit classé premier.
• Meilleur rapport qualité/prix : parmi les produits moins chers que le meilleur choix et dont le score atteint au moins 60 % du sien, celui qui a le meilleur rapport entre score et prix.
• Petit budget : le produit le moins cher qui atteint le pourcentage réglé dans Seuil de la sélection petit budget du score du meilleur choix, s’il est moins cher que les deux autres sélections.

Une sélection n’apparaît que si un produit remplit la condition. Les points forts d’un produit sont ses critères notés 70 ou plus (3 au maximum), les points à surveiller ceux notés 30 ou moins (2 au maximum).

Mise à jour des classements

La modification d’un produit, d’un prix spécifique, d’une valeur de caractéristique ou d’une catégorie marque les classements à recalculer. Un changement de stock ne marque que les guides réglés sur « Produits en stock uniquement ». Le recalcul a lieu :

• à la visite suivante du guide ;
• par la tâche cron, si vous la planifiez ;
• avec le bouton Recalculer maintenant d’un guide ou Recalculer tous les classements maintenant de la liste.

Tâche cron

L’URL cron est affichée au-dessus de la liste des guides. Appelez-la toutes les heures pour que les visiteurs n’attendent jamais un recalcul. Ajoutez &force=1 pour recalculer tous les guides. Le bouton Nouveau jeton remplace le jeton, l’ancienne URL cesse alors de fonctionner. Exemple :

0 * * * * curl -s "https://votre-boutique.fr/index.php?fc=module&module=dfbuyingguide&controller=cron&token=VOTRE_JETON" > /dev/null

Date affichée et historique

La date « Classement mis à jour le » affichée aux visiteurs ne change que si le top du classement ou les sélections changent. Le panneau Historique des recommandations liste ces changements avec les 5 premiers produits à chaque date.

La page du guide

Dans l’ordre : titre, auteur, nombre de produits comparés et date de mise à jour, image de couverture, introduction, sommaire, les sélections, le classement, le tableau comparatif, la section « Comment choisir », la conclusion, la FAQ, une note de méthode et les guides liés (guides publiés qui partagent une catégorie).

Adapter le classement

Quand l’option est active et que le guide compte au moins 2 critères avec un poids, un panneau au-dessus du classement propose un curseur d’importance par critère et un curseur de budget maximum. Le classement se recalcule dans le navigateur parmi les 20 meilleurs produits, sans rechargement, et un lien revient au classement du guide. Sans JavaScript, le panneau reste masqué. Les moteurs de recherche voient toujours le classement du guide.

Ajouter au panier

Les produits qui s’ajoutent directement au panier, sans déclinaison à choisir, affichent un bouton Ajouter au panier qui utilise l’ajout au panier du thème. Les autres affichent Voir le produit. En mode catalogue, aucun bouton panier n’est affiché.

Aperçu d’un guide non publié

Le bouton Prévisualiser le guide ouvre la page avec un bandeau d’aperçu. Le lien contient un jeton propre au guide, la page est en noindex et les statistiques ne sont pas comptées.

Personnaliser les couleurs

Les couleurs sont définies par des variables CSS que votre thème peut surcharger : --dfbg-accent, --dfbg-accent-soft, --dfbg-muted, --dfbg-line, --dfbg-surface, --dfbg-low et --dfbg-radius. Les polices sont celles du thème.

Emplacements et référencement

• Index des guides : /guides, avec l’image de couverture ou le produit classé premier de chaque guide.
• Pages catégories : hook displayFooterCategory.
• Fiches produits : hook displayProductAdditionalInfo, badge de sélection ou « Classé n° X » avec lien vers le guide.
• Emplacement libre : {hook h='displayDfBuyingGuides' id_category=12} dans un template du thème. Sans id_category, tous les guides sont listés.
• Sitemap : si le module natif gsitemap est installé, l’index et les guides y sont ajoutés avec leur date de dernier changement de recommandation.
• Données structurées : Article (avec l’auteur et l’image), ItemList du classement et FAQPage. Les balises Open Graph sont ajoutées dans l’en-tête.
• Multilingue : canonical, hreflang vers chaque langue où le guide a un titre, et redirection 301 quand une URL est ouverte dans une autre langue.

Audience et ventes

La liste des guides affiche les vues et le CA des 30 derniers jours, et quatre indicateurs globaux en tête. Chaque guide a un panneau Audience et ventes sur 30 jours et depuis le début :

• Vues : une par visiteur, par guide et par jour, robots exclus.
• Clics produits et taux de clic par rapport aux vues.
• Clics d’ajout au panier depuis le classement.
• Visiteurs ayant adapté le classement.
• Commandes et taux de conversion par rapport aux vues.
• CA HT : montant hors taxes des produits venus du guide, converti dans la devise par défaut.

Attribution des ventes

Quand un visiteur clique sur un produit depuis un guide, le cookie interne dfbg_attr retient le produit et le guide pendant 30 jours. Quand ce produit entre dans le panier, l’attribution est copiée sur le panier. À la validation de la commande, y compris par un webhook de paiement, la commande et le montant HT de ce produit sont attribués au guide. Seules les commandes validées (statut payé ou équivalent) sont comptées.

Dupliquer un guide

L’action Dupliquer de la liste copie le guide avec ses critères, ses notes par valeur, ses boutiques et son image. La copie est créée non publiée, avec une URL suffixée, et s’ouvre directement pour être modifiée.

Multiboutique

Chaque guide est associé aux boutiques choisies dans son formulaire. Les classements, l’historique et les statistiques sont calculés boutique par boutique.

Dépannage

• « Aucun produit ne correspond à ce guide » : vérifiez les catégories, la fourchette de prix, l’option stock et les critères obligatoires ou à seuils.
• Un produit attendu n’apparaît pas : il doit être actif, visible dans le catalogue et faire partie des produits analysés. Augmentez « Produits analysés par guide » pour les grandes catégories.
• Le guide renvoie une erreur 404 : il n’est pas publié, n’a pas de titre dans cette langue ou n’est pas associé à cette boutique.
• Le classement ne suit pas une modification : cliquez sur « Recalculer maintenant » et planifiez la tâche cron.
• L’image de couverture est refusée : vérifiez que le dossier img/dfbuyingguide/ est accessible en écriture.