La documentation complète et le guide de Stella Ratings and Reviews, un plugin d'évaluation et d'avis à étoiles léger, rapide et personnalisable sur WordPress.

Table des Matières

1. Introduction & Architecture Système
2. Installation & Configuration Initiale
3. Shortcodes & Blocs d'Édition
4. Configuration des Réglages Généraux
5. Configuration des Champs du Formulaire
6. Intégration et Affichage Automatique
7. Sécurité, Limites de Saisie & Anti-Spam
8. Références des Fonctionnalités Gratuites
9. Activation des Fonctionnalités Pro
10. Intégration Avancée WooCommerce
11. Rapports Statistiques & Analyses
12. Gestion des Données & Désinstallation
13. Licences d'Utilisation & Support Client

1. Introduction & Architecture Système

Stella Ratings and Reviews est un plugin professionnel d'évaluation et d'avis par étoiles de haute performance conçu pour WordPress. Développé dès le départ pour prioriser la vitesse de chargement de vos pages, la propreté de votre base de données SQL et une flexibilité maximale, il permet aux propriétaires de sites web de collecter les avis clients, d'afficher des barres de statistiques de notes interactives et d'exploiter les commentaires pour doper leurs conversions et leur classement sur Google.

Le plugin est composé de deux modules complémentaires distincts :

Stella Ratings and Reviews (Version Gratuite) : Gère le sélecteur d'étoiles principal, la soumission des formulaires d'avis par les utilisateurs, l'interface de modération AJAX de base, la traduction des étiquettes frontales et les blocages élémentaires contre les robots.
Stella Ratings and Reviews Pro (Extension Premium) : Débloque des options de présentation avancées telles que la notation par critères multiples, l'envoi de pièces jointes (photos/vidéos), la vérification d'achat automatique, l'injection de données structurées SEO Rich Snippets JSON-LD pour Google, le module de réponse administrateur et de nouveaux habillages esthétiques.

2. Installation & Configuration Initiale

Comment installer la version gratuite

Connectez-vous à votre tableau de bord d'administration WordPress.
Rendez-vous dans le menu Extensions > Ajouter.
Dans la zone de recherche en haut à droite, tapez Stella Ratings and Reviews.
Cliquez sur Installer maintenant puis sur Activer.

Comment installer la version Pro

Rappel : L'extension gratuite Stella Ratings and Reviews doit être installée et activée sur votre site avant de pouvoir exploiter les fonctionnalités Pro.

Téléchargez l'archive zip stella-ratings-pro.zip depuis votre compte client.
Rendez-vous dans Extensions > Ajouter de votre WordPress et cliquez sur le bouton Téléverser une extension.
Sélectionnez l'archive zip sur votre ordinateur et cliquez sur Installer maintenant.
Une fois l'installation achevée, cliquez sur le bouton Activer l'extension.

3. Shortcodes & Blocs d'Édition

Stella Ratings and Reviews vous offre une liberté totale quant à l'emplacement de votre section d'avis. Vous pouvez insérer le widget sur n'importe quel article, page ou type de contenu sur mesure.

Utilisation élémentaire du Shortcode : `[stella_ratings]`

Par défaut, l'ajout du shortcode simple sans attribut charge l'interface d'avis et lie automatiquement tous les commentaires soumis à l'ID de la page web sur laquelle il est placé.

Attributs de configuration avancés

Ajustez le comportement de votre widget à l'aide des paramètres optionnels suivants :

Attribut	Type	Valeur par défaut	Description
`product_key`	Chaîne	Slug de la page actuelle	Associe les notes à un identifiant produit ou service personnalisé (ex. `[stella_ratings product_key="forfait-premium"]`). Idéal pour les landing pages hors catalogue classique.
`limit`	Entier	`10`	Configure le nombre maximal d'avis affichés avant de proposer une pagination ou l'apparition du bouton de chargement AJAX.
`post_id`	Entier	ID du contenu actuel	Force l'affichage des avis liés spécifiquement à un identifiant d'article WordPress (ID) déterminé.

Bloc Gutenberg natif

Pour les éditeurs modernes tirant profit du système d'édition par blocs (Gutenberg), l'extension intègre le bloc Stella Ratings Block. Saisissez "Stella Ratings" dans la bibliothèque des blocs et placez-le dans votre page. Configurez l'ensemble des options directement depuis l'inspecteur latéral de droite.

4. Configuration des Réglages Généraux

Définissez les règles de fonctionnement de base de votre module de notation en ouvrant le menu Stella Ratings > Réglages de votre WordPress.

Avis par page : Configure le nombre de retours d'expérience visibles par page avant de nécessiter une navigation.
Activer le bouton "Charger plus" : Remplacez la pagination à numéros traditionnelle par un chargement asynchrone moderne via AJAX au clic d'un bouton.
Tri par défaut : Définissez l'ordre de chargement des avis (ex. Les plus récents, Les mieux notés ou Les plus pertinents).
Restreindre aux utilisateurs connectés : Limitez le dépôt de commentaires en obligeant vos visiteurs à s'identifier sur le site avant de voter.

5. Configuration des Champs du Formulaire

Dans la section de Configuration des Champs des réglages, gérez les entrées affichées sur votre formulaire en ligne.

Champs standard

Activez, masquez ou rendez obligatoires les champs suivants :

Votre nom : L'identité publique visible de l'auteur de l'avis.
Votre adresse e-mail : Coordonnée de contact (utilisée pour l'anti-spam et le recoupement d'achat).
Votre site internet : Permet au client de lier son site web personnel.
Corps de l'avis : Le champ texte de description de l'expérience client.

Ajout de champs personnalisés

Complétez votre formulaire avec des données adaptées à votre domaine d'activité (telles que "Nom de votre société", "Tranche d'âge" ou "Taille commandée") depuis les options. Ces informations sont stockées avec l'avis et présentées sous le nom du contributeur pour rassurer vos futurs acheteurs.

6. Intégration et Affichage Automatique

Pour vous éviter d'avoir à insérer des shortcodes sur chacun de vos articles, utilisez les filtres automatiques du menu Affichage Automatique.

Activer l'affichage automatique : Démarre l'injection globale et automatique du widget sur vos pages.
Contenus cibles : Cochez les types de pages recevant le widget (ex. Articles, Pages ou portfolio personnalisé).
Catégories de ciblage : Restreignez l'injection à certaines thématiques ou catégories éditoriales de WordPress.
Position de rendu : Sélectionnez si le widget s'injecte Sous le contenu de l'article ou au sommet de la page.

7. Sécurité, Limites de Saisie & Anti-Spam

Protégez votre espace des attaques massives de faux avis, des robots malveillants et des spammeurs à l'aide de filtres intelligents.

Un avis par adresse e-mail : Bloque les multiples dépôts d'avis depuis une même adresse email pour un produit. Les doublons affichent une invite d'erreur personnalisable.
Limite d'envoi par IP : Limitez l'envoi de requêtes massives depuis une même connexion internet (ex. maximum 3 avis acceptés par adresse IP sur un créneau de 2 heures).
Bridage AJAX de soumission : Limite le taux de traitement des requêtes pour bloquer les tentatives de piratage de votre base SQL.

8. Références des Fonctionnalités Gratuites

La version gratuite de base regroupe tous les outils indispensables pour démarrer sereinement dans des conditions réelles de production :

Ultra-rapide et léger : Optimisé pour une vitesse et des performances de page maximales, avec un impact nul sur la base de données et un chargement minimal des ressources.
Modération AJAX dynamique : Moderez, approuvez ou supprimez les avis des utilisateurs instantanément depuis un tableau de bord unique, sans rechargement de page.
Champs de formulaire personnalisables : Ajoutez, supprimez ou personnalisez facilement des champs (comme le "Nom de l'entreprise" ou le "Poste") pour collecter des informations clients sur mesure.
Intégration de shortcode flexible : Placez le widget d'évaluation par étoiles n'importe où grâce au shortcode simple [stella_ratings] avec des paramètres personnalisés.
Adaptation intelligente au thème : S'adapte nativement et parfaitement au style, à la typographie, aux couleurs et aux modes clair/sombre de votre thème actif.
Garanties de confidentialité des avis : Contrôles de visibilité et cryptage d'e-mail intégrés pour protéger la vie privée des auteurs d'avis conformément aux réglementations.
Barre de résumé visuelle des notes : Affiche une superbe répartition des évaluations avec les pourcentages d'étoiles et la note moyenne globale.
Gestion granulaire des champs : Définissez des champs spécifiques comme obligatoires ou facultatifs pour guider les utilisateurs lors de la soumission de leur avis.
Chargement sélectif des ressources : Charge les scripts et les feuilles de style uniquement sur les pages où le widget d'avis est actif pour éviter tout ralentissement global du site.
Sécurité robuste contre le CSRF et le spam : Utilise les nonces WordPress et des contrôles de validation internes pour bloquer efficacement le spam.
Suivi spécifique aux produits : Associez facilement les notes à des clés uniques via les attributs du shortcode pour segmenter les avis par produit.

9. Activation des Fonctionnalités Pro

L'utilisation de la version Pro met à votre disposition des outils marketing à forte valeur ajoutée pour asseoir la réputation de votre marque. Voici les avantages Pro inclus :

Design premium Glassmorphism : Choisissez parmi des styles de mise en page modernes, de superbes modes sombres ou des grilles de type masonry.
Réponses officielles du propriétaire : Renforcez la confiance des clients en répondant publiquement aux avis positifs ou négatifs directement depuis le panneau d'administration.
Pièces jointes multimédias : Permettez aux utilisateurs de joindre des photos ou des vidéos de haute qualité à leurs avis pour présenter l'utilisation en situation réelle.
Système de vote d'utilité : Permettez aux visiteurs de voter pour ou contre un avis afin de faire remonter dynamiquement les retours les plus utiles.
Modification directe des avis : Autorisez les clients ou acheteurs enregistrés à mettre à jour, modifier ou corriger leurs évaluations précédemment soumises.
Approbation automatique des avis : Gagnez du temps en approuvant automatiquement les avis des clients vérifiés ou des utilisateurs connectés.
Filtrage avancé des avis : Permettez aux utilisateurs de trier et filtrer les avis par date, note la plus élevée, note la plus basse ou avis les plus utiles.
Rich Snippets Google Schema : Génère automatiquement des données structurées prêtes pour le SEO afin d'afficher les étoiles d'évaluation directement dans les résultats de recherche.
Intégration directe WooCommerce : Remplace ou améliore parfaitement le système d'avis natif de WooCommerce avec l'interface moderne de Stella.
Alertes de notification par e-mail : Informez instantanément les administrateurs du site par e-mail chaque fois qu'un nouvel avis est soumis.
Analyses historiques des notes : Visualisez des graphiques intuitifs dans le tableau de bord pour suivre l'évolution des notes et le volume des avis au fil du temps.
Licence pour site unique : À utiliser sur un seul site web de production avec mises à jour automatiques et support.
Licence multisite : À utiliser sur plusieurs sites web avec support prioritaire et mises à jour.

Comment mettre en place les options Pro

A. Notation par critères multiples

Évaluez vos services ou articles sur des points clés (ex. Qualité, Support technique, Livraison, Rapport qualité-prix).

Accédez au menu Stella Ratings > Réglages > Options Pro.
Cochez la case Activer la notation multi-critères.
Dans le champ Définir les critères, indiquez vos libellés séparés par des virgules (ex. Qualité, Prix, Support, Livraison).
Enregistrez. Les internautes bénéficieront de curseurs de notation individuels par critère et le tableau de bord calculera les moyennes par pôle d'activité.

B. Dépôt de fichiers multimédias (Images et Vidéos)

Offrez à vos prospects des avis de confiance illustrés par vos clients réels.

Quantité maximale autorisée : Définissez combien de fichiers un client peut joindre à son avis (ex. Max 5).
Taille limite de fichier : Fixez un plafond en Mégaoctets (ex. 5 Mo) pour préserver l'espace de votre serveur d'hébergement.
Formats de fichiers acceptés : Les filtres de sécurité autorisent les fichiers de type jpg, jpeg, png, webp pour l'image et mp4, mov, avi pour la vidéo. Un affichage dans une visionneuse dynamique (lightbox) s'ouvre au clic.

C. Données structurées Schema Google SEO

Cette option ajoute de façon transparente des portions de code JSON-LD dans les en-têtes de vos pages.

Activez l'option Schema de Note Globale (Aggregate Rating Schema) pour communiquer la moyenne globale de vos étoiles à Google.
Cochez la case Inclure les avis individuels dans le Schema pour transmettre également le texte complet des commentaires et le nom des auteurs.
Validez votre installation en insérant l'adresse de votre page web sur l'outil de test des résultats enrichis de Google (Rich Results Test).

D. Votes de pertinence des avis

Affiche des options interactives "Utile" ou "Inutile" sous chaque commentaire client. Le plugin réorganise automatiquement la liste pour positionner les avis constructifs les plus plébiscités en premier.

E. Réponses officielles de l'entreprise

Réagissez officiellement et publiquement aux retours de vos clients.

Ouvrez la table de modération globale de Stella Ratings.
Repérez l'avis client souhaité et cliquez sur le bouton Répondre.
Saisissez votre texte de réponse dans la fenêtre contextuelle AJAX puis enregistrez. Votre message apparaît imbriqué sous la note du client avec un badge distinctif de la direction.

F. Habillages visuels Premium

Affinez le design de votre site en choisissant un thème premium dans les options : **Glassmorphism** (effet verre translucide flouté), **Moderne Sombre** ou la disposition en **Grille Masonry** sous forme de cartes d'avis modernes.

10. Intégration Avancée WooCommerce

Stella Ratings and Reviews Pro est entièrement compatible avec WooCommerce. Cochez l'option Intégration directe WooCommerce dans vos réglages pour substituer automatiquement l'onglet natif de commentaires produits de WooCommerce par le widget dynamique et rapide de Stella.

Vérification d'achat automatique (Acheteurs Vérifiés)

Lorsqu'un utilisateur authentifié publie une note, Stella interroge l'historique des commandes WooCommerce pour cette personne. S'il s'avère qu'elle a effectivement commandé l'article, un **Badge d'Acheteur Vérifié** de couleur or s'accole à son nom sur le site internet, écartant toute suspicion de faux avis.

11. Rapports Statistiques & Analyses

Accédez au menu Stella Ratings > Analyses pour analyser les performances de satisfaction de votre site.

Indice de Satisfaction Client (CSAT) : Calcule la proportion de notes très positives (4 et 5 étoiles) par rapport au volume total.
Ratio d'Acheteurs Vérifiés : Représentation graphique détaillant la part des avis de clients réels face aux visites anonymes.
Tableau Leaderboard des contenus : Tableau synthétique récapitulant par page le volume de retours, la note moyenne et le taux de réponses de l'équipe.

12. Gestion des Données & Désinstallation

Soucieux de préserver un espace SQL impeccable, le plugin embarque des fonctionnalités de nettoyage automatisées.

Supprimer les données à la désinstallation : Lorsque vous cochez cette case, la suppression définitive de l'extension entraînera la suppression intégrale et irréversible de tous les avis clients, des bases SQL de votes, des réglages et des historiques de l'anti-spam. Laissez cette case vide si vous désactivez l'extension temporairement.

Stella Ratings and Reviews - Guide et documentation