Maîtrisez Maria Ratings grâce à ce guide d'installation et d'utilisation complet, couvrant tout, de la configuration de base à la protection antispam.

1. Exigences du système

PHP : Version 8.0 ou supérieure.
Extensions : json et mbstring sont obligatoires. Si vous choisissez MySQL/MariaDB pour le stockage, l'extension mysqli est également requise.
CAPTCHA (Pro) : Pour utiliser Cloudflare Turnstile ou Google reCAPTCHA v3, une connexion HTTPS sortante est requise (l'extension curl est préférable ; sinon allow_url_fopen doit être activé).
E-mails (Pro) : Une capacité SMTP sortante ou PHP mail() est requise pour la vérification double opt-in et les notifications.

2. Guide d'installation

Étape 1 : Téléchargement des fichiers

Extrayez l'archive Maria Ratings et téléversez l'intégralité du dossier sur votre hébergement Web via FTP, SFTP ou le gestionnaire de fichiers de votre panneau de contrôle.

Étape 2 : Exécution du programme d'installation

Accédez au fichier d'installation dans votre navigateur (par exemple : https://votresite.com/maria-ratings/install.php). L'installateur visuel vous guidera dans la création de votre compte administrateur.

Étape 3 : Choix du moteur de stockage

Lors de l'installation, vous devez choisir comment stocker vos avis :

Fichiers JSON : L'option la plus simple. Aucune configuration requise, idéal pour les petits sites. Assurez-vous que le dossier storage/ est accessible en écriture.
MySQL/MariaDB : Fortement recommandé pour la production et les sites à fort trafic. Vous devrez fournir votre hôte, nom de base, utilisateur, mot de passe et un préfixe de table.

Une fois l'installation terminée, vous pouvez vous connecter à votre panneau d'administration via /admin/.

3. Mise à niveau de Free vers Pro

Si vous passez de Maria Ratings Free à Pro, vous ne perdrez pas vos avis existants :

Téléversez les fichiers Pro et écrasez votre installation Free existante.
Important pour les utilisateurs JSON : Veillez à ne pas écraser votre répertoire storage/ existant, car il contient vos données.
Si vous utilisez MySQL/MariaDB, lancez simplement l'installateur Pro et connectez-vous avec les mêmes identifiants de base de données. Vos données seront reconnues automatiquement.

4. Intégration du widget d'avis

Pour afficher le widget sur votre site, placez l'extrait HTML suivant à l'endroit exact où vous souhaitez que les avis apparaissent :

<div data-maria-ratings data-product-key="votre-id-produit"></div>
<script src="https://votresite.com/maria-ratings/embed.js" defer></script>

Remarque : Remplacez votre-id-produit par un identifiant unique pour le produit ou la page évaluée.

5. Tableau de bord & Modération

Connectez-vous à votre tableau de bord (/admin/index.php) pour gérer vos avis. Vous pourrez :

Modérer les avis : Approuvez, rejetez ou supprimez les avis en attente.
Répondre aux clients (Pro) : Publiez des réponses directement sous les avis clients.
Exporter les données : Téléchargez un fichier CSV de tous vos avis.
Configurer les paramètres : Ajustez la limitation de débit, les mots bloqués, et les origines autorisées.

6. Guide détaillé des paramètres

Le panneau d'administration est divisé en plusieurs onglets. Voici ce que vous pouvez contrôler :

Paramètres généraux

Approbation automatique : Choisissez si les avis sont publiés immédiatement ou mis en attente. Vous pouvez également n'approuver que les avis 4 et 5 étoiles.
Avis par page : Contrôlez le nombre d'avis chargés initialement.
Ordre de tri : Définissez le comportement de tri par défaut (Plus récent, Plus ancien, Mieux noté, Moins bien noté).
Thème : Basculez entre les thèmes (Classique, Sombre, etc.) pour correspondre à votre site.
Origines autorisées : Saisissez les domaines exacts (ex. https://votresite.com) où votre widget est intégré pour empêcher les soumissions non autorisées.

Champs de formulaire & Messages

Visibilité et exigences : Prenez le contrôle total sur les champs Nom, E-mail et Site Web. Décidez s'ils sont affichés, obligatoires et publics.
Textes personnalisés : Personnalisez les textes des boutons, des étiquettes et des messages de réussite pour traduire le widget dans votre langue.

Spam & Sécurité (Free & Pro)

Limitation de débit IP : Limitez le nombre d'avis soumis à partir d'une même adresse IP dans un délai spécifique.
Un avis par e-mail : Empêchez les utilisateurs de soumettre plusieurs avis pour un même produit avec la même adresse e-mail.
Mots bloqués : Créez une liste de mots interdits. Les avis contenant ces mots seront automatiquement bloqués.

Fonctionnalités Pro & Intégrations

Si vous utilisez Maria Ratings Pro, vous avez accès à des configurations premium :

Téléchargements de médias : Autorisez les clients à télécharger des photos et des vidéos, en limitant le nombre et la taille des fichiers.
Évaluations multicritères : Définissez des métriques personnalisées (ex. Qualité, Prix) et demandez aux clients d'évaluer chacune d'elles.
Éditeur de texte enrichi : Un magnifique éditeur WYSIWYG permettant l'utilisation de texte en gras, italique et formaté.
Votes d'utilité : Permettez aux visiteurs de voter si un avis a été utile.
Badges vérifiés : Affichez un badge officiel "Vérifié" pour les utilisateurs confirmés.
Schéma SEO (JSON-LD) : Injectez automatiquement des données structurées pour que Google affiche les étoiles dans les résultats de recherche.
Configuration CAPTCHA : Sélectionnez Google reCAPTCHA v3 ou Cloudflare Turnstile pour bloquer les bots silencieusement.
Paramètres e-mail SMTP : Entrez vos identifiants SMTP pour envoyer de manière fiable les e-mails de vérification.
Notifications à l'administrateur : Recevez une alerte e-mail dès qu'un nouvel avis est soumis.
Vérification par e-mail (Double Opt-in) : Forcez les utilisateurs à vérifier leur e-mail via un lien automatisé avant que leur avis ne soit modéré.

7. Bonnes pratiques de sécurité

Avant de lancer votre système d'avis au public, assurez-vous que les mesures suivantes sont en place :

Origines autorisées : Définissez explicitement les noms de domaine autorisés. N'utilisez pas l'astérisque * en production.
Protéger le stockage JSON : Si vous utilisez le stockage JSON, vous devez bloquer l'accès Web direct au répertoire storage/. Les utilisateurs d'Apache sont protégés par le .htaccess inclus. Sur Nginx ou IIS, vous devez configurer vos règles serveur pour refuser l'accès.

Maria Ratings: Guide complet d'installation et d'utilisation