Ecommerce Product Reviews

Über

Dieses Plugin fügt eine Reviews-Collection und zwei aggregierte Rating-Felder zu einem Shop hinzu, der mit `@payloadcms/plugin-ecommerce` arbeitet. Die Products-Collection erhält die Felder `ratingAverage` und `ratingCount`, eine neue `reviews`-Collection speichert die zugehörigen Einträge. Jede Bewertung verweist auf ein Produkt, enthält einen Rating-Wert zwischen 1 und einem konfigurierbaren Maximum sowie Titel, Text, Name und E-Mail-Adresse der Person. Zusätzlich gibt es ein Flag `verifiedPurchase` und einen Status mit den Werten pending, approved oder rejected. Das Flag für verifizierte Käufe wird berechnet und nicht selbst angegeben. Bei jedem Schreibvorgang führt das Plugin eine Count-Query gegen die Orders-Collection aus. Gesucht wird nach einer Bestellung mit einem Status aus den konfigurierten `purchaseStatuses` (standardmäßig `processing` und `completed`), die das bewertete Produkt enthält und zur bewertenden Person gehört, entweder über die `customer`-Beziehung oder die `customerEmail`. Stornierte und erstattete Bestellungen fließen nicht ein. Die aggregierte Bewertung wird nie inkrementell angepasst. Bei jedem Erstellen, Ändern oder Löschen einer Bewertung zählen die `afterChange`- und `afterDelete`-Hooks die Bewertung des Produkts aus den freigegebenen Einträgen neu berechnen. Der Rebuild-Endpunkt recounts jedes Produkt und akzeptiert einen Bearer-Secret für unbeaufsichtigte Aufrufe. Lesen ist öffentlich, aber eingeschränkt: Wer die Admin-Access-Regel nicht erfüllt, sieht über REST, GraphQL oder die Local API ausschließlich approved Reviews. Erstellen ist standardmäßig offen, Ändern und Löschen sind auf die Admin-Regel beschränkt. Eine abgebende Person kann ihre eigene Bewertung nicht freigeben oder das Verified-Flag selbst setzen. Konfigurierbar sind die Access-Regeln, Field- und Collection-Slugs, Maximallängen (Titel 120, Text 4000, Name 80), die Rating-Skala (`maxRating`, Standard 5), `oneReviewPerCustomer` (Standard true), `startingStatus`, `rebuildEndpointPath`, `rebuildSecret`, `disabled` und `writeAggregate`. Das Plugin muss nach `ecommercePlugin` registriert werden, damit die Produktfelder existieren.

Paketinformationen

Paketname

payload-reviews

Neueste Version

1.0.1

Entpackte Größe

39 kB

Lizenz

MIT

Wöchentliche Downloads

2

Zuletzt veröffentlicht

21. Aug. 2026