Avis sur les produits et la boutique : installation et aide

1. Téléversez et installez le ZIP de mprcomments via Modules > "Module Manager".
2. Cliquez sur "Configure", ou ouvrez Avis > Paramètres > Configuration.
3. Laissez "Enable Reviews" et "Product Reviews" activés. Vérifiez Modération requise et "Allow Guest Reviews".
4. Vérifiez les paramètres d'affichage, de photos et de notifications, puis cliquez sur Enregistrer.
5. Ouvrez un produit actif et utilisez son formulaire d'avis en tant que client. Envoyez une note et un texte d'avis.
6. Si la modération est activée, ouvrez Avis > Avis et approuvez l'avis en attente.
7. Rechargez le produit et vérifiez le contenu de l'avis, les étoiles et le badge de note aux emplacements où votre thème les affiche.

L'installation crée le schéma du module, les hooks, le menu d'administration, la configuration par défaut et le répertoire de téléversement modules/mprcomments/img/reviews/. Utilisez Avis > Paramètres > Intégrité si les identifiants de services facultatifs, les tables ou les hooks nécessitent une vérification.

Le formulaire porte le titre Paramètres des avis. Les paramètres sont regroupés dans Paramètres généraux, Types d'avis, Affichage, SEO & Anti-Spam, Notifications, Intégrations et Styles du thème.

Vous pouvez enregistrer des avis sur les produits, les catégories, les pages CMS et la boutique. Le formulaire fourni en boutique recueille les avis produit. Les autres types d’avis nécessitent un formulaire de collecte distinct ou une intégration.

Le nom et l'adresse e-mail d'un client connecté proviennent de son compte. Les invités doivent fournir les deux lorsque les avis invités sont autorisés. Un client connecté ne peut pas envoyer un autre avis non indésirable pour la même entité dans la même boutique.

L'outil de téléversement accepte les images JPEG, PNG et WebP. Il vérifie leur lisibilité, les redimensionne dans une limite de 1200 par 1200 pixels et crée des miniatures. Votre bibliothèque d'images PHP doit prendre en charge le format choisi, et le répertoire des images d'avis doit être accessible en écriture. Les limites PHP de téléversement et de POST peuvent imposer une limite inférieure au paramètre du module.

Après un test photo, vérifiez l'image dans l'avis publié. Un avis peut enregistrer son texte même si une pièce jointe est ignorée, car les fichiers invalides sont écartés lors du téléversement.

La vérification v3 exige une réponse réussie, un score d’au moins 0.5 et l’action submit_review. Ce formulaire ne comporte aucun champ de seuil. Configurez les deux clés avant d’activer le CAPTCHA. Avec v2, un avis peut être envoyé si la clé secrète ou la réponse du fournisseur est indisponible.

Lorsque la vérification est activée, le formulaire natif propose aussi Autre méthode : vérification par e-mail. Le client remplit son avis, choisit cette alternative et clique sur Recevoir un code de vérification par e-mail. Il saisit ensuite le code à huit chiffres et choisit Vérifier et envoyer l’avis. Le code est valable 10 minutes et autorise au maximum cinq vérifications. Un avis modifié nécessite un nouveau code. Le formulaire demande aux clients de sélectionner à nouveau les mêmes photos après avoir demandé un code.

L'alternative par e-mail fonctionne sans JavaScript. Elle nécessite un envoi d'e-mails PrestaShop fonctionnel et un état de vérification privé accessible en écriture dans le répertoire de cache de PrestaShop. Le module crée son répertoire de vérification avec les permissions 0700 et son fichier d'état avec 0600.

Les contrôles de contenu exigent au moins 10 caractères et une note de 1 à 5. Le formulaire fourni limite le titre à 255 caractères et le contenu à 5000 caractères. Les contrôles antispam rejettent aussi les URL trop nombreuses et certaines balises HTML.

Le schéma produit utilise uniquement les avis produit natifs approuvés. Les avis d'entreprise importés sont exclus des données structurées produit, même si vous les incluez dans le compteur d'un badge visible. Lorsque mprseorevolution est activé, ce module ignore sa propre génération de schéma produit. Vérifiez le balisage combiné de la page avec le test des résultats enrichis de Google ; c'est Google qui décide d'afficher ou non des résultats enrichis.

Utilisez la configuration habituelle des e-mails PrestaShop pour les notifications. Testez les e-mails de nouvel avis, d'approbation individuelle et de réponse. L'approbation en masse met directement à jour les statuts des avis et n'exécute pas le service de notification d'approbation individuelle.

Les rappels d’avis enregistrent la commande, le produit et le client pour les invitations en attente, en ignorant les rappels existants et les produits déjà évalués. Le cron fourni synchronise uniquement les avis externes. Le module n’envoie pas d’e-mails de rappel, quels que soient le commutateur de rappel et le délai.

Ouvrez Avis > Avis. Filtrez la liste par statut ou entité selon vos besoins. Vous pouvez approuver, rejeter, marquer comme indésirable, supprimer les avis et y répondre. Les actions groupées comprennent Approuver la sélection, Rejeter la sélection et Supprimer la sélection. La suppression n'est pas un changement de statut réversible.

Utilisez une réponse publique pour le texte que vous souhaitez afficher sous l'avis. L'envoi de l'e-mail de réponse est tenté lorsqu'il est activé et que l'avis contient une adresse e-mail client.

Ouvrez Avis > Critères pour créer des noms de critères traduits. Définissez le type d'entité, l'état actif et la position. Les critères peuvent s'appliquer à tous les types ou aux avis produit, catégorie, CMS ou boutique. Pour les nouveaux critères, le modèle utilise l'état actif, le type tous et la position 0. Vérifiez la liste des critères dans le formulaire produit après l'enregistrement.

La vérification d'achat utilise une commande valide contenant le produit. Ce n'est pas un libellé de vérification d'e-mail invité. Le module ne fournit pas d'écran de compte client pour modifier les avis envoyés. Gérez les modifications d'avis avec les outils du back-office.

Utilisez Paramètres des avis > Intégrations pour les identifiants et l'affichage. Avis > Avis externes liste les enregistrements importés. Ce sont des avis sur l'entreprise, pas des avis natifs sur le produit concerné.

Trustpilot

Pour la synchronisation API, activez Trustpilot, saisissez la clé API et "Business Unit ID", enregistrez, puis cliquez sur Synchroniser maintenant dans Statut des avis externes. Lisez les nombres d'avis récupérés/nouveaux et les erreurs du fournisseur. Le contrôle actuel des prérequis exige la clé et "Business Unit ID", pas le secret API.

Pour importer un CSV, activez Trustpilot et enregistrez pour faire apparaître Importation CSV Trustpilot. Choisissez le CSV et cliquez sur Importer. Les en-têtes obligatoires acceptent les variantes suivantes :

referenceId: referenceId, id, reviewId, reference_id
stars: stars, rating, star
createdAt: createdAt, created_at, date, datePublished

En-têtes facultatifs :

text: text, content, review, reviewText, body
title: title, heading
consumer.displayName: consumer.displayName, consumerDisplayName, author, name, consumer_name
language: language, lang, locale

Le parseur lit les CSV séparés par des virgules avec une ligne d'en-tête et accepte un BOM UTF-8. Les identifiants d'avis et des notes de 1 à 5 sont obligatoires pour les lignes importées.

Google Business Profile

Saisissez les identifiants, enregistrez et utilisez Synchroniser maintenant. Le module signe un JWT, demande un jeton d'accès, puis lit les avis du compte et de l'établissement. Vous avez besoin de PHP OpenSSL, de cURL, d'un HTTPS fonctionnel et d'un accès API pour ces identifiants, et le compte de service doit avoir accès à cet établissement. Lisez les erreurs de synchronisation avant de vous fier à cette intégration.

Affichage des avis d'entreprise

Il n'existe actuellement aucun champ "Lazy-load Company Reviews on Product Pages". Lorsqu'un produit n'a pas d'avis natifs mais que des avis d'entreprise sont affichés, le titre de l'onglet les identifie comme Avis sur l’entreprise, avec leur nombre. Les avis produit natifs conservent leur propre sens et leur propre compteur.

Planifier la synchronisation externe

Le panneau d’état affiche une URL cron uniquement si un jeton de synchronisation est configuré. Le jeton est vide par défaut. Le module ne le génère pas automatiquement et ne propose aucune commande pour le créer. Utilisez Synchroniser maintenant si votre installation n’a aucun jeton configuré.

Lorsque votre installation fournit un jeton, utilisez l'URL affichée :

https://example.com/module/mprcomments/cron?token=YOUR_EXT_CRON_TOKEN&action=sync

Le point d'accès renvoie du JSON pour la boutique de la requête. Lisez le résultat de chaque fournisseur, car le succès global ne signifie pas que chaque fournisseur a importé. Gardez le jeton privé. Ce cron sert uniquement à synchroniser les avis externes.

Les pages produit modernes utilisent displayProductExtraContent. PrestaShop antérieur à 1.7 dispose des gestionnaires displayProductTab et displayProductTabContent. Votre thème doit afficher les hooks appropriés.

Pour les étoiles dans les listes, un développeur peut utiliser :

{hook h='displayProductListReviews' product=$product}

Les gestionnaires du badge sont displayProductAdditionalInfo et displayMprProductFunctionalButtons. Choisissez l'emplacement approprié dans votre thème et vérifiez l'absence de doublons lors de la personnalisation :

{hook h='displayProductAdditionalInfo' product=$product}
{hook h='displayMprProductFunctionalButtons' product=$product}

Le formulaire envoie action=submitReview, le type/l'identifiant de l'entité, la note, le titre, le contenu, les champs criterion_{id} et éventuellement review_images[]. Il a aussi besoin du token de la session en cours. Utilisez le formulaire fourni ou son URL générée ; l'ancien exemple de données sans jeton de session n'est pas un formulaire d'envoi complet.

Le portail public utilise la route reviews, normalement /reviews avec les URL simplifiées et le préfixe de langue/boutique approprié. Il liste les avis approuvés. Seule sa première vue non filtrée contenant des avis est destinée à être indexable. Les variantes paginées, filtrées et vides utilisent une politique noindex. Exemples à la racine :

/reviews: index, follow when it has content
/reviews?page=2: noindex, follow
/reviews?type=product: noindex, follow

Le module expose la racine du portail aux générateurs de sitemap compatibles. Les données structurées produit restent distinctes des avis d'entreprise importés affichés sur le portail.

Dans Styles du thème, utilisez les valeurs détectées du thème et les commandes de style partagées. Les valeurs par défaut propres aux avis sont :

Pour le CSS du thème, vous pouvez utiliser :

.mprcomments-container {
  --mprcomments-star: #ffb400;
  --mprcomments-star-empty: #d8d8d8;
  --mprcomments-verified: #1f9d55;
  --mprcomments-radius: 8px;
}
.mprcomments-review__reply {
  border-left: 3px solid var(--mprcomments-primary);
}
.mprcomments-badge__link {
  text-decoration: none;
}
.mprcomments-external__title {
  margin-top: 1.5rem;
}

L’export GDPR renvoie les champs d’avis d’un client. Une demande de suppression GDPR anonymise son nom, son e-mail et son identifiant client dans les avis liés et supprime ses votes d’utilité et ses signalements. Le contenu des avis et les adresses IP restent enregistrés. Le masquage des noms affichés est un réglage d’affichage distinct.

Testez la modération avec un avis en attente, puis approuvez-le et vérifiez son affichage public. Testez une réponse publique, un e-mail de notification, une photo valide et un vote utile depuis un compte client connecté.

Si l'envoi échoue, vérifiez les autorisations des invités, les restrictions de doublons, la longueur minimale du texte, l'intervalle par IP, le jeton de session en cours et le CAPTCHA ou la vérification par e-mail. Si les codes e-mail échouent, vérifiez la distribution des e-mails, l'expiration du code, les modifications de l'avis/des photos et l'état privé du cache accessible en écriture.

Si les photos manquent, inspectez les limites de téléversement PHP, les droits d'écriture sur img/reviews, la prise en charge du format d'image et la pièce jointe réellement publiée. Si les étoiles sont absentes, vérifiez l'approbation, le nombre d'avis natifs, les commutateurs d'affichage et les hooks du thème. Si les avis externes sont absents, vérifiez les fournisseurs activés, les identifiants, les compteurs des sources, les erreurs de Synchroniser maintenant et "Show Company Reviews on Product Pages".

Si le schéma est absent, vérifiez les avis produit natifs approuvés, "Enable Schema.org Markup" et si mprseorevolution gère la génération du schéma. Si les rappels ne partent pas, le module actuel ne crée que leur file d'attente. Ajouter le cron de synchronisation externe ne fournit pas d'expéditeur.

Désactivez "Enable Reviews" pour arrêter l'affichage normal des avis. Désactivez séparément la planification de synchronisation externe si vous l'avez configurée. Exportez les données nécessaires avant la désinstallation. La désinstallation supprime la configuration du module et les tables du schéma, y compris les avis enregistrés et les données liées. La méthode de désinstallation ne supprime pas explicitement le répertoire img/reviews ni les fichiers de cache de vérification ; vérifiez les fichiers résiduels si vous retirez complètement le module.

Nécessite PrestaShop 1.6.1 ou une version ultérieure et PHP 7.1 ou une version ultérieure.