DataFirefly Avis Vérifiés — Documentation

Prérequis et installation

DataFirefly Avis Vérifiés fonctionne sur PrestaShop 8.0 à 9.0 avec PHP 8.0 à 8.4. Depuis la version 1.1.0, un seul ZIP couvre les deux branches : il n’y a pas de version PS 8 et de version PS 9 à choisir au téléchargement.

1. Dans votre back-office, ouvrez Modules → Gestionnaire de modules puis cliquez sur Installer un module.
2. Déposez le fichier dfreviews.zip téléchargé depuis votre compte DataFirefly.
3. Cliquez sur Configurer une fois l’installation terminée.

L’installation crée six tables dédiées (avis, médias, demandes, votes utiles, résumés IA, statistiques) et ajoute un onglet Avis Vérifiés sous le menu Catalogue. C’est depuis cet onglet que vous modérez les avis ; l’écran de configuration, lui, reste accessible depuis le gestionnaire de modules.

Configurer le déclenchement des demandes d’avis

C’est le cœur du module. Deux réglages, dans la section Paramètres généraux :

• Déclencher après le statut : Expédié (par défaut) ou Livré. Choisissez celui qui, dans votre flux réel, signale que le client a le produit en main.
• Délai avant envoi : 3 jours par défaut. Comptez le temps de livraison plus quelques jours d’usage. Pour un produit qui se juge à l’usage (cosmétique, matelas), montez à 10 ou 15 jours.

Quand une commande atteint le statut choisi, une demande est mise en file d’attente avec sa date d’envoi calculée. Elle n’est pas envoyée immédiatement : c’est le CRON qui s’en charge.

Mettre le CRON en place

Sans CRON, aucun email ne part. L’URL à appeler est affichée en haut de l’écran de configuration du module ; elle contient un jeton unique généré à l’installation. Programmez-la toutes les heures chez votre hébergeur :

0 * * * * wget -q -O /dev/null "URL_CRON_AFFICHEE_DANS_LE_MODULE"

À chaque passage, le CRON effectue trois traitements et renvoie un résumé JSON du travail accompli :

• envoi des demandes arrivées à échéance, par lots de 50 ;
• envoi des relances pour les demandes restées sans réponse ;
• expiration des demandes de plus de 60 jours.

Relances et code promo en récompense

La section Relance active un second email si l’avis n’a pas été déposé après un délai configurable (5 jours par défaut, décompté depuis le premier envoi). Une seule relance est envoyée par demande.

La section Code promo incitatif génère un bon de réduction dès qu’un avis est publié par un client identifié. Vous définissez le pourcentage (10 % par défaut) et la durée de validité (30 jours). Le code créé est une règle panier PrestaShop native, nominative et à usage unique — vous le retrouvez donc dans Catalogue → Réductions.

Activer le résumé IA

Renseignez votre clé API OpenAI dans la section Intelligence Artificielle et choisissez un modèle. gpt-4o-mini est retenu par défaut : c’est le plus économique, de l’ordre du demi-centime par résumé.

Le résumé se déclenche à partir de trois avis publiés sur un produit. Le module envoie jusqu’à 100 avis à OpenAI et récupère trois éléments structurés : points forts, points faibles, synthèse globale. Le résultat est mis en cache par produit, par boutique et par langue, puis affiché en haut de la zone avis de la fiche produit.

Vous pouvez désactiver l’affichage sans supprimer la clé grâce à l’option Afficher le résumé IA sur la page produit.

Rich snippets et affichage front-office

Quand l’option Rich Snippets est active, le module injecte des données structurées Schema.org (AggregateRating, Review, Offer, Brand) sur chaque fiche produit atteignant le nombre minimum d’avis configuré. Vérifiez le rendu avec l’outil de test des résultats enrichis de Google après le passage du robot.

Côté affichage, le module s’accroche aux hooks natifs du thème :

• displayProductAdditionalInfo : les étoiles et la note moyenne sous le titre du produit ;
• displayProductExtraContent : l’onglet « Avis clients » avec la liste, les filtres et le formulaire ;
• displayProductListReviews : les étoiles sur les listings de catégorie ;
• displayCustomerAccount : le lien « Mes avis » dans le compte client.

Ces hooks existent dans les thèmes Classic et Hummingbird. Sur un thème sur mesure qui les aurait retirés, il faut les rétablir dans les templates concernés, sans quoi les avis ne s’afficheront nulle part.

Modérer les avis

L’écran Catalogue → Avis Vérifiés affiche un tableau de bord (total, publiés, en attente, signalés, note moyenne, demandes en file) suivi de la liste complète des avis.

Par défaut, chaque avis attend votre validation. Activez Approbation automatique si vous préférez la publication immédiate. Depuis la liste, vous pouvez approuver ou rejeter en masse, et ouvrir un avis pour l’éditer ou lui répondre.

La réponse du marchand s’affiche publiquement sous l’avis. Si une clé OpenAI est configurée, un bouton Suggestion IA de réponse propose un brouillon adapté au ton de l’avis — à relire et ajuster avant enregistrement, jamais à publier tel quel.

Photos client

Les clients peuvent joindre jusqu’à N photos par avis (3 par défaut). Formats acceptés : JPEG, PNG et WebP, 5 Mo maximum par fichier. Le type réel du fichier est vérifié à la réception, indépendamment de son nom.

Les images sont stockées dans modules/dfreviews/uploads/. Pensez à inclure ce dossier dans vos sauvegardes : supprimer un avis supprime aussi ses fichiers.

Importer et exporter des avis

Depuis l’écran Avis Vérifiés, le bouton Exporter CSV produit un fichier UTF-8 séparé par des points-virgules, directement lisible dans Excel. Le bloc d’import, juste en dessous, permet de charger un fichier au même format.

Deux colonnes sont obligatoires : id_product et rating (de 1 à 5). Les autres sont facultatives : customer_name, customer_email, title, content, id_customer, id_order, verified_purchase, active, merchant_reply et date_add. Les lignes dont le produit n’existe pas sont ignorées et signalées. Cochez Auto-approuver pour publier directement les avis importés.

Le plus simple pour préparer une migration depuis Trustpilot ou un ancien module : exporter d’abord un fichier depuis le module pour récupérer l’en-tête exact, puis y verser vos données.

Multi-boutique et multilingue

Toute la configuration est indépendante par sous-boutique : clé OpenAI, statut déclencheur, délais, couleurs, incentive. Les avis sont cloisonnés par id_shop, donc un même produit présent dans plusieurs boutiques peut afficher des ensembles d’avis différents selon le contexte.

Les avis et les résumés IA sont stockés avec leur id_lang. Un résumé est généré pour la langue dans laquelle il est demandé.

Passer de PrestaShop 8 à PrestaShop 9

Aucune migration de données n’est nécessaire : le schéma est identique sur les deux branches. Remplacez le module par la version 1.1.0 avant ou après votre montée de version PrestaShop, dans l’ordre qui vous arrange.

Si vous mettez à jour depuis une 1.0.x sur une boutique déjà passée en PS 9, deux points à connaître : les versions antérieures à la 1.1.0 ne s’installent pas sur PS 9 (l’enregistrement de hooks sans méthode correspondante y est refusé), et la configuration existante est intégralement conservée lors de la mise à jour.

Dépannage

Aucun email de demande n’est envoyé. Vérifiez d’abord que le CRON tourne réellement en appelant son URL à la main : la réponse JSON indique le nombre d’envois. Contrôlez ensuite le statut déclencheur configuré, puis les réglages email de la boutique dans Paramètres avancés → E-mail.

Les étoiles n’apparaissent pas sur la fiche produit. Le thème n’appelle probablement pas les hooks listés plus haut. Vérifiez aussi qu’au moins un avis est publié : sans avis actif, rien ne s’affiche.

Le résumé IA ne se génère pas. Il faut trois avis publiés minimum et une clé OpenAI valide et créditée. Les erreurs d’appel API sont tracées dans Paramètres avancés → Logs.

Les étoiles ne remontent pas dans Google. L’indexation prend de quelques jours à quelques semaines. Vérifiez le balisage avec l’outil de test des résultats enrichis, et contrôlez qu’un autre module SEO n’injecte pas un second bloc Product concurrent sur la même page.

L’import CSV ne fait rien. C’était un défaut des versions 1.0.x, corrigé en 1.1.0.