Avis Vérifiés WooCommerce — Documentation

DataFirefly Reviews (dfreviews) transforme le système d’avis natif de WooCommerce en machine à preuve sociale : demandes d’avis automatiques après achat, badge Achat vérifié, photos client, votes utiles, résumé IA des avis sur la fiche produit, réponse automatique aux avis par IA, code promo récompense et rich snippets Schema.org. Cette documentation couvre l’installation, la configuration complète et le dépannage.

Installation

1. Dans votre administration WordPress, ouvrez Extensions → Ajouter → Téléverser une extension.
2. Sélectionnez le fichier dfreviews-1.0.0.zip puis cliquez sur Installer maintenant et Activer.
3. Un nouveau sous-menu WooCommerce → DF Reviews apparaît : c’est le centre de contrôle du plugin.

Prérequis : WooCommerce 8 ou 9, WordPress 6.0+, PHP 8.0 à 8.3. Le plugin est compatible HPOS (High-Performance Order Storage) et fonctionne sans jQuery ni Composer.

Configuration de la clé OpenAI

Le résumé IA et la réponse automatique utilisent votre propre clé API OpenAI :

1. Créez une clé sur platform.openai.com.
2. Collez-la dans WooCommerce → DF Reviews → Settings, section OpenAI.
3. Le modèle par défaut est gpt-4o-mini — le plus économique, recommandé. Un résumé ou une réponse coûte typiquement bien moins d’un centime.

Demandes d’avis automatiques

Section Review requests des réglages :

• Statut déclencheur : la demande est mise en file quand une commande atteint ce statut (par défaut Commande terminée).
• Délai d’envoi : nombre de jours d’attente après le statut déclencheur (défaut : 3 jours).
• Relance : un unique email de rappel part si aucun avis n’a été déposé (défaut : 5 jours après le premier email).

Chaque email contient un lien d’avis personnel tokené : l’avis déposé via ce lien reçoit automatiquement le badge Achat vérifié. Les envois se font par lots de 50 à chaque passage du cron. L’onglet Request queue liste les 100 dernières demandes avec leur statut (pending, sent, reminded, completed, failed, unsubscribed) et permet de lancer un traitement manuel.

Résumé IA des avis

Dès qu’un produit atteint le nombre minimum d’avis publiés (défaut : 3), le cron génère un bloc affiché en tête de l’onglet avis de la fiche produit : points forts, points d’attention et synthèse.

• Le résumé est mis en cache par produit et par langue : avec Polylang ou WPML, chaque version linguistique affiche un résumé dans sa langue.
• Il est régénéré automatiquement quand de nouveaux avis sont publiés (invalidation par empreinte des avis analysés).
• Le réglage Max reviews analyzed limite le nombre d’avis envoyés au modèle.

L’onglet AI tools liste les résumés générés avec leur langue et leur date.

Réponse automatique aux avis par IA

Chaque avis publié peut recevoir une réponse marchande générée par IA, rédigée dans la langue de l’avis. Réglages clés :

• Mode de publication : Brouillon (recommandé au départ — chaque réponse attend votre validation dans le menu Commentaires) ou Publication immédiate.
• Ton : chaleureux, professionnel ou concis.
• Nom de signature : affiché comme auteur de la réponse (vide = nom du site).
• Répondre aux notes à partir de : 1 pour répondre à tous les avis — recommandé, car les avis négatifs sont ceux qui bénéficient le plus d’une réponse.

Garde-fous intégrés : pour les notes de 3/5 ou moins, la réponse présente des excuses et oriente vers le support, sans jamais promettre de remboursement. La réponse est limitée à environ 70 mots et s’affiche avec le badge Réponse officielle, exclue des moyennes de notes et des rich snippets.

Photos, votes et code promo récompense

• Photos client : les clients joignent jusqu’à 3 photos (configurable, max 10) à leur avis — formats jpg, png, webp, gif, 5 Mo max, affichage en lightbox.
• Votes utiles : boutons « Cet avis vous a-t-il été utile ? » avec protection anti-doublon par compte et par IP hashée. Jamais affichés sur les réponses marchandes.
• Code promo : à la publication de son avis, le client reçoit un coupon en pourcentage (défaut : 10 %, 30 jours), unique, à usage unique, restreint à son adresse email. Anti-farming : une seule récompense par email et par produit.

Formulaire et affichage

• Champ titre de l’avis, optionnel ou obligatoire.
• Longueur minimale de l’avis en caractères (défaut : 10).
• Bloc de répartition des notes (barres 5★ à 1★) au-dessus de la liste des avis.
• Couleur des étoiles personnalisable (hexadécimal, défaut #e7a11a).

Rich snippets Schema.org

Le plugin conserve le balisage AggregateRating et Review natif de WooCommerce en l’assainissant : les réponses marchandes sont exclues du balisage et des moyennes, pour des étoiles Google exactes. L’option peut être désactivée dans les réglages, ce qui retire alors tout balisage d’avis.

Cron : fiabiliser les envois

Le traitement (demandes, relances, résumés IA, réponses de rattrapage) s’exécute toutes les heures via WP-Cron. WP-Cron ne se déclenchant qu’à la visite du site, configurez un vrai cron serveur pour un envoi fiable :

1. Copiez l’URL de cron tokenée affichée dans Settings → Cron.
2. Ajoutez-la dans le cron de votre hébergeur (ou crontab), toutes les 15 à 60 minutes, par exemple avec curl -s "URL" > /dev/null.

Un verrou anti-concurrence empêche deux traitements simultanés. Le bouton Run processing now de l’onglet Request queue lance un traitement manuel à tout moment.

Import et export CSV

Onglet Import / Export :

• Export : tous les avis produits avec note, titre, indicateur vérifié et dates.
• Import : CSV avec ligne d’en-tête et colonnes product_id ou sku, author, email, rating, title, content, date (Y-m-d H:i:s, optionnel), verified (1/0, optionnel). Les statistiques de notes sont recalculées automatiquement après import.

Espace client

Un onglet Mes avis est ajouté au compte client (Mon compte) : chaque client y retrouve ses avis avec statut de modération, étoiles et badge vérifié. Si l’onglet renvoie une erreur 404 après activation, réenregistrez les permaliens via Réglages → Permaliens → Enregistrer.

RGPD et données

• Lien de désinscription dans chaque email de demande, adresses désinscrites stockées hashées en SHA-256, jamais en clair.
• Adresses IP des votants hashées avec le salt WordPress.
• Seul appel sortant : l’API OpenAI que vous contrôlez, uniquement si une clé est configurée.
• La désinstallation supprime les tables et réglages du plugin mais conserve tous les avis (avis WooCommerce natifs).

Dépannage

• Les demandes ne partent pas : vérifiez que la fonction est activée, que des commandes atteignent le statut déclencheur, et que le cron tourne (dernier passage affiché dans AI tools). Configurez l’URL de cron serveur.
• Pas de résumé IA : clé OpenAI configurée ? Nombre minimum d’avis publiés atteint ? Le résumé est généré au passage du cron, pas instantanément.
• Pas de réponse IA : vérifiez le mode (en brouillon, la réponse attend dans Commentaires → En attente), la note minimale configurée, et la clé API.
• Emails non reçus : le plugin envoie via le mailer WooCommerce — testez votre configuration email globale (un plugin SMTP est recommandé).