AIFORYA Testimonial Widget

Documentation technique de AIFORYA Testimonial Widget. Cette page est générée depuis le readme.txt livré avec l'extension : elle dit exactement ce que dit le produit, et ne peut pas dériver de lui. Pour corriger une information, corriger le readme.

← Revenir à la fiche produit Collectez, analysez et affichez vos témoignages clients avec un score d'impact IA prédictif (0-100), une modération automatique et des rich snippets Schema.org natifs.

Description

AIFORYA Testimonial Widget répond à un problème concret : les témoignages clients sont collectés, puis laissés en archive sans qu'on sache lesquels convertissent vraiment. Le plugin analyse chaque avis via les grands modèles de langage de votre choix , lui attribue un score d'impact prédictif de 0 à 100, et pilote l'affichage automatiquement pour mettre en avant les preuves sociales les plus efficaces. Trois modes d'affichage natifs sont inclus — shortcode, bloc Gutenberg et widget classique — sans iframe, sans dépendance SaaS, données hébergées sur votre propre WordPress.

Pourquoi AIFORYA Testimonial Widget ?

• Score d'impact prédictif 0-100 : chaque témoignage est noté selon 4 axes (spécificité, émotion, authenticité, utilité) pour estimer son potentiel de conversion, et mis en vedette automatiquement au-delà du seuil que vous définissez
• Analyse sémantique complète : sentiment, thèmes récurrents et résumé automatique générés par IA à chaque soumission ou import
• Modération automatique : les témoignages sont pré-qualifiés par l'IA avant publication, réduisant la charge de modération manuelle
• Import multi-sources : Google Places, Trustpilot, avis produits WooCommerce, commentaires YouTube — synchronisation planifiable toutes les heures
• Détection de plugins tiers : Strong Testimonials, WP Customer Reviews, Bravada, Real Testimonials — récupération de vos données existantes en un clic
• Témoignages vidéo : upload natif MP4/WebM/MOV ou embed YouTube/Vimeo/Loom, avec transcription automatique Whisper (accessibilité WCAG 2.1, SEO, recherche full-text)
• Rich snippets Schema.org JSON-LD : balises Review conformes aux exigences Google, activées par défaut
• Zéro impact sur la performance : aucun appel IA au moment du rendu public, tout traitement en cron ou AJAX admin, cache transient WordPress natif
• 6 langues complètes : Français, Anglais, Allemand, Espagnol, Italien, Néerlandais
• clé API personnelle strict (vos clés API) : Anthropic (Claude Haiku, recommandé), OpenAI (IA OpenAI-mini), Google (IA Google Flash), Mistral — vos clés, vos coûts, vos données

Fonctionnalités principales

Analyse IA & Score d'impact — À chaque nouveau témoignage (soumission frontend ou import), le plugin envoie le texte au fournisseur IA de votre choix et calcule un score 0-100 estimant la probabilité d'influence positive sur une décision d'achat. Les témoignages dépassant le seuil configuré sont automatiquement promus en affichage prioritaire. L'analyse inclut également la détection de sentiment, l'extraction de thèmes clés et un résumé court utilisable en meta-description.

Affichage natif (shortcode, Gutenberg, widget) — Le shortcode [aiforya_testimonials] s'insère dans tout article ou page. Le bloc Gutenberg "AIFORYA — Témoignages" offre une configuration visuelle avec aperçu en direct dans l'éditeur. Le widget classique est disponible dans Apparence → Widgets pour les thèmes non basés sur les blocs. Les trois modes partagent les mêmes options de filtrage, tri et mise en page.

Formulaire de soumission frontend — Le shortcode [aiforya_testimonial_form] génère un formulaire de collecte configurable incluant nom, note, texte, photo et témoignage vidéo (lien ou upload natif). Chaque soumission passe en file de modération avant publication.

Import & sources externes — Connectez Google Places, Trustpilot, les avis WooCommerce et les commentaires YouTube Data API v3. Chaque source se configure indépendamment avec sa propre clé API et sa fréquence d'import. Les imports sont planifiables via WP-Cron.

Transcription vidéo Whisper — Les fichiers vidéo soumis via le formulaire sont automatiquement transcrits via l'API Whisper d'OpenAI (si une clé OpenAI est configurée). La transcription est indexée pour la recherche full-text, incluse dans le rendu pour l'accessibilité WCAG 2.1, et crawlable par les moteurs.

Modération & administration — Un écran dédié liste les témoignages en attente avec leur score IA, sentiment et thèmes. Approbation, rejet ou édition en un clic. Filtres par source, score, statut et date.

Rich snippets & SEO — Chaque témoignage affiché publiquement émet un objet Review JSON-LD conforme aux recommandations Google pour les données structurées. Option activée par défaut, désactivable dans Réglages.

Pré-requis techniques

• WordPress 6.0 ou supérieur
• PHP 8.0 ou supérieur
• Clé API IA (Anthropic, OpenAI, Google ou Mistral) pour les fonctionnalités d'analyse — l'affichage simple fonctionne sans clé
• Pour l'import YouTube : clé YouTube Data API v3 (Google Cloud Console, quota gratuit de 10 000 unités/jour)
• Pour la transcription vidéo : clé OpenAI (API Whisper, ~0,006 $/minute)
• WooCommerce 6.0+ uniquement si vous utilisez la source "Avis produits WooCommerce"

Sécurité et conformité

• Nonces WordPress sur tous les formulaires admin et endpoints AJAX
• Capabilities : seuls les utilisateurs disposant de manage_options ont accès au panneau d'administration
• Sanitization : sanitize_text_field, sanitize_email, wp_kses_post sur toutes les entrées utilisateur
• clé API personnelle strict : les clés API ne transitent jamais par les serveurs AIFORYA — les appels IA partent directement de votre hébergement WordPress vers le fournisseur choisi
• Données hébergées localement : tous les témoignages sont stockés dans votre base de données WordPress, aucun envoi vers un service tiers à l'exception des appels IA volontaires
• uninstall preserve : par défaut, vos données sont conservées à la suppression. Cleanup destructif uniquement en opt-in explicite (Réglages → Avancé)
• Conformité RGPD : aucune donnée personnelle collectée par AIFORYA, le responsable de traitement est l'administrateur du site WordPress

Installation

Installation automatique (recommandé)

1. Connectez-vous à votre tableau de bord WordPress
2. Allez dans Extensions → Ajouter une extension
3. Recherchez "AIFORYA Testimonial Widget"
4. Cliquez sur Installer maintenant, puis Activer
5. Le plugin redirige vers le tableau de bord AIFORYA Testimonial Widget pour la configuration initiale

Installation manuelle (fichier ZIP)

1. Téléchargez le fichier aiforya-testimonial-widget.zip
2. Dans WordPress, allez dans Extensions → Ajouter une extension → Téléverser une extension
3. Sélectionnez le ZIP et cliquez Installer maintenant
4. Cliquez Activer l'extension

Premier lancement

1. Allez dans AIFORYA TW → Réglages → IA et renseignez au moins une clé API (Anthropic Claude Haiku est recommandé pour le meilleur rapport coût/qualité). Utilisez le bouton "Tester la clé" pour valider la connexion.
2. Allez dans AIFORYA TW → Réglages → Général pour configurer le seuil du score d'impact (valeur par défaut : 70) au-delà duquel un témoignage est mis en vedette automatiquement.
3. Ajoutez votre premier témoignage manuellement via AIFORYA TW → Témoignages → Ajouter ou configurez une source externe dans AIFORYA TW → Sources → Ajouter une source.
4. Placez le shortcode [aiforya_testimonials] dans une page, utilisez le bloc Gutenberg "AIFORYA — Témoignages" dans l'éditeur, ou activez le widget dans Apparence → Widgets.
5. Vérifiez l'affichage en frontend et, si souhaité, activez le formulaire de soumission visiteur avec [aiforya_testimonial_form].

Frequently Asked Questions

Comment afficher des témoignages sur mon site ?

Trois méthodes sont disponibles : le shortcode [aiforya_testimonials] dans n'importe quel article ou page, le bloc Gutenberg "AIFORYA — Témoignages" accessible depuis l'éditeur de blocs, ou le widget classique dans Apparence → Widgets. Les trois options partagent les mêmes paramètres de filtrage et de mise en page.

Comment fonctionne le Score d'Impact prédictif ?

L'IA analyse chaque témoignage selon 4 axes (spécificité, émotion, authenticité, utilité) et calcule un score de 0 à 100 estimant la probabilité qu'il influence positivement une décision d'achat. Les témoignages dépassant le seuil que vous configurez dans Réglages sont automatiquement mis en vedette dans l'affichage frontend.

Quel fournisseur IA utiliser ?

AIFORYA Testimonial Widget fonctionne en vos clés API : vous gardez la main sur vos coûts et vos données. Quatre fournisseurs sont supportés : Anthropic (Claude Haiku par défaut, recommandé), OpenAI (IA OpenAI-mini), Google (IA Google Flash) et Mistral. Vous pouvez tester chaque clé depuis l'onglet Réglages avant de valider votre choix.

Le plugin ralentit-il mon site ?

Non. Aucun appel IA n'est effectué pendant le rendu d'une page publique : tout le traitement se passe en cron ou AJAX admin, après soumission ou import. Le rendu public est mis en cache via le système de transient WordPress natif.

Puis-je importer mes témoignages depuis Google, Trustpilot ou WooCommerce ?

Oui. Allez dans Sources → Ajouter une source, puis choisissez Google Places, Trustpilot, Avis produit WooCommerce ou YouTube — Commentaires. Renseignez la clé API et la configuration propre à chaque plateforme. Les imports automatiques sont planifiables (toutes les heures par défaut). Vous pouvez également détecter automatiquement les plugins de témoignages tiers déjà installés (Strong Testimonials, WP Customer Reviews, Bravada, Real Testimonials) pour récupérer vos données existantes en un clic.

Comment activer les étoiles dans Google (rich snippets) ?

L'option Schema.org JSON-LD est activée par défaut dans Réglages. Chaque témoignage affiché publiquement émet un objet Review structuré conforme aux exigences Google pour les données structurées.

Comment créer une clé YouTube Data API v3 (pour importer les commentaires d'une vidéo) ?

Rendez-vous sur console.cloud.google.com et sélectionnez ou créez un projet. Dans le menu API & Services → Bibliothèque, cherchez "YouTube Data API v3" et cliquez "Activer". Allez ensuite dans Identifiants → Créer des identifiants → Clé API, puis copiez la clé générée (elle commence par AIza...). Collez-la dans Sources → Ajouter une source → YouTube. La clé est gratuite jusqu'à 10 000 unités par jour (1 import représente 1 unité, jusqu'à 100 commentaires), ce qui est largement suffisant pour tous les usages courants. La clé YouTube est distincte d'une clé Google Places, mais les deux peuvent provenir du même projet Cloud Console.

Comment soumettre un témoignage vidéo en frontend ?

Le formulaire de soumission [aiforya_testimonial_form] propose un champ "Témoignage vidéo (optionnel)" avec deux modes : coller un lien YouTube, Vimeo ou Loom (l'embed est généré automatiquement avec lecteur lazy-loaded), ou téléverser un fichier vidéo natif (MP4, WebM, MOV) directement depuis l'appareil du visiteur. La taille maximale et les types MIME acceptés se règlent dans Réglages → Vidéo testimonials. Les témoignages vidéo passent en modération de la même façon que les témoignages texte.

Comment activer la transcription Whisper des témoignages vidéo ?

La transcription audio vers texte se fait via l'API Whisper d'OpenAI. Configurez votre clé OpenAI dans Réglages → IA, puis activez "Transcrire automatiquement" dans Réglages → Vidéo testimonials. À chaque attachement vidéo, l'audio est extrait et transcrit ; le texte est stocké dans le champ video_transcript de la table aiforya_tw_reviews. Trois bénéfices : accessibilité WCAG 2.1, SEO (Google indexe le texte de la vidéo), et recherche full-text dans vos témoignages. Le coût Whisper est d'environ 0,006 $ par minute. Vous pouvez également déclencher la transcription manuellement depuis l'onglet Témoignages.

Screenshots

1. Tableau de bord — Vue d'ensemble des témoignages avec scores d'impact, statuts de modération et statistiques globales
2. Score d'impact IA — Détail de l'analyse prédictive d'un témoignage (score 0-100, sentiment, thèmes extraits, résumé)
3. Liste des témoignages — Écran de modération avec filtres par source, score, statut et date
4. Sources externes — Configuration d'un import Google Places avec fréquence planifiable et aperçu des derniers imports
5. Formulaire frontend — Rendu du shortcode [aiforya_testimonial_form] avec champ vidéo (lien ou upload natif)
6. Affichage public — Rendu du shortcode [aiforya_testimonials] avec mise en vedette automatique des témoignages à fort score
7. Bloc Gutenberg — Configuration du bloc "AIFORYA — Témoignages" avec aperçu en direct dans l'éditeur
8. Réglages IA — Sélection du fournisseur clé API personnelle, saisie et test de clé API, configuration du seuil de mise en vedette

Changelog

1.3.3 — 8 mai 2026

• Première version stable distribuée publiquement.
• Score d'impact prédictif IA 0-100 (4 axes : spécificité, émotion, authenticité, utilité) avec mise en vedette automatique configurable.
• Import multi-sources : Google Places, Trustpilot, WooCommerce, YouTube Data API v3 — synchronisation planifiable via WP-Cron.
• Témoignages vidéo avec upload natif MP4/WebM/MOV, embed YouTube/Vimeo/Loom et transcription automatique Whisper.
• Affichage natif trimodal : shortcode [aiforya_testimonials], bloc Gutenberg, widget classique — avec rich snippets Schema.org JSON-LD activés par défaut.
• clé API personnelle strict : Anthropic Claude Haiku, OpenAI IA OpenAI-mini, Google IA Google Flash, Mistral.

Documentation complète

• Quick Start : installation, configuration de la première clé API et affichage de vos premiers témoignages en moins de 10 minutes
• Configuration des fournisseurs IA : choisir entre Anthropic, OpenAI, Google et Mistral selon vos préférences de coût et de confidentialité
• Import de sources externes : connecter Google Places, Trustpilot, WooCommerce et YouTube, configurer les fréquences et gérer les doublons
• Témoignages vidéo & transcription Whisper : activer l'upload natif, paramétrer les MIME acceptés et exploiter les transcriptions pour le SEO
• Score d'impact & modération automatique : comprendre les 4 axes d'analyse, régler le seuil de mise en vedette et auditer les décisions IA
• Rich snippets & SEO : vérifier l'émission JSON-LD avec l'outil de test Google et configurer les champs de données structurées
• Conformité RGPD : rôle du responsable de traitement, données stockées localement, absence de collecte AIFORYA
• Dépannage : activer les logs PHP, interpréter les messages d'erreur API et contacter le support avec les informations utiles

Support et contact

• Documentation : intégrée dans le plugin (onglet Support → FAQ) ou en ligne sur https://aiforya.fr/extensions/testimonial-widget
• Support : support@aiforya.fr ou onglet Support dans le plugin (réponse sous 48h ouvrées)
• Bugs : remontez via l'onglet Support avec captures d'écran et logs PHP
• Suggestions : nous adorons recevoir vos retours par email