Boutique — Avis produits — documentation Sillon

Ce qu'il fait

Avis produits avec notes, photos et modération : note globale (ou moyenne de sous-notes que vous nommez), badge « achat vérifié » calculé depuis une commande payée, avis d'invité (pseudo + e-mail jamais publié), trois modes de modération dont « le premier avis d'un client est relu, les suivants passent seuls », photos ré-encodées sans EXIF, réponse publique du marchand, et e-mail de demande d'avis après la commande.

Note globale, ou des sous-notes que vous nommez (goût, livraison…)
Badge « achat vérifié » calculé depuis une commande payée, jamais déclaratif
Trois modes de modération, dont « le premier avis est relu, les suivants passent seuls »
Photos ré-encodées sans données cachées (EXIF)
Réponse publique du marchand, e-mail de demande d'avis après la commande

Ses réglages

Ils se modifient depuis l'administration. La clé est donnée pour qui pilote le site en ligne de commande ou par l'API.

Réglage	Clé	Type	Par défaut
Avis produits activés	`avis.enabled`	bool	`oui`
Qui peut déposer un avis (buyers\|all)	`avis.who`	string	`buyers`
Modération (direct\|always\|trust_after_first)	`avis.moderation`	string	`trust_after_first`
Autoriser les photos dans les avis	`avis.photos`	bool	`oui`
Photos maximum par avis	`avis.photos_max`	int	`3`
Demander un avis N jours après la commande (0 = jamais)	`avis.request_delay_days`	int	`0`

Ce qu'il suppose

Ce module a besoin de :

shop ^1.55

Piloter par une IA

Ce que ce module sait faire quand on le lui demande en langage naturel, et ce que chaque action engage.

avis lecture seule

Les avis produits, l'attente de relecture d'abord : produit, note (et sous-notes), titre, texte, pseudo de l'auteur (jamais son e-mail), badge « achat vérifié », nombre de photos, réponse du marchand, dates. Filtre par statut (pending, published, rejected, all). 50 au plus par appel, `suite` donne l'offset suivant.

« quels avis attendent ma relecture ? » « que disent mes clients du dernier produit ? »
moderer confirmation demandée

Publie ou refuse un avis produit (les deux boutons de l'écran de modération). Publier le rend public sur la fiche du produit. Un avis AVEC photos ne se refuse pas d'ici : refuser efface ses photos définitivement, ce geste se fait à l'écran. Confirmation demandée.

« publie l'avis 8 » « refuse cet avis, il est hors sujet »

Ses points de branchement

Pour greffer du code sans toucher au module : ce qu'il annonce, et ce qu'il écoute.

Ce qu'il annonce 1

shop.review.submitted: Event — un avis vient d'être déposé (déjà persisté, statut résolu). Args: [array $review]

Ce qu'il écoute 7

shop.produit.donnees: priorité 10
dashboard.blocs: priorité 50
shop.review.submitted: priorité 10
shop.hub.tiles: priorité 40
admin.alerts: priorité 50
emails.catalogue: priorité 35
emails.apercu: priorité 10

Ses prises front

Les morceaux de page que ce module fournit, et les classes qu'ils posent. Un thème les habille par ces classes : il ne recopie pas le balisage, sinon il rate les corrections des versions suivantes.

views/avis.php 31 classes

s-shop-avis
s-shop-avis-actions
s-shop-avis-aide
s-shop-avis-aucun
s-shop-avis-auteur
s-shop-avis-champ
s-shop-avis-critere
s-shop-avis-critere-champ
s-shop-avis-date
s-shop-avis-envoyer
s-shop-avis-erreur
s-shop-avis-etoile
s-shop-avis-formulaire
s-shop-avis-hp
s-shop-avis-input
s-shop-avis-interdit
s-shop-avis-item
s-shop-avis-liste
s-shop-avis-merci
s-shop-avis-moyenne
s-shop-avis-note
s-shop-avis-note-acces
s-shop-avis-note-champ
s-shop-avis-photos
s-shop-avis-photos-champ
s-shop-avis-reponse
s-shop-avis-sousnotes
s-shop-avis-textarea
s-shop-avis-texte
s-shop-avis-titre
s-shop-avis-verifie

Ses données

Les tables que ce module crée. Désactiver un module ne les efface pas : ses données restent en base et reviennent s'il est réactivé.

Les tables 5

shop_review_criteria
shop_review_photos
shop_review_ratings
shop_review_requests
shop_reviews