DataFirefly FAQ IA Produit pour WooCommerce — Documentation

DataFirefly FAQ IA Produit génère automatiquement des FAQ contextuelles pour vos fiches produits WooCommerce à l’aide d’OpenAI ou d’Anthropic Claude, et injecte les rich snippets Schema.org FAQPage dans la balise head pour les résultats enrichis Google. Ce guide couvre l’installation, la configuration complète et l’utilisation au quotidien.

Prérequis

• WordPress 6.0 ou supérieur (testé jusqu’à 6.6)
• WooCommerce 7.0 ou supérieur (testé jusqu’à 9.4), compatible HPOS
• PHP 7.4 à 8.3
• Une clé API OpenAI (platform.openai.com/api-keys) ou Anthropic (console.anthropic.com)
• Facultatif : Polylang ou WPML pour le multilingue

Installation

1. Téléchargez le fichier dffaqai-1.0.0.zip depuis votre compte DataFirefly.
2. Dans l’admin WordPress : Extensions → Ajouter → Téléverser une extension, sélectionnez le ZIP puis cliquez sur Installer maintenant.
3. Cliquez sur Activer. Le plugin crée sa table de stockage des FAQ et ses réglages par défaut.

Configuration du fournisseur IA

Rendez-vous dans FAQ IA → Réglages → onglet Fournisseur.

Choisir OpenAI ou Anthropic Claude

• OpenAI : collez votre clé API, puis choisissez un modèle — gpt-4o-mini (le plus économique, recommandé), gpt-4o, gpt-4-turbo ou gpt-3.5-turbo.
• Anthropic Claude : collez votre clé API, puis choisissez — claude-haiku-4-5 (économique, recommandé), claude-sonnet-4-6 ou claude-opus-4-7.

Le plugin route automatiquement vers la bonne API selon le fournisseur sélectionné. Vous pouvez basculer à tout moment : les FAQ déjà générées sont conservées.

Paramètres de génération

• Nombre de questions par produit : 1 à 15 (5 par défaut).
• Température : 0 (déterministe) à 2 (très créatif). 0,7 par défaut.
• Max tokens : longueur maximale de la réponse IA. 2000 par défaut.

Onglet Prompt — personnaliser le contenu généré

Ton de voix

Six styles préconfigurés : professionnel, amical, décontracté, technique, enthousiaste, rassurant. Le ton change la formulation des réponses sans rien coder.

Audience cible

Texte libre, par exemple « professionnels de santé (B2B) », « premiers acheteurs » ou « bricoleurs ». L’IA adapte le vocabulaire, les références et le niveau de détail.

Prompt système personnalisé

Laissez vide pour utiliser le prompt par défaut construit à partir du ton et de l’audience. Si vous le remplissez, il remplace complètement les instructions par défaut — utile pour les boutiques avec une charte éditoriale stricte.

Directives supplémentaires

Instructions ajoutées à chaque prompt, par exemple « toujours mentionner la garantie 2 ans », « éviter les superlatifs », « ne pas comparer aux concurrents ».

Contexte produit à inclure

Trois cases à cocher enrichissent le contexte envoyé à l’IA : catégorie principale, marque (taxonomies product_brand, pwb-brand et yith_product_brand détectées automatiquement) et attributs WooCommerce. Sur les produits techniques, l’inclusion des attributs améliore nettement la pertinence des questions.

Onglet Affichage & SEO

Position d’affichage

Cinq hooks WooCommerce au choix :

• woocommerce_after_single_product_summary — sous les onglets (par défaut)
• woocommerce_single_product_summary — à l’intérieur du résumé produit
• woocommerce_product_meta_end — en fin de méta produit
• woocommerce_after_single_product — après toute la zone produit
• woocommerce_before_single_product — avant toute la zone produit

La priorité du hook (15 par défaut) est configurable pour gérer la coexistence avec d’autres plugins.

Mode d’affichage

Accordéon (première question ouverte, navigation clavier ARIA) ou toutes les réponses dépliées.

Rich snippets FAQPage

Lorsque l’option est active, le plugin injecte le JSON-LD Schema.org FAQPage dans la balise head de chaque fiche produit ayant au moins une FAQ active. L’encodage utilise JSON_HEX_TAG, JSON_HEX_AMP, JSON_HEX_APOS et JSON_HEX_QUOT et passe le Rich Results Test de Google.

Titre de la FAQ par langue

Un champ de titre par langue active du site, avec des valeurs par défaut fournies en FR, EN, ES, DE, IT, PT et NL.

Catégories exclues

Liste d’identifiants de catégories WooCommerce séparés par des virgules. Les produits de ces catégories sont ignorés en génération de masse et en auto-génération (produits virtuels, cartes cadeaux, etc.).

La métabox FAQ sur la fiche produit

Sur l’écran d’édition de chaque produit, la métabox FAQ IA offre un contrôle complet :

• Générer avec l’IA : crée un jeu de questions/réponses pour la langue sélectionnée.
• Ajouter une question manuelle à tout moment.
• Modifier une question ou une réponse : la ligne s’enregistre automatiquement à la perte de focus.
• Réordonner par glisser-déposer via la poignée à gauche de chaque ligne.
• Activer/désactiver une entrée sans la supprimer.
• Supprimer définitivement une entrée.

Un sélecteur de langue en haut de la métabox permet de basculer instantanément entre les traductions Polylang ou WPML du produit — chaque traduction possède son propre jeu de FAQ.

Génération en masse

Menu FAQ IA → Génération en masse :

1. Choisissez la langue cible : langue par défaut, langue spécifique, ou toutes les langues actives.
2. Cochez éventuellement Forcer la régénération pour écraser les FAQ existantes (utile après un changement de ton ou de fournisseur).
3. Cliquez sur Démarrer.

Le traitement est séquentiel (environ un produit par seconde selon la latence API) avec barre de progression en temps réel, compteur de produits traités et journal d’erreurs par produit. Le bouton Stop interrompt proprement entre deux produits. Les produits publiés uniquement sont traités ; les catégories exclues sont ignorées.

Auto-génération à la création de produit

Option de l’onglet Fournisseur : lorsqu’elle est active, le plugin génère automatiquement une FAQ dans la langue par défaut à chaque enregistrement d’un produit qui n’en a pas encore. Les FAQ existantes ne sont jamais écrasées par ce mécanisme.

Multilingue Polylang & WPML

Le plugin détecte automatiquement Polylang (pll_languages_list, pll_get_post_translations) et WPML (wpml_active_languages, wpml_object_id). Chaque traduction d’un produit reçoit son propre jeu de FAQ, généré nativement dans la langue cible — ce n’est pas une traduction de l’original. La génération en masse « toutes langues » parcourt chaque traduction de chaque produit.

Vérifier les rich snippets

1. Ouvrez une fiche produit ayant au moins une FAQ active.
2. Affichez le code source et cherchez application/ld+json : un bloc "@type":"FAQPage" doit être présent.
3. Testez l’URL dans le Rich Results Test de Google : la détection « FAQ » doit être valide.

Dépannage

« La clé API du fournisseur IA n’est pas configurée »

Renseignez la clé du fournisseur actif dans l’onglet Fournisseur. Vérifiez qu’il n’y a pas d’espace avant/après la clé.

Erreur API pendant la génération

Consultez WooCommerce → État → Journaux et sélectionnez la source dffaqai : chaque erreur API y est enregistrée avec le code HTTP et le message du fournisseur (clé invalide, quota dépassé, modèle inconnu…).

Le bloc FAQ ne s’affiche pas

Vérifiez que le produit a au moins une FAQ active dans la langue affichée, et que le thème exécute le hook choisi. En cas de doute, revenez au hook par défaut woocommerce_after_single_product_summary, présent sur tous les thèmes WooCommerce standards.

Les questions générées sont dans la mauvaise langue

La langue de génération suit la traduction du produit (Polylang/WPML) ou la locale du site en mono-langue. Vérifiez le sélecteur de langue de la métabox avant de générer.

Désinstallation

La désactivation conserve toutes les données. La suppression du plugin exécute uninstall.php : la table SQL des FAQ et toutes les options dffaqai_* sont supprimées définitivement.

Support

Le support s’effectue par email avec une réponse sous 24 h ouvrées (FR/EN). Joignez si possible le journal dffaqai et les versions WordPress/WooCommerce/PHP.