WB Reviews
Notes par étoiles et avis modérés pour les articles et les pages.
Extension
WB Reviews
Notes par étoiles et avis modérés pour les articles et les pages.
Description
WB Reviews ajoute des notes par étoiles et des avis modérés aux articles et aux pages. Les visiteurs lisent la moyenne, la répartition des étoiles et les avis écrits. Les membres ou les invités laissent un avis par page. Vous approuvez ce qui est mis en ligne.
Ce que vous obtenez
- Des notes sur n’importe quel contenu. Cochez par leur nom les types de contenu propres à votre site. Rien n’est lié aux articles.
- Avis écrits et étoiles seules. Le texte est facultatif. Une note composée uniquement d’étoiles compte dans la moyenne et n’apparaît pas dans la liste.
- Membres ou tout le monde. Les invités indiquent un nom (et un e-mail si vous le demandez). Les avis des invités attendent toujours une approbation. Un avis par visiteur.
- Modération. Pages En attente et Publiés, recherche par texte, et suppression des avis d’un invité par e-mail.
- Réponse du propriétaire. Une réponse publique sous un avis, rédigée dans l’administration.
- Moteurs de recherche. La note est ajoutée à la page sous forme de données structurées.
- Une carte de tableau de bord pour ce qui est en attente, plus un e-mail horaire facultatif sans texte d’avis et sans lien.
Comment tout s’articule
Le plugin est le moteur : routes, stockage et écrans d’administration. Un plugin EmDash ne peut pas ajouter de pages à votre site ; les écrans publics sont donc fournis sous forme de kit de site que vous copiez une seule fois. Voir Installation.
Les avis ne sont pas les commentaires du cœur. Les commentaires restent destinés à la conversation. Ce plugin ajoute une note, une entrée par personne, une moyenne, une répartition en barres et une réponse du propriétaire.
Installation
Avant d’installer
1. Votre site a besoin d’un exécuteur de bac à sable. Les plugins du registre s’exécutent dans un bac à sable. Tant que le site n’en a pas, Admin, Plugins affiche « No plugins configured » et il n’y a pas de Registry dans le menu.
- Node : dans votre site, exécutez
npm install @emdash-cms/sandbox-workerd workerd, puis ajoutezsandboxRunner: "@emdash-cms/sandbox-workerd/sandbox",dansemdash()au sein deastro.config.mjs. - Cloudflare : ajoutez
import { sandbox } from "@emdash-cms/cloudflare";etsandboxRunner: sandbox(),. Il faut l’offre Workers Paid, la liaisonworker_loadersnomméeLOADER(décommentez-la dans votre configuration Wrangler) et un bucket R2 en tant questorage: r2(...), sans quoi l’installation s’arrête avec « Storage error while installing plugin ». Exécutez ensuitenpm run deploy.
Arrêtez le serveur de développement et relancez-le. Registry apparaît désormais dans le menu d’administration.
2. Le plugin est le moteur. Les pages visiteurs viennent de son kit de site. Un plugin du registre ne peut pas ajouter de pages à votre site. Tant que vous n’avez pas copié le kit, ses adresses (par exemple /account/reviews/) affichent la page 404 de votre site. C’est normal. La copie du kit ci-dessous tient en une commande.
Vérifié sur EmDash 1.3.1 avec le modèle blog, sur Node et sur Cloudflare Workers (installation depuis le registre).
Installer
-
Admin, Registry, recherchez WB Reviews, Install, puis acceptez les autorisations.
-
Depuis le dossier racine de votre site :
kit="$(mktemp -d)" && git clone --depth 1 \ --branch v0.3.0 \ https://github.com/wbcomdesigns/emdash-reviews \ "$kit/emdash-reviews" && "$kit/emdash-reviews/scripts/add-to-site.sh" . -
Collez les lignes affichées. Redémarrez le serveur de développement.
-
Ajoutez le lien de menu affiché dans Admin, Menus.
-
Ouvrez Reviews, Waiting.
Après chaque mise à jour, exécutez l’étape 2 avec la nouvelle balise.
Guide : https://github.com/wbcomdesigns/emdash-reviews/blob/v0.3.0/docs/website/getting-started/install.md
FAQ
Pourquoi n’y a-t-il pas de bloc d’avis après l’installation ? Le plugin ne peut pas ajouter de pages ni de CSS. Copiez les composants du kit de site dans vos modèles, puis rechargez.
Pourquoi n’y a-t-il pas de formulaire d’avis sur une page ? Ce type de contenu n’est pas coché sous Admin → Reviews → Settings. Cochez-le, sinon le formulaire reste masqué.
Les invités peuvent-ils écrire un avis ? Oui, lorsque Settings indique que tout le monde peut donner un avis. Un invité indique un nom, et un e-mail si vous en demandez un. Les avis des invités attendent toujours une approbation.
Les nouveaux avis sont-ils mis en ligne immédiatement ? Seulement ceux des membres, et seulement si vous désactivez l’approbation. Lorsqu’elle est activée, ce qui est le réglage par défaut, un avis attend que vous l’approuviez. Une modification d’un avis en ligne attend aussi ; le texte publié reste en place jusqu’à ce que vous approuviez la modification.
Qu’est-ce qu’une note composée uniquement d’étoiles ? Des étoiles sans texte. Elle compte dans la moyenne et dans les barres, et n’apparaît pas dans la liste des avis écrits.
Envoie-t-il des e-mails ? Au plus un court avis par heure lorsque des avis sont en attente, et seulement si vous l’activez et que le site dispose d’un service de messagerie (le plugin officiel Resend). L’avis ne contient ni texte d’avis ni lien.
Existe-t-il une version payante ? Non. Tout ce qui est ici est gratuit.
Journal des modifications
0.3.0
- Amélioration : chaque page, action d’administration et requête de visiteur respecte la limite de Cloudflare de 10 requêtes par appel de plugin. Les compteurs évoluent avec chaque avis au lieu de relire tous les avis de la page.
- Amélioration : les pages En attente et Publiés sont paginées par date ; Find parcourt quelques centaines d’avis par pression. Delete all my reviews et la suppression par e-mail fonctionnent par étapes.
- Correctif : les avis envoyés au même instant sont comptés chacun une fois. Les notes perdues par la 0.2.0 sont reconstruites.
- Après la mise à jour, ouvrez Reviews dans l’administration : il reprend les données de la 0.2 en quelques étapes pendant que vous continuez à modérer. Aucune nouvelle autorisation.
Copiez à nouveau le kit après la mise à jour, depuis le dossier racine de votre site :
kit="$(mktemp -d)" &&
git clone --depth 1 \
--branch v0.3.0 \
https://github.com/wbcomdesigns/emdash-reviews \
"$kit/emdash-reviews" &&
"$kit/emdash-reviews/scripts/add-to-site.sh" .
0.2.2
- Correctif : relancer scripts/add-to-site.sh sur un site dont la page d’article et la carte d’article affichent déjà WB Reviews indique que les lignes sont déjà en place.
0.2.1
- Sécurité : les invités ne donnent leur avis que là où l’hébergeur transmet l’adresse du visiteur (Cloudflare ou trustedProxyHeaders) ; sinon ils se connectent. L’IPv6 est comptée par /64.
- Nouveau : Waiting affiche Set up visitor pages. scripts/add-to-site.sh copie le kit et affiche les lignes à coller.
- Correctif : les avis en attente ne masquent plus les avis publiés et ne faussent plus la note ; les pages non publiées n’affichent rien.
Versions antérieures : https://github.com/wbcomdesigns/emdash-reviews/blob/main/CHANGELOG.md