FAQ

Kundenfreundliche
Produktbewertungen

Dokumentation für Shopware 6 · Stand: Plugin-Version 3.3.0

Funktionen

Das Plugin holt aktiv Produktbewertungen von Ihren Kunden ein und macht das Bewerten so einfach wie möglich. Es unterstützt folgende Funktionen:

  1. DSGVO-konformer Opt-In im Bestellvorgang
  2. Automatischer konfigurierbarer Versand von Bewertungseinladungen per E-Mail
  3. Kundenfreundliche Bewertung aller Produkte aus der Bestellung auf einer ansprechend gestalteten Seite, die sich auch auf dem Smartphone gut bedienen lässt – mit Sterne-Legende von „mangelhaft“ bis „sehr gut“, optionaler Überschrift und der Möglichkeit, den eigenen Namen zu anonymisieren
  4. Kunden können für eine Bewertung mit Gutscheinen belohnt werden
  5. Opt-In pro Sales Channel steuerbar (z.b. für nicht-EU-Länder)
  6. Viele Ausschlusskriterien: Zahlungsarten, Versandarten, Kundengruppen, Bearbeitungszeit, einzelne Produkte
  7. Bewertungsbuttons im Kundenkonto: Kunden können ihre Bestellungen auch direkt aus dem Konto heraus bewerten
  8. Benachrichtigung für den Shop bei neuen (z.b. schlechten) Bewertungen
  9. E-Mail-Blacklist Zusatzfeature – einzelne E-Mail-Adressen oder ganze Domains, die keine Bewertungseinladung mehr erhalten sollen (siehe hier)

Ablauf einer Einladung

Der Weg einer Bewertungseinladung sieht so aus:

  1. Ein Kunde bestellt und die Bestellung erhält den Versandstatus „versendet“.
  2. Es beginnt eine Wartezeit (Einstellung Bewertungsfrage X Tage nach Versand, Standard: 21 Tage). So bekommt der Kunde die Ware, bevor er zur Bewertung eingeladen wird.
  3. Ein im Hintergrund laufender geplanter Task (Scheduled Task) prüft regelmäßig, welche Bestellungen fällig sind, und verschickt die Einladungs-E-Mail. Wenn Sie das Add-On "Mail Blacklist für Bewertungseinladungen" erworben haben, wird optional vor dem Versand die Empfängeradresse gegen die Blacklist geprüft; bei einem Treffer entfällt der Versand.
  4. Der Kunde klickt auf den Link und landet auf der Bewertungsseite mit allen Artikeln seiner Bestellung.
  5. Optional: Nach der Bewertung wird ein Gutschein / eine Danke-Mail versendet.
  6. Optional: Sie als Shop erhalten eine Benachrichtigung über die neue Bewertung.
Wichtig: Der Versand läuft nicht in Echtzeit, sondern über Shopwares geplante Aufgaben (Scheduled Tasks) und die Mail-Warteschlange (Message Queue). Beide müssen auf dem Server aktiv sein, damit E-Mails tatsächlich rausgehen.

Der Weg zur ersten Bewertung

Das Plugin ist so konfiguriert, dass es nach der Installation zunächst noch nichts macht. Sie können es erst aktivieren und dann in Ruhe einrichten. Wir empfehlen folgende Vorgehensweise:

  1. Aktivieren Sie in den Plugin-Einstellungen die Opt-In-Funktion im Checkout
  2. Prüfen Sie, ob die Checkbox im Bestellabschluss korrekt dargestellt wird, passen Sie bei Bedarf den Textbaustein an und machen Sie eine Testbestellung
  3. Lassen Sie sich eine Testmail zukommen
  4. Klicken Sie auf den Link in der Testmail und prüfen Sie, ob die Bewertungsseite in Ihrem Shop korrekt dargestellt wird
  5. Passen Sie die E-Mail-Templates für die Bewertungseinladung an
  6. Optional: Wenn Sie Bewertungen mit Gutscheinen belohnen möchten, legen Sie eine Aktion mit individuellen Aktionscodes an. Diese muss aktuell gültig und einem Saleschannel zugewiesen sein. Wählen Sie die Aktion dann in den Plugin-Einstellungen aus.
  7. Prüfen Sie die Zeitfenster für den Versand (Bewertungsfrage X Tage nach Versand, Bestellungen älter als X ignorieren) – so werden bei der Ersteinrichtung keine Altbestellungen angeschrieben
  8. Aktivieren Sie in den Plugin-Einstellungen den E-Mail-Versand

Konfiguration

Die Einstellungen finden Sie im Adminbereich unter Einstellungen > Erweiterungen > Kundenfreundliche Artikel Bewertungen (bzw. über das Kontextmenü des Plugins > Konfiguration). Die Optionen sind in mehrere Bereiche gegliedert.

Prüfen Sie die Einstellungen bei Bedarf pro Verkaufskanal – Shopware erlaubt abweichende Werte je Verkaufskanal.

Plugin testen

Testmail versenden: Mit den Testmail-Buttons können Sie alle 3 E-Mail-Templates testen – unabhängig von der übrigen Konfiguration. So schließen Sie Fehler im Mail-Template aus. Das Plugin schickt Testmails an die E-Mail-Adresse des Shopbetreibers, die in den Stammdaten hinterlegt ist. Einstellungen > Stammdaten
Die E-Mail-Templates können Sie in der Administration bearbeiten: Einstellungen > Shop > E-Mail-Templates.

Plugin einschalten

Aktiv: Schaltet das Plugin für den Verkaufskanal ein oder aus. Ist es aus, werden keine Einladungen verschickt.

Opt-In beim Kauf: Nach deutschem Recht dürfen Sie Kunden nicht ohne deren Zustimmung mit einer Bewertungseinladung anschreiben. Mit der aktivierten Opt-In-Funktion blendet das Plugin im Bestellabschluss unterhalb der AGB-Bestätigung eine separate Checkbox ein, über die der Kunde einwilligen kann, am Bewertungsprogramm teilzunehmen. Den Text der Einwilligung können Sie über die Textbausteinverwaltung Einstellungen > Textbausteine anpassen, indem Sie den Textbaustein tanmar-product-reviews.optin.description anpassen.

Mailversand aktiv: Diese Option steuert, ob der Cronjob Bewertungseinladungen an Kunden verschickt. Sie ist im Standard deaktiviert und sollte erst aktiviert werden, wenn Sie den Opt-In im Checkout getestet, die E-Mail-Templates angepasst und den Bewertungsvorgang getestet haben. Zum Testen kann das Plugin also aktiv sein, ohne dass echte Mails rausgehen.

Logging Level: Wie ausführlich das Plugin protokolliert: 0 – Keine, 100 – Debug (sehr ausführlich), 200 – Info (Standard), 400 – Error (nur Fehler). Für die Fehlersuche vorübergehend auf Debug stellen und anschließend wieder zurückstellen.

Bewertungen

Bewertungen automatisch freigeben: Steuert, ob neue Bewertungen ohne manuelle Freigabe sofort für andere Kunden sichtbar sind: Niemals, Immer, oder ab 1–5 Sternen. Beispiel: „Ab 4 Sternen“ gibt nur gute Bewertungen automatisch frei, schlechtere warten auf Ihre Freigabe in der Administration.

Bewertungen automatisch freigeschaltet: Diese Einstellung wird nicht mehr verwendet und ist deshalb ausgegraut. Verwenden Sie stattdessen Bewertungen automatisch freigeben.

Überschrift ist ein Pflichtfeld: Legt fest, ob der Kunde zwingend eine Überschrift/ein Fazit angeben muss. Wenn nicht aktiv, dann werden die ersten X Wörter aus dem Kommentar als Überschrift genommen.

Erste X Wörter aus Kommentar als optionale Überschrift: Shopware sieht für jede Bewertung eine Überschrift vor. Um die Schwelle für Kunden niedrig zu halten, ist die Überschrift bei der Abgabe der Bewertung für den Kunden optional (außer Sie haben in den Plugin Einstellungen „Überschrift ist ein Pflichtfeld“ aktiviert.). Gibt er keine Überschrift an, werden die ersten X Worte aus dem Bewertungstext als Überschrift verwendet (Standard: 7).

Sterne vorausgewählt: Wie viele Sterne im Bewertungsformular schon vorausgewählt sind (Keine bis 5 Sterne). „Keine“ zwingt den Kunden zur bewussten Auswahl.

Bewertungsbuttons im Kundenaccount bei Bestellungen anzeigen: Blendet in der Bestellübersicht des Kundenkontos einen „Bewerten“-Button ein.

Mailversand (Scheduled Task Konfiguration)

Dieser Bereich steuert, welche Bestellungen eine Einladung erhalten und wann.

Bewertungsfrage X Tage nach Versand (Standard: 21): Hier legen Sie fest, nach wie vielen Tagen nach dem Versand der Ware der Kunde mit der Bewertungseinladung angeschrieben werden soll. Als Versanddatum gilt der Tag, an dem die Bestellung in der Shop-Administration auf „Versandt“ gestellt wurde.

Bestellungen älter als X ignorieren (Datum): Bestellungen, die vor diesem Datum aufgegeben wurden, werden nie angeschrieben. Praktisch bei der Ersteinrichtung, damit keine Altbestellungen angeschrieben werden.

Bestellungen älter als X Tage ignorieren (Standard: 30): Bezieht sich auf den Zeitraum vom Versand bis heute. Bestellungen, deren Versand länger als X Tage zurückliegt, werden übersprungen – so wird ein Nachschlag alter Bestellungen vermieden. Diese Option dient vorwiegend dazu, zu verhindern, dass sehr alte Kunden versehentlich angeschrieben werden.

Bestellungen ignorieren nach X Tagen Bearbeitungszeit (Standard: 0 = aus): Bezieht sich auf den Zeitraum von der Bestellung bis zum Versand. Dauert die Bearbeitung/der Versand länger als X Tage (z.b. lange Lieferzeit), wird keine Einladung verschickt. Bei 0 ist die Regel abgeschaltet.

Altkunden anschreiben: Das Plugin wird in der Standardkonfiguration nur Kunden anschreiben, die über den Opt-In im Checkout eingewilligt haben, am Bewertungsprogramm teilzunehmen. Kunden, die den Opt-In nie gesehen haben, werden demnach nie angeschrieben. Sollten Sie dennoch auch Kunden anschreiben wollen, die gekauft haben bevor das Plugin aktiv war, können Sie das tun. Aktivieren Sie dafür einfach diese Option.

Mails pro Cron-Aufruf (Standard: 100): Die Bewertungseinladungen werden über einen Scheduled Task versendet. Mit dieser Option legen Sie fest, wie viele E-Mails in einem Aufruf versendet werden. Das schützt vor Massenversand auf einen Schlag.

Kundengruppen ausschließen: Mit dieser Einstellung können Sie Kunden aus bestimmten Kundengruppen (z.b. B2B-Kunden) von der Bewertungseinladung ausschließen.

Zahlungsarten ausschließen: Mit dieser Einstellung können Sie Bestellungen mit bestimmten Zahlungsarten von der Bewertungseinladung ausschließen. Das kann z.B. hilfreich sein, wenn Sie Bestellungen aus Bewertungen in den Shop importieren.

Versandarten ausschließen: Mit dieser Einstellung können Sie Bestellungen mit bestimmten Versandarten von der Bewertungseinladung ausschließen. Das kann ebenfalls hilfreich sein, wenn Sie Bestellungen aus Bewertungen in den Shop importieren.

Kurz erklärt – die drei Zeitfenster:
  • X Tage nach Versand = wann die Einladung frühestens rausgeht.
  • älter als X Tage ignorieren = Fenster nach hinten (zu alte, längst versandte Bestellungen).
  • nach X Tagen Bearbeitungszeit = Fenster davor (Bestellungen mit zu langer Lieferzeit).

Gutschein

Optional können Sie Kunden als Dankeschön für ihre Bewertung einen Gutschein zusenden.

Sende Gutschein: Gutschein Versand aktivieren, nachdem der Kunde Produkte bewertet hat.

Gutschein: Hier müssen Sie eine Aktion mit individuellen Aktionscodes auswählen, wenn Sie Gutschein E-Mails versenden wollen. Voraussetzungen: Aktionscodetyp „Individuelle Aktionscodes“, ein eingerichtetes Code-Pattern, ein aktueller Gültigkeitszeitraum und ein zugewiesener Verkaufskanal.

Blindkopie senden: Soll eine Blindkopie (BCC) der Gutschein-/Danke-Mails an Sie geschickt werden?

Blindkopie an folgende Adresse: Hier können Sie festlegen, an welche E-Mail-Adresse die Blindkopie geschickt werden soll. Wenn Sie keine E-Mail-Adresse eintragen, dann wird die Kopie an die Adresse des Shopbetreibers geschickt (Stammdaten).

Zeitpunkt Gutscheinversand: Wann der Gutschein versendet wird: Nach dem ersten bewerteten Produkt oder nachdem alle Produkte der Bestellung bewertet wurden (Standard).

E-Mail Benachrichtigung

Hier legen Sie fest, worüber Sie (der Shop) informiert werden.

Blindkopie jeder Bewertungseinladung an Shopbesitzer senden: Sie können sich Bewertungseinladungen, die das Plugin verschickt, als Blindkopie zukommen lassen. Aktivieren Sie dafür diese Einstellung.

Bei neuen Bewertungen benachrichtigen: Legen Sie hier fest, ab wie vielen Sternen Sie eine Benachrichtigung bekommen wollen: Nein, Ja, immer, oder nur ab einer Sterngrenze – nur bei 4 oder weniger, 3 oder weniger, 2 oder weniger bzw. nur bei 1 Stern. Das ist beispielsweise relevant, wenn Sie sehr schlechte Bewertungen schnell beantworten wollen.

Benachrichtigung bei neuer Bewertung an folgende Adressen: Legen Sie fest, an welche E-Mail-Adressen die Benachrichtigungen verschickt werden sollen. Mehrere Adressen mit Semikolon ; trennen. Wenn hier nichts eingetragen wurde, dann gehen die Benachrichtigungen an die Adresse des Shopbesitzers (Stammdaten).

Blacklist & In-App-Kauf Zusatzfeature

Mit der Blacklist hinterlegen Sie E-Mail-Adressen – oder ganze Domains –, an die keine Bewertungseinladung mehr versendet wird. Steht die Empfängeradresse auf der Blacklist, wird der Versand der Einladungsmail abgebrochen. Typische Fälle: Ein Kunde bittet, nicht mehr kontaktiert zu werden, eine Adresse führt dauerhaft zu unzustellbaren Mails, oder ein ganzer Mail-Anbieter bzw. eine Firmendomain soll grundsätzlich nicht angeschrieben werden.

Die Blacklist ist ein kostenpflichtiges Feature und wird über einen Shopware In-App-Kauf freigeschaltet. Solange der Kauf nicht aktiv ist, greift die Blockierung nicht – Einladungen werden also normal versendet, selbst wenn Einträge in der Datenbank vorhanden sind (z.b. aus einer früheren Freischaltung). Zusätzlich ist die Blacklist-Liste im Adminbereich dann ausgeblendet und die Schaltfläche E-Mail hinzufügen deaktiviert – Einträge lassen sich also erst nach der Freischaltung anlegen.

Der Bereich Blacklist in der Plugin-Konfiguration zeigt den aktuellen Freischaltungsstatus an und enthält die Schaltfläche Funktion kaufen. Ist der Kauf aktiv, erscheint dort stattdessen der Hinweis „Die Blacklist-Funktion ist aktiv.“

Verhalten in Kurzform:

Feature gekauft? Adresse auf Blacklist? Einladung versendet?
Nein Ja (Blacklist inaktiv, Einträge werden ignoriert)
Ja Nein Ja
Ja Ja (einzelne Adresse) Blockiert
Ja Ja (Domain der Adresse) Blockiert
Hinweis: Der In-App-Kauf gilt für die Plugin-Installation, nicht pro Verkaufskanal. Auch die Blacklist-Einträge selbst sind nicht verkaufskanalabhängig – ein Eintrag blockiert die Einladung in allen Verkaufskanälen.

Blacklist bedienen Zusatzfeature

Wo finde ich die Blacklist?

Die Verwaltung der Blacklist liegt im Adminbereich unter Marketing > Blacklist Bewertungen. Zusätzlich gibt es in der normalen Shopware-Bewertungsliste (Kataloge > Bewertungen) oben rechts einen Button “Blacklist Bewertungen”, der direkt dorthin springt.

Die Liste zeigt E-Mail, Kommentar sowie Erstellt am und Zuletzt geändert am. Domain-Einträge sind zusätzlich mit dem Kennzeichen Domain markiert, damit Sie sie auf einen Blick von einzelnen Adressen unterscheiden können.

Einträge anlegen, bearbeiten, löschen

  • Eintrag anlegen: Button E-Mail hinzufügen > E-Mail-Adresse (oder Domain) und optionalen Kommentar eingeben, anschließend Speichern. Der Kommentar ist reine Dokumentation für Ihr Team (z.b. „Kunde hat telefonisch widersprochen, 12.08.2026“) und hat keinen Einfluss auf die Blockierung.
  • Eintrag bearbeiten: Zeile anklicken oder im Kontextmenü (…) am Zeilenende Bearbeiten wählen.
  • Eintrag löschen: im Kontextmenü (…) Löschen wählen. Über die Auswahlkästchen links können Sie auch mehrere Einträge markieren und gemeinsam löschen. Nach dem Löschen erhält die Adresse bei künftigen Bestellungen wieder Einladungen.
Hinweis: Ist das Feature nicht freigeschaltet, ist der Button E-Mail hinzufügen deaktiviert und die Liste wird nicht angezeigt. Stattdessen erscheint der Hinweis „Blacklist-Funktion nicht aktiviert“ mit dem Verweis auf die Plugin-Konfiguration.

Einzelne Adresse oder ganze Domain sperren

Das Feld E-Mail akzeptiert zwei Arten von Einträgen:

Art des Eintrags Beispiel Wirkung
Einzelne Adresse max.mustermann@beispiel.de Nur genau diese Adresse erhält keine Einladung.
Ganze Domain @beispiel.de Alle Adressen dieser Domain erhalten keine Einladung – also auch info@beispiel.de, anna@beispiel.de usw.

Entscheidend ist das führende @: Ein Eintrag, der mit @ beginnt, wird als Domain-Sperre behandelt. Lassen Sie das @ weg (z.b. beispiel.de), greift die Sperre nicht – der Eintrag wäre dann nur eine (ungültige) Einzeladresse.

Praktische Punkte zur Domain-Sperre:

  • Groß-/Kleinschreibung spielt bei der Prüfung keine Rolle: @Beispiel.de blockiert auch kunde@beispiel.de.
  • Subdomains werden nicht mit abgedeckt. @beispiel.de blockiert kunde@mail.beispiel.de nicht – dafür braucht es einen eigenen Eintrag @mail.beispiel.de.
  • Einzeladressen und Domains lassen sich mischen. Sie können @beispiel.de sperren und Einzeladressen anderer Anbieter zusätzlich eintragen. Eine „Ausnahme von der Domain-Sperre“ (Whitelist) gibt es dagegen nicht – ist die Domain gesperrt, ist jede Adresse darunter gesperrt.
  • Typische Einsatzfälle für Domain-Sperren: Wegwerf-Mail-Anbieter, Adressen eigener Testbestellungen (@meinefirma.de), oder ein Großkunde, der pauschal nicht angeschrieben werden möchte.

Was passiert bei einer gesperrten Adresse?

Wird eine Bestellung fällig, prüft das Plugin unmittelbar vor dem Versand die Empfängeradresse gegen die Blacklist – geprüft werden dabei sowohl die vollständige Adresse als auch deren Domain-Teil. Bei einem Treffer gilt:

  1. Die Einladungsmail wird nicht verschickt.
  2. Die Bestellung erhält im Zusatzfeld Bewertungsstatus den Wert „Keine Bewertungsaufforderung“ (siehe Zusatzfelder). Damit wird die Bestellung bei künftigen Durchläufen des geplanten Tasks nicht erneut versucht.
  3. Bei aktivem Logging Level wird ein Eintrag ins Log geschrieben (z.b. email "…" blacklisted). Ist das Feature nicht freigeschaltet, protokolliert das Plugin stattdessen blacklist not active.

Was die Blacklist ausdrücklich nicht tut:

  • Sie blockiert nur die Bewertungseinladung. Bestellbestätigungen, Versandmails und andere Shopware-Mails sind nicht betroffen.
  • Sie verhindert nicht, dass ein Kunde eine Bewertung abgibt. Wer den Link zur Bewertungsseite noch hat oder über das Kundenkonto bewertet, kann weiterhin bewerten – und erhält dann gegebenenfalls auch die Danke-/Gutscheinmail.
  • Sie hat keinen Einfluss auf bereits abgegebene Bewertungen und löscht keine Bewertungen.
  • Sie füllt sich nicht automatisch. Adressen, deren Einladung dauerhaft abgelehnt wird, werden vom Plugin als „E-Mail-Adresse ungültig“ an der Bestellung markiert, aber nicht von selbst in die Blacklist eingetragen – das entscheiden Sie.
Testmails beachten: Auch beim Versand einer Test-Einladung zu einer konkreten Bestellung greift die Blacklist-Prüfung auf die Kundenadresse der Bestellung. Wählen Sie für Tests also eine Bestellung, deren Kundenadresse nicht gesperrt ist.

Emailtemplate anpassen

Prüfen Sie die E-Mail-Vorlagen sorgfältig. Defekte Vorlagen verhindern, dass die E-Mails überhaupt versendet werden können. Passen Sie vor allem die Vorlage für die Bewertungseinladung auch inhaltlich an Ihre Art, Kunden anzusprechen, an. Eine gute Betreffzeile und eine freundlich formulierte Mail kann die Reaktionsquote deutlich erhöhen.

Nach der Installation werden automatisch 3 E-Mail-Templates in Einstellungen > Shop > E-Mail-Templates angelegt.

Email-Vorlage Bewertungseinladung

<div style="font-family:arial; font-size:12px;">
    <p>
        Guten Tag {{order.orderCustomer.firstName}} {{order.orderCustomer.lastName}},<br><br>
        Wir hoffen, dass Sie mit den am {{ order.orderDateTime|date }} erworbenen Produkten zufrieden sind und Freude daran haben. Teilen Sie doch Ihre Erfahrungen mit anderen Kunden, indem Sie untenstehende Produkte bewerten. Produktbewertungen helfen bei zukünftigen Kaufentscheidungen, wovon auch Sie profitieren können.
    </p>
    <table width="100%" border="0" cellpadding="4" cellspacing="0" style="font-family:Arial, Helvetica, sans-serif; font-size:12px;">
        <tbody>
            {% for lineItem in order.lineItems %}
                {% if lineItem and (lineItem.type == "product") %}
                    <tr>
                        <td style="border-bottom: 1px solid #e2e2e2; height: 5px;">&nbsp;</td>
                        <td style="border-bottom: 1px solid #e2e2e2; height: 5px;">&nbsp;</td>
                        <td style="border-bottom: 1px solid #e2e2e2; height: 5px;">&nbsp;</td>
                    </tr>
                    <tr>
                        <td style="height: 6px;">&nbsp;</td>
                        <td style="height: 6px;">&nbsp;</td>
                        <td style="height: 6px;">&nbsp;</td>
                    </tr>
                    <tr>
                        <td width="20%" align="center" valign="middle" style="font-size:12px;">
                            {% if lineItem.cover %}
                                {% set coverURL = lineItem.cover.url %}
                            {% elseif lineItem.product and lineItem.product.cover and lineItem.product.cover.media %}
                                {% set coverURL = lineItem.product.cover.media.url %}
                            {% endif %}
                            {% if coverURL %}
                                <a href="{{ rawUrl('frontend.tanmarproductreviews', {'orderNumber':order.orderNumber, 'hash':hash}, salesChannel.domains|first.url) }}" class="review-link" style="color:#fff; border:0px solid #fff;" title="{{ lineItem.label|u.wordwrap(80) }}">
                                    <img style="height: 80px; font-size:12px; border:0px solid #fff" height="80" src="{{ coverURL }}" alt="{{ lineItem.label|u.wordwrap(80) }}" />
                                </a>
                            {% endif %}
                        </td>
                        <td width="49%" valign="middle" style="font-size:12px; font-family:Verdana, Arial, sans-serif; font-size: 12px; line-height: 18px; color: #000;">
                            {{ lineItem.label|u.wordwrap(80) }}
                        </td>
                        <td width="31%" align="right" valign="middle">
							<table border="0" cellpadding="0" cellspacing="0" role="presentation" style="border-collapse:separate; mso-line-height-rule: exactly; -ms-text-size-adjust: 100%; line-height: 150%;" class="review-button">
<tr>
<td align="center" bgcolor="#81bb44" role="presentation" style="border:none; border-radius:4px; cursor:auto; padding:10px 16px; background:#81bb44;" valign="middle">
<a href="{{ rawUrl('frontend.tanmarproductreviews', {'orderNumber':order.orderNumber, 'hash':hash}, salesChannel.domains|first.url) }}" style="background:#81bb44; color:#ffffff; font-family:Verdana, Arial, sans-serif; font-size:14px; font-weight:400; margin:0; text-decoration:none; text-transform:none; mso-line-height-rule: exactly; -ms-text-size-adjust: 100%; line-height: 150%;" target="_blank" class="review-link" title="Jetzt bewerten {{ lineItem.label|u.wordwrap(80) }}">
Jetzt bewerten
</a>
</td>
</tr>
</table> </td> </tr> {% endif %} {% endfor %} </tbody> </table> </div>

Email-Vorlage für Gutscheine

<div style="font-family:arial; font-size:12px;">
	<p><strong>Guten Tag {{ order.orderCustomer.firstName }} {{ order.orderCustomer.lastName }},</strong><br/><br/></p>
	<p>Sie haben sich Zeit genommen und unsere Produkte bewertet.<br /></p>
	<p>Dafür möchten wir uns mit diesem <strong>Einkaufsgutschein</strong> bedanken.<br/></p>
	<p style="color:#81bb44; font-size:24px; font-family:Verdana, Arial, sans-serif;"><span style="color:#4d4d4d">Gutscheincode:</span> {{ tanmarProductReviews.coupon }}</p>
	<p><br /></p>
</div>

Email-Vorlage für Bewertungs-Benachrichtungen

<div style="font-family:arial; font-size:12px;">
    <p><strong>Guten Tag,</strong></p>
    <p>es ist eine neue Bewertung mit {{ tanmarProductReviews.points }} Punkt{% if tanmarProductReviews.points > 1 %}en{% endif %} für Ihren Shop {{ salesChannel.translated.name }} eingegangen.</p>
    {% if not tanmarProductReviews.skipModeration %}<p>Sie können diese in Ihrer Shopware Administration freischalten.</p>{% endif %}
</div>

Zusatzfelder (Custom Fields)

Das Plugin legt zwei eigene Zusatzfeld-Sets an: eines an jeder Bestellung und eines an jedem Produkt. Beide werden bei der Deinstallation des Plugins wieder entfernt, sofern Sie beim Deinstallieren nicht ausdrücklich „Daten behalten“ wählen.

Zusatzfelder bei der Bestellung

Das Plugin fügt bei den Bestellungen vier benutzerdefinierte Felder hinzu. Sie finden sie im Adminbereich in der Bestellansicht (Bestellungen > Bestellung öffnen) im Bereich der Zusatzfelder. Über diese Felder sehen Sie auf einen Blick, in welchem Bewertungs-Zustand sich eine Bestellung befindet. Das Plugin pflegt die Werte in der Regel automatisch – Sie können sie bei Bedarf aber auch manuell anpassen (z.b. um eine Bestellung vom Versand auszuschließen).

Zusatzfeld Typ Bedeutung
Bewertungsstatus Auswahl Aktueller Stand der Bewertungseinladung – siehe Werte unten.
Produktbewertungen gesendet Datum/Zeit Zeitpunkt, zu dem die Bewertungseinladung an den Kunden verschickt wurde.
Gutschein-Code Text Individueller Gutschein-Code, den der Kunde fürs Bewerten erhalten hat (nur bei aktivem Gutscheinversand).
Produktbewertungen Opt-In Auswahl Ob der Kunde im Checkout zugestimmt hat, am Bewertungsprogramm teilzunehmen. Kunden die ohne Opt-In durch den Bestellprozess gegangen sind, können mit der Plugin-Option Altkunden anschreiben berücksichtigt werden.

Werte des Feldes Bewertungsstatus

Wert Bedeutung
Anfrage ausstehend Für die Bestellung wurde noch keine Einladung verschickt – sie wartet auf den Versand.
Anfrage gesendet Die Bewertungseinladung wurde bereits verschickt.
Keine Bewertungsaufforderung Der Kunde wird nicht angeschrieben (z.b. durch eine „ignorieren“-Regel ausgeschlossen oder weil die Kundenadresse auf der Blacklist steht). Können Sie auch manuell setzen, um eine Bestellung gezielt vom Versand auszunehmen.
Bereits bewertet Alle Artikel der Bestellung wurden vom Kunden bereits bewertet.
E-Mail-Adresse ungültig Die Einladungsmail wurde vom Mailserver des Empfängers dauerhaft abgelehnt (z.b. Adresse existiert nicht oder ist als Spam gesperrt). Das Versenden der Einladungsmail wird nicht erneut versucht.

Werte des Feldes Produktbewertungen Opt-In

Wert Bedeutung
Zugestimmt Der Kunde hat im Checkout der Bewertungserinnerung zugestimmt.
Nicht gefragt Es wurde keine Zustimmung abgefragt (z.b. Opt-In war deaktiviert).
Abgelehnt Der Kunde hat die Bewertungserinnerung abgelehnt.

Zusatzfeld beim Produkt

Zusätzlich legt das Plugin an jedem Produkt ein Zusatzfeld-Set namens „Produktbewertungen Produkt Set“ an. Sie finden es im Adminbereich beim Bearbeiten eines Produkts unter Zusatzfelder.

Von Bewertungsmail ausschließen (Ja/Nein): Ist der Haken gesetzt, wird dieses Produkt in Bewertungseinladungen nicht aufgeführt – der Kunde wird also nicht gebeten, es zu bewerten. Praktisch z.b. für Versandkosten-Artikel, Gutscheine, Pfand oder Dienstleistungen, die keine Produktbewertung erhalten sollen.

Tipp: Enthält eine Bestellung ausschließlich ausgeschlossene Produkte, gibt es nichts zu bewerten – es wird dann keine Einladung verschickt.

Probleme und Lösungen

Es gehen keine Bewertungsmails raus? – Checkliste

Damit eine Einladung versendet wird, müssen alle folgenden Punkte erfüllt sein:

  • Das Plugin ist aktiv (Einstellung Aktiv).
  • Der Mailversand ist aktiviert (Einstellung Mailversand aktiv).
  • Die Bestellung steht im Status „versendet“.
  • Die Wartezeit nach dem Versand ist erreicht (Bewertungsfrage X Tage nach Versand).
  • Die Bestellung ist nicht durch eine der „ignorieren“-Regeln ausgeschlossen (siehe Bereich Scheduled Task Konfiguration).
  • Es sind noch nicht alle Artikel der Bestellung bewertet.
  • Die Kundenadresse steht nicht auf der Blacklist – weder als Einzeladresse noch über eine Domain-Sperre.
  • Der geplante Task und die Mail-Warteschlange laufen auf dem Server.

Prüfen Sie die Einstellungen bei Bedarf pro Verkaufskanal – Shopware erlaubt abweichende Werte je Verkaufskanal.

Test & weitere Hinweise

Testmails: In der Plugin-Konfiguration gibt es Schaltflächen, um Test-Einladungen und Test-Gutscheinmails zu verschicken – unabhängig von der übrigen Konfiguration. So schließen Sie Fehler im Mail-Template aus.

Logging erhöhen: Für die Fehlersuche das Logging Level vorübergehend auf 100 – Debug stellen und anschließend wieder auf 200 – Info zurücksetzen.

Einzelner Kunde erhält keine Einladung? Prüfen Sie zuerst den Bewertungsstatus an der Bestellung. Steht dort „Keine Bewertungsaufforderung“, kann eine Blacklist-Sperre die Ursache sein – suchen Sie in der Blacklist nicht nur nach der Adresse selbst, sondern auch nach einem Domain-Eintrag wie @beispiel.de. Nach dem Entfernen des Eintrags setzen Sie den Bewertungsstatus der Bestellung wieder auf „Anfrage ausstehend“, damit sie erneut berücksichtigt wird.

Blacklist-Einträge wirken nicht? Prüfen Sie in der Plugin-Konfiguration im Bereich Blacklist, ob das Feature freigeschaltet ist. Ohne aktiven In-App-Kauf werden Einträge ignoriert (Logeintrag blacklist not active).

Gutschein wird nicht versendet? Prüfen Sie die Aktion (individuelle Codes, Code-Pattern, Gültigkeitszeitraum, zugewiesener Verkaufskanal) und ob der Gutscheinversand im Plugin – auch pro Verkaufskanal – aktiviert ist.

Link zur Bewertungsseite erzeugen

Der Hash und damit der Link zur Seite für Bewertungen kann ganz leicht selbst erstellt werden. Der Hash ist ein hexadezimaler sha1 Hash aus einem String mit folgendem Format:


'Kundennummer#Kunden-E-Mail-Adresse#Bestellnummer'


Die Daten für die Kundennummer, E-Mail-Adresse und Bestellnummer werden aus den Daten einer Bestellung gelesen und über '#' miteinander verbunden. Die ersten sechs Zeichen dieses Hashes werden dann für den Aufbau der URL verwendet. Hier das Format der URL:
[shop-domain]/TanmarProductReviews/[Bestellnummer]/[hash]


Beispiel

  • Kundenummer: 7777
  • Bestellung: SW12345
  • Kunden-E-Mail-Adresse: mustermensch@beispiel.de

Daraus wird der string:
'7777#mustermensch@beispiel.de#SW12345'

Aus diesem ergibt sich der sha1-Hash:
'd753fbb66abe2e5c640a1f639bd9c5b3441daa00'


Von diesem nehmen wir nun die ersten sechs Zeichen 'd753fb' und bauen sie in die URL ein, um so den Link zur Bewertungseinladung zu generieren:
domain.tld/TanmarProductReviews/SW12345/d753b


Wenn Sie eine individuelle Lösung brauchen, dann nehmen Sie mit uns Kontakt auf.