# 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… - Seite: - Sprache: de - Aktualisiert am: 2026-07-16 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/dfreviews/index.md), [en](https://www.datafirefly.com/en/documentation/dfreviews/index.md), [es](https://www.datafirefly.com/es/documentation/dfreviews/index.md), [it](https://www.datafirefly.com/it/documentation/dfreviews/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfreviews/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfreviews/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfreviews/index.md) - Index: 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. Das Plugin baut auf den nativen WooCommerce-Bewertungen auf: Ihre bestehenden Bewertungen bleiben erhalten und sind sofort nutzbar. Keine Migration erforderlich. 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](https://platform.openai.com/api-keys). 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. Ohne OpenAI-Schlüssel funktionieren alle anderen Funktionen (Anfragen, Fotos, Stimmen, Gutscheine, Rich Snippets) uneingeschränkt weiter. Der Tab **AI tools** zeigt den Status der KI-Konfiguration. ## 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. Jede E-Mail enthält einen Abmeldelink. Abgemeldete Adressen werden als SHA-256-Hashes gespeichert und erhalten nie wieder eine Anfrage. ## 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. Für bestehende oder importierte Bewertungen: Aktion **Generate AI reply** in der WordPress-Kommentarliste oder die Stapel-Nachverarbeitung des Crons. ## 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).