Verifizierte Bewertungen WooCommerce — Dokumentation

DataFirefly Reviews (dfreviews) macht aus dem nativen WooCommerce-Bewertungssystem eine Social-Proof-Maschine: automatische Bewertungsanfragen nach dem Kauf, Badge Verifizierter Kauf, Kundenfotos, Hilfreich-Stimmen, KI-Zusammenfassung auf der Produktseite, automatische KI-Antwort auf Bewertungen, Belohnungsgutschein und Schema.org Rich Snippets. Diese Dokumentation behandelt Installation, vollständige Konfiguration und Fehlerbehebung.

Installation

1. Öffnen Sie in Ihrer WordPress-Administration Plugins → Installieren → Plugin hochladen.
2. Wählen Sie dfreviews-1.0.0.zip, klicken Sie auf Jetzt installieren und dann auf Aktivieren.
3. Ein neues Untermenü WooCommerce → DF Reviews erscheint: das Kontrollzentrum des Plugins.

Voraussetzungen: WooCommerce 8 oder 9, WordPress 6.0+, PHP 8.0 bis 8.3. Das Plugin ist HPOS-kompatibel (High-Performance Order Storage) und läuft ohne jQuery und ohne Composer.

OpenAI-Schlüssel konfigurieren

KI-Zusammenfassung und automatische Antwort nutzen Ihren eigenen OpenAI-API-Schlüssel:

1. Erstellen Sie einen Schlüssel auf platform.openai.com.
2. Fügen Sie ihn unter WooCommerce → DF Reviews → Settings im Abschnitt OpenAI ein.
3. Das Standardmodell ist gpt-4o-mini — am günstigsten, empfohlen. Eine Zusammenfassung oder Antwort kostet typischerweise deutlich weniger als einen Cent.

Automatische Bewertungsanfragen

Abschnitt Review requests der Einstellungen:

• Auslöserstatus: Die Anfrage wird in die Warteschlange gestellt, wenn eine Bestellung diesen Status erreicht (Standard Abgeschlossen).
• Versandverzögerung: Wartezeit in Tagen nach dem Auslöserstatus (Standard: 3 Tage).
• Erinnerung: Eine einmalige Erinnerungs-E-Mail wird versendet, wenn keine Bewertung abgegeben wurde (Standard: 5 Tage nach der ersten E-Mail).

Jede E-Mail enthält einen persönlichen Token-Bewertungslink: Eine darüber abgegebene Bewertung erhält automatisch das Badge Verifizierter Kauf. Der Versand erfolgt in 50er-Stapeln bei jedem Cron-Lauf. Der Tab Request queue listet die letzten 100 Anfragen mit ihrem Status (pending, sent, reminded, completed, failed, unsubscribed) und bietet eine manuelle Verarbeitung.

KI-Zusammenfassung der Bewertungen

Sobald ein Produkt die Mindestanzahl veröffentlichter Bewertungen erreicht (Standard: 3), generiert der Cron einen Block, der oben im Bewertungs-Tab der Produktseite angezeigt wird: Stärken, Hinweise und Fazit.

• Die Zusammenfassung wird pro Produkt und pro Sprache zwischengespeichert: Mit Polylang oder WPML zeigt jede Sprachversion eine Zusammenfassung in ihrer eigenen Sprache.
• Sie wird automatisch neu generiert, wenn neue Bewertungen veröffentlicht werden (Invalidierung per Fingerabdruck der analysierten Bewertungen).
• Die Einstellung Max reviews analyzed begrenzt, wie viele Bewertungen an das Modell gesendet werden.

Der Tab AI tools listet die generierten Zusammenfassungen mit Sprache und Datum.

Automatische KI-Antwort auf Bewertungen

Jede veröffentlichte Bewertung kann eine KI-generierte Händlerantwort erhalten, verfasst in der Sprache der Bewertung. Wichtige Einstellungen:

• Veröffentlichungsmodus: Entwurf (anfangs empfohlen — jede Antwort wartet auf Ihre Freigabe im Kommentare-Bereich) oder Sofort veröffentlichen.
• Ton: herzlich, professionell oder prägnant.
• Signaturname: wird als Antwortautor angezeigt (leer = Name der Website).
• Antworten ab Bewertung: 1, um auf alle Bewertungen zu antworten — empfohlen, da negative Bewertungen am meisten von einer Antwort profitieren.

Eingebaute Leitplanken: Bei Noten von 3/5 oder darunter entschuldigt sich die Antwort und verweist an den Support, ohne je eine Rückerstattung zu versprechen. Antworten sind auf etwa 70 Wörter begrenzt, erscheinen mit dem Badge Offizielle Antwort und sind von Durchschnitten und Rich Snippets ausgeschlossen.

Fotos, Stimmen und Belohnungsgutschein

• Kundenfotos: Kunden hängen bis zu 3 Fotos (konfigurierbar, max. 10) an ihre Bewertung — jpg, png, webp, gif, max. 5 MB, Anzeige mit Lightbox.
• Hilfreich-Stimmen: Buttons mit Duplikatschutz pro Konto und pro gehashter IP. Nie bei Händlerantworten angezeigt.
• Belohnungsgutschein: Bei Veröffentlichung der Bewertung erhält der Kunde einen Prozentgutschein (Standard: 10 %, 30 Tage), einmalig, an seine E-Mail gebunden. Anti-Farming: eine Belohnung pro E-Mail und Produkt.

Formular und Anzeige

• Titelfeld der Bewertung, optional oder Pflicht.
• Mindestlänge der Bewertung in Zeichen (Standard: 10).
• Bewertungsverteilungsblock (Balken 5★ bis 1★) über der Bewertungsliste.
• Sternfarbe anpassbar (Hexadezimal, Standard #e7a11a).

Schema.org Rich Snippets

Das Plugin behält das native AggregateRating- und Review-Markup von WooCommerce bei und bereinigt es: Händlerantworten werden aus Markup und Durchschnitten ausgeschlossen, damit Ihre Google-Sterne korrekt bleiben. Die Option kann in den Einstellungen deaktiviert werden, wodurch dann jegliches Bewertungs-Markup entfernt wird.

Cron: zuverlässiger Versand

Die Verarbeitung (Anfragen, Erinnerungen, KI-Zusammenfassungen, Nachhol-Antworten) läuft stündlich über WP-Cron. Da WP-Cron nur bei Seitenbesuchen ausgelöst wird, richten Sie für zuverlässigen Versand einen echten Server-Cron ein:

1. Kopieren Sie die Token-Cron-URL aus Settings → Cron.
2. Fügen Sie sie im Cron Ihres Hosters (oder in der Crontab) hinzu, alle 15 bis 60 Minuten, z. B. mit curl -s "URL" > /dev/null.

Eine Sperre verhindert zwei gleichzeitige Läufe. Der Button Run processing now im Tab Request queue startet jederzeit eine manuelle Verarbeitung.

CSV-Import und -Export

Tab Import / Export:

• Export: alle Produktbewertungen mit Note, Titel, Verifiziert-Kennzeichen und Daten.
• Import: CSV mit Kopfzeile und Spalten product_id oder sku, author, email, rating, title, content, date (Y-m-d H:i:s, optional), verified (1/0, optional). Bewertungsstatistiken werden nach dem Import automatisch neu berechnet.

Kundenkonto

Dem Kundenkonto (Mein Konto) wird ein Tab Meine Bewertungen hinzugefügt: Dort findet jeder Kunde seine Bewertungen mit Moderationsstatus, Sternen und Verifiziert-Badge. Liefert der Tab nach der Aktivierung einen 404-Fehler, speichern Sie die Permalinks unter Einstellungen → Permalinks → Speichern neu.

DSGVO und Daten

• Abmeldelink in jeder Anfrage-E-Mail; abgemeldete Adressen als SHA-256-Hashes gespeichert, nie im Klartext.
• IP-Adressen der Abstimmenden mit dem WordPress-Salt gehasht.
• Einziger ausgehender Aufruf: die von Ihnen kontrollierte OpenAI-API, und nur bei konfiguriertem Schlüssel.
• Die Deinstallation entfernt Tabellen und Einstellungen des Plugins, behält aber alle Bewertungen (native WooCommerce-Bewertungen).

Fehlerbehebung

• Anfragen gehen nicht raus: Prüfen Sie, ob die Funktion aktiviert ist, Bestellungen den Auslöserstatus erreichen und der Cron läuft (letzter Lauf in AI tools angezeigt). Richten Sie die Server-Cron-URL ein.
• Keine KI-Zusammenfassung: OpenAI-Schlüssel konfiguriert? Mindestanzahl veröffentlichter Bewertungen erreicht? Die Zusammenfassung wird beim Cron-Lauf generiert, nicht sofort.
• Keine KI-Antwort: Prüfen Sie den Modus (im Entwurfsmodus wartet die Antwort unter Kommentare → Ausstehend), die konfigurierte Mindestnote und den API-Schlüssel.
• E-Mails kommen nicht an: Das Plugin versendet über den WooCommerce-Mailer — testen Sie Ihre globale E-Mail-Konfiguration (ein SMTP-Plugin wird empfohlen).