Handbuch Kundenbewertungen.

Installation, Regeln je Feld, Geltungsbereich, Darstellung im Storefront und eigene Fehlermeldungen. Stand Version 1.0.12.

Systemvoraussetzungen

Shopware 6.7. Das Plugin legt keine eigenen Datenbanktabellen an, die Einstellungen liegen in der Systemkonfiguration von Shopware.

Was das Plugin ersetzt: Shopware prüft eine Bewertung fest verdrahtet gegen Titel ab 5 Zeichen und Kommentar ab 40 Zeichen, beides Pflicht. Genau diese Prüfung wird durch deine eigenen Regeln ersetzt.

Installation

Das ZIP im Shopware-Admin unter Erweiterungen, Meine Erweiterungen hochladen, danach installieren und aktivieren. Nach der Aktivierung leert das Plugin den Cache selbst.

Nach dem Aktivieren gilt zunächst der Shopware-Standard. Erst wenn du die Regeln einschaltest und speicherst, greifen eigene Werte.

Das Admin-Modul

Der Menüpunkt heißt Kundenbewertungen und liegt unter Erweiterungen, Stone & Water - Plugin Suite. Die Seite ist in Abschnitte gegliedert: Geltungsbereich, Allgemein, Titel der Bewertung, Kommentar, Sternebewertung, Darstellung im Shop und Eigene Fehlermeldungen.

Oben rechts liegt der Speichern-Knopf. Änderungen greifen sofort nach dem Speichern, ein Cache-Lauf ist nicht nötig.

Geltungsbereich

Über die Auswahlliste bestimmst du, für wen die Werte darunter gelten.

Alle Verkaufskanäle (Standard)
Die Werte gelten für jeden Kanal, der keine eigenen Werte hat.
Einzelner Verkaufskanal
Nur dieser Kanal wird bearbeitet. Beim Speichern erhält er eigene Werte.
Auf Standard zurücksetzen
Erscheint, sobald ein Kanal eigene Werte hat. Entfernt sie wieder, danach erbt der Kanal den Standard.

Unter der Auswahl steht, ob der gewählte Kanal gerade eigene Werte hat oder den Standard erbt. So ist immer klar, was ein Speichern bewirkt.

Regeln ein- und ausschalten

Der Schalter Eigene Regeln aktiv entscheidet, ob das Plugin überhaupt eingreift. Ist er aus, verhält sich der Shop exakt wie ohne Plugin: Titel mindestens 5 Zeichen, Kommentar mindestens 40 Zeichen, beides Pflicht.

Zum Testen: Schalte die Regeln je Kanal ein und beobachte die Zahl der Bewertungen über zwei Wochen. Der Schalter bringt dich jederzeit ohne Datenverlust zurück auf den Ausgangszustand.

Titel

Pflichtfeld
Muss ein Titel eingegeben werden?
Mindestzeichen
Untergrenze für den Titel. 0 bedeutet keine Grenze.
Maximalzeichen
Obergrenze für den Titel. Höchstens 255, das ist die Größe des Datenbankfeldes.

Ist der Titel kein Pflichtfeld und bleibt leer, wird die Bewertung ohne Titel gespeichert. Shopware zeigt sie im Storefront dann ohne Überschrift an.

Kommentar

Pflichtfeld
Muss ein Kommentar eingegeben werden?
Mindestzeichen
Untergrenze für den Kommentar. 0 bedeutet keine Grenze. Der Shopware-Standard liegt bei 40.
Maximalzeichen
Obergrenze für den Kommentar. 0 bedeutet keine Grenze, technisch sind bis zu 60.000 Zeichen möglich.

Der Kommentar ist die Stellschraube mit der größten Wirkung. Wer die Untergrenze von 40 auf 10 senkt, senkt die Hürde spürbar, ohne dass die Bewertungen wertlos werden.

Sternebewertung

Pflichtfeld
Muss eine Sternebewertung abgegeben werden?
Minimale Sterne
Kleinster zulässiger Wert, zwischen 1 und 5.
Maximale Sterne
Größter zulässiger Wert, zwischen 1 und 5.
Zur Einordnung: Im Standard-Template ist immer schon ein Stern vorausgewählt. Eine Bewertung wird deshalb praktisch immer mitgeschickt, unabhängig von dieser Einstellung.

Darstellung

Hinweistext unter dem Feld
Zeigt am Formular an, wie viele Zeichen erwartet werden.
Zeichenzähler
Zeigt die aktuelle Zeichenzahl und färbt sie rot, solange die Mindestlänge nicht erreicht ist.

Ist ein Feld kein Pflichtfeld, steht im Hinweistext zusätzlich Optional. vor der Zeichenangabe. Dieser Vermerk erscheint auch dann, wenn die Zeichenhinweise abgeschaltet sind - der Kunde soll in jedem Fall erkennen, was freiwillig ist.

Eigene Fehlermeldungen

Für sieben Fälle lässt sich ein eigener Text hinterlegen, jeweils in Deutsch und Englisch: Titel fehlt, Titel zu kurz, Titel zu lang, Kommentar fehlt, Kommentar zu kurz, Kommentar zu lang und Sternebewertung fehlt.

Bleibt ein Feld leer, verwendet Shopware seine eigene Meldung. Welche Sprache greift, richtet sich nach der Sprache der Storefront, nicht nach der Adminsprache.

Lizenz

Die Direct-Fassung prüft die Freischaltung gegen unsere Lizenzplattform. Der Schlüssel kommt aus der Plugin Suite, eine eigene Eingabe im Modul gibt es nicht. Freigeschaltet wird über den Schlüssel, über die gebuchte Shop-Domain oder über eine laufende Testphase.

Ohne gültige Lizenz: Der Shop läuft normal weiter. Es greift dann der Shopware-Standard, die eigenen Regeln bleiben schlicht aus. Es gibt keine Sperre und keine Fehlermeldung im Storefront.

Ist der Lizenzserver einmal nicht erreichbar, bleibt der zuletzt bekannte Stand bestehen. Eine geplante Aufgabe frischt den Stand einmal täglich auf.

Problemlösung

Die Regeln greifen nicht

Prüfe zuerst den Schalter Eigene Regeln aktiv im richtigen Geltungsbereich. Die Einstellungen gelten je Verkaufskanal, ein Kanal ohne eigene Werte erbt den Standard.

Der Menüpunkt fehlt

Nach dem Update einmal bin/console assets:install und bin/console cache:clear ausführen, danach den Admin hart neu laden. Das Adminmodul liegt in einem eigenen Bundle, dessen Dateiname sich mit jeder Version ändert.

Der Hinweistext erscheint nicht

Der Hinweis steht unter dem Feld und stammt aus dem Bewertungsformular. Überschreibt dein Theme die Blöcke des Formulars vollständig, statt sie zu erweitern, wird der Hinweis nicht ausgegeben. Die serverseitige Prüfung bleibt davon unberührt.

Eine Bewertung wird trotz Regel abgelehnt

Prüfe Mindest- und Maximalwert auf Widerspruch, etwa Mindestzeichen 50 bei Maximalzeichen 40. Das Plugin speichert solche Kombinationen nicht, ältere Werte aus einer früheren Version können aber noch vorliegen.

Support

Fragen, Fehlermeldungen und Wünsche gehen an info@stoneandwater.online. Im Adminmodul liegt oben rechts der Knopf Feature anfragen, der eine vorbereitete Mail öffnet.

Verfügbarkeit

Das Plugin gibt es direkt bei uns. Preise und Bezug stehen auf der Produktseite.