DataFirefly Verifizierte Bewertungen: Dokumentation
Das Modul für verifizierte Bewertungen installieren, konfigurieren und betreiben: automatische Anfragen, CRON, KI-Zusammenfassung, Rich Snippets, Moderation und CSV-Import.
Voraussetzungen und Installation
DataFirefly Verifizierte Bewertungen läuft unter PrestaShop 8.0 bis 9.0 mit PHP 8.0 bis 8.4. Seit Version 1.1.0 deckt ein einziges ZIP beide Zweige ab: Sie müssen beim Download nicht zwischen einer PS-8- und einer PS-9-Version wählen.
- Öffnen Sie im Backoffice Module → Modul-Manager und klicken Sie auf Modul hochladen.
- Legen Sie die Datei
dfreviews.zipab, die Sie aus Ihrem DataFirefly-Konto heruntergeladen haben. - Klicken Sie nach Abschluss der Installation auf Konfigurieren.
Die Installation legt sechs eigene Tabellen an (Bewertungen, Medien, Anfragen, Hilfreich-Stimmen, KI-Zusammenfassungen, Statistiken) und fügt im Menü Katalog einen Reiter Verifizierte Bewertungen hinzu. Über diesen Reiter moderieren Sie die Bewertungen; der Konfigurationsbildschirm bleibt über den Modul-Manager erreichbar.
Falls ein erster Installationsversuch fehlgeschlagen ist, starten Sie ihn einfach erneut: seit 1.1.0 wird der Admin-Reiter idempotent angelegt und nicht dupliziert.
Auslöser für Bewertungsanfragen konfigurieren
Das ist das Herzstück des Moduls. Zwei Einstellungen im Bereich Allgemeine Einstellungen:
- Auslösen nach Status: Versendet (Standard) oder Zugestellt. Wählen Sie den Status, der in Ihrem tatsächlichen Ablauf bedeutet, dass der Kunde das Produkt in Händen hält.
- Wartezeit vor dem Versand: standardmäßig 3 Tage. Rechnen Sie die Lieferzeit plus einige Tage Nutzung. Bei Produkten, die sich erst im Gebrauch beurteilen lassen (Kosmetik, Matratzen), erhöhen Sie auf 10 oder 15 Tage.
Erreicht eine Bestellung den gewählten Status, wird eine Anfrage mit berechnetem Versanddatum in die Warteschlange gestellt. Sie wird nicht sofort verschickt: dafür sorgt der CRON.
CRON einrichten
Ohne CRON wird keine E-Mail versendet. Die aufzurufende URL steht oben im Konfigurationsbildschirm des Moduls; sie enthält ein bei der Installation erzeugtes Token. Planen Sie sie stündlich bei Ihrem Hoster ein:
0 * * * * wget -q -O /dev/null "IM_MODUL_ANGEZEIGTE_CRON_URL"Bei jedem Durchlauf führt der CRON drei Aufgaben aus und liefert eine JSON-Zusammenfassung der erledigten Arbeit:
- Versand der fälligen Anfragen in Paketen zu 50;
- Versand der Erinnerungen für unbeantwortete Anfragen;
- Ablauf von Anfragen, die älter als 60 Tage sind.
Das CRON-Token ist ein Geheimnis: veröffentlichen Sie es nicht und versenden Sie es nicht im Klartext. Jede Anfrage ohne gültiges Token erhält eine 403-Antwort.
Erinnerungen und Gutschein als Belohnung
Der Bereich Erinnerung aktiviert eine zweite E-Mail, wenn nach einer konfigurierbaren Frist (standardmäßig 5 Tage ab dem ersten Versand) keine Bewertung abgegeben wurde. Pro Anfrage wird nur eine Erinnerung verschickt.
Der Bereich Anreiz-Gutschein erzeugt einen Rabattgutschein, sobald ein identifizierter Kunde eine Bewertung veröffentlicht. Sie legen den Prozentsatz (standardmäßig 10 %) und die Gültigkeitsdauer (30 Tage) fest. Der erzeugte Code ist eine native PrestaShop-Warenkorbregel, personengebunden und einmalig verwendbar, Sie finden ihn daher unter Katalog → Rabatte.
Der Code wird nur für angemeldete oder über eine Bestellung identifizierte Kunden erzeugt. Eine Gastbewertung löst keine Belohnung aus.
KI-Zusammenfassung aktivieren
Tragen Sie Ihren OpenAI-API-Schlüssel im Bereich Künstliche Intelligenz ein und wählen Sie ein Modell. gpt-4o-mini ist voreingestellt: es ist das günstigste, etwa ein halber Cent pro Zusammenfassung.
Die Zusammenfassung greift ab drei veröffentlichten Bewertungen zu einem Produkt. Das Modul sendet bis zu 100 Bewertungen an OpenAI und erhält drei strukturierte Elemente zurück: Stärken, Schwächen, Gesamtfazit. Das Ergebnis wird pro Produkt, pro Shop und pro Sprache zwischengespeichert und oben im Bewertungsbereich der Produktseite angezeigt.
Sie können die Anzeige über die Option KI-Zusammenfassung auf der Produktseite anzeigen deaktivieren, ohne den Schlüssel zu löschen.
Rich Snippets und Darstellung im Frontend
Ist die Option Rich Snippets aktiv, fügt das Modul auf jeder Produktseite, die die konfigurierte Mindestanzahl an Bewertungen erreicht, strukturierte Schema.org-Daten ein (AggregateRating, Review, Offer, Brand). Prüfen Sie das Ergebnis nach dem Besuch des Crawlers mit dem Google-Test für Rich-Suchergebnisse.
Für die Darstellung hängt sich das Modul in die nativen Hooks des Themes ein:
displayProductAdditionalInfo: Sterne und Durchschnittsnote unter dem Produkttitel;displayProductExtraContent: der Reiter „Kundenbewertungen“ mit Liste, Filtern und Formular;displayProductListReviews: die Sterne in den Kategorielisten;displayCustomerAccount: der Link „Meine Bewertungen“ im Kundenkonto.
Diese Hooks gibt es in den Themes Classic und Hummingbird. In einem individuellen Theme, das sie entfernt hat, müssen sie in den betroffenen Templates wiederhergestellt werden, sonst erscheinen die Bewertungen nirgends.
Bewertungen moderieren
Der Bildschirm Katalog → Verifizierte Bewertungen zeigt ein Dashboard (gesamt, veröffentlicht, ausstehend, gemeldet, Durchschnittsnote, Anfragen in der Warteschlange) und darunter die vollständige Bewertungsliste.
Standardmäßig wartet jede Bewertung auf Ihre Freigabe. Aktivieren Sie Automatische Freigabe, wenn Sie die sofortige Veröffentlichung bevorzugen. Aus der Liste heraus können Sie Bewertungen im Stapel freigeben oder ablehnen und eine Bewertung zum Bearbeiten oder Beantworten öffnen.
Die Händlerantwort wird öffentlich unter der Bewertung angezeigt. Ist ein OpenAI-Schlüssel hinterlegt, schlägt die Schaltfläche KI-Antwortvorschlag einen zum Ton der Bewertung passenden Entwurf vor, der vor dem Speichern gegengelesen und angepasst werden sollte und nie unverändert veröffentlicht wird.
Kundenfotos
Kunden können bis zu N Fotos pro Bewertung anhängen (standardmäßig 3). Zulässige Formate: JPEG, PNG und WebP, maximal 5 MB pro Datei. Der tatsächliche Dateityp wird beim Empfang geprüft, unabhängig vom Dateinamen.
Die Bilder werden in modules/dfreviews/uploads/ gespeichert. Nehmen Sie diesen Ordner in Ihre Backups auf: das Löschen einer Bewertung löscht auch ihre Dateien.
Bewertungen importieren und exportieren
Über die Schaltfläche CSV exportieren im Bildschirm Verifizierte Bewertungen erzeugen Sie eine semikolongetrennte UTF-8-Datei, die sich direkt in Excel öffnen lässt. Der Importblock direkt darunter lädt eine Datei im selben Format.
Zwei Spalten sind Pflicht: id_product und rating (1 bis 5). Die übrigen sind optional: customer_name, customer_email, title, content, id_customer, id_order, verified_purchase, active, merchant_reply und date_add. Zeilen mit nicht existierendem Produkt werden übersprungen und gemeldet. Aktivieren Sie Automatisch freigeben, um importierte Bewertungen direkt zu veröffentlichen.
Am einfachsten bereiten Sie eine Migration von Trustpilot oder einem alten Modul so vor: zuerst eine Datei aus dem Modul exportieren, um die exakte Kopfzeile zu erhalten, dann Ihre Daten eintragen.
Multishop und Mehrsprachigkeit
Die gesamte Konfiguration ist pro Subshop unabhängig: OpenAI-Schlüssel, auslösender Status, Fristen, Farben, Anreiz. Bewertungen sind über id_shop getrennt, dasselbe Produkt in mehreren Shops kann also je nach Kontext unterschiedliche Bewertungen anzeigen.
Bewertungen und KI-Zusammenfassungen werden mit ihrer id_lang gespeichert. Eine Zusammenfassung wird für die Sprache erzeugt, in der sie angefordert wird.
Von PrestaShop 8 auf PrestaShop 9 wechseln
Eine Datenmigration ist nicht nötig: das Schema ist in beiden Zweigen identisch. Ersetzen Sie das Modul durch Version 1.1.0 vor oder nach Ihrem PrestaShop-Upgrade, in der Reihenfolge, die Ihnen passt.
Wenn Sie von einer 1.0.x in einem bereits auf PS 9 gehobenen Shop aktualisieren, sollten Sie zwei Dinge wissen: Versionen vor 1.1.0 lassen sich unter PS 9 nicht installieren (die Registrierung von Hooks ohne zugehörige Methode wird dort abgelehnt), und die bestehende Konfiguration bleibt beim Update vollständig erhalten.
Fehlerbehebung
Es wird keine Anfrage-E-Mail versendet. Prüfen Sie zuerst, ob der CRON tatsächlich läuft, indem Sie seine URL von Hand aufrufen: die JSON-Antwort nennt die Anzahl der Versendungen. Kontrollieren Sie danach den konfigurierten auslösenden Status und die E-Mail-Einstellungen des Shops unter Erweiterte Einstellungen → E-Mail.
Die Sterne erscheinen nicht auf der Produktseite. Wahrscheinlich ruft das Theme die oben genannten Hooks nicht auf. Prüfen Sie außerdem, ob mindestens eine Bewertung veröffentlicht ist: ohne aktive Bewertung wird nichts angezeigt.
Die KI-Zusammenfassung wird nicht erzeugt. Nötig sind mindestens drei veröffentlichte Bewertungen sowie ein gültiger und aufgeladener OpenAI-Schlüssel. Fehler bei API-Aufrufen werden unter Erweiterte Einstellungen → Logs protokolliert.
Die Sterne erscheinen nicht bei Google. Die Indexierung dauert einige Tage bis einige Wochen. Prüfen Sie das Markup mit dem Test für Rich-Suchergebnisse und stellen Sie sicher, dass kein anderes SEO-Modul einen konkurrierenden zweiten Product-Block auf derselben Seite einfügt.
Der CSV-Import bewirkt nichts. Das war ein Fehler der Versionen 1.0.x, behoben in 1.1.0.