Geverifieerde Reviews WooCommerce: documentatie

DataFirefly Reviews (dfreviews) maakt van het ingebouwde reviewsysteem van WooCommerce een motor voor sociale bewijskracht: automatische reviewverzoeken na aankoop, badge Geverifieerde aankoop, klantfoto’s, nuttig-stemmen, AI-samenvatting van de reviews op de productpagina, automatisch AI-antwoord op reviews, kortingscode als beloning en rich snippets volgens Schema.org. Deze documentatie behandelt de installatie, de volledige configuratie en het oplossen van problemen.

Installatie

1. Open in uw WordPress-beheer Plugins → Nieuwe plugin → Plugin uploaden.
2. Selecteer het bestand dfreviews-1.0.0.zip, klik op Nu installeren en daarna op Activeren.
3. Er verschijnt een nieuw submenu WooCommerce → DF Reviews: het bedieningspaneel van de plugin.

Vereisten: WooCommerce 8 of 9, WordPress 6.0+, PHP 8.0 tot 8.3. De plugin is compatibel met HPOS (High-Performance Order Storage) en werkt zonder jQuery en zonder Composer.

De OpenAI-sleutel instellen

De AI-samenvatting en het automatische antwoord gebruiken uw eigen OpenAI API-sleutel:

1. Maak een sleutel aan op platform.openai.com.
2. Plak die in WooCommerce → DF Reviews → Settings, onderdeel OpenAI.
3. Het standaardmodel is gpt-4o-mini, het voordeligste en het aanbevolen model. Een samenvatting of antwoord kost doorgaans ruim minder dan een cent.

Automatische reviewverzoeken

Onderdeel Review requests van de instellingen:

• Triggerstatus: het verzoek wordt in de wachtrij gezet zodra een bestelling deze status bereikt (standaard Voltooid).
• Verzendvertraging: aantal dagen wachten na de triggerstatus (standaard 3 dagen).
• Herinnering: er vertrekt één herinneringsmail als er geen review is geplaatst (standaard 5 dagen na de eerste mail).

Elke e-mail bevat een persoonlijke reviewlink met token: een review die via deze link wordt geplaatst, krijgt automatisch de badge Geverifieerde aankoop. De verzending gebeurt in batches van 50 bij elke croncyclus. Het tabblad Request queue toont de laatste 100 verzoeken met hun status (pending, sent, reminded, completed, failed, unsubscribed) en maakt handmatige verwerking mogelijk.

AI-samenvatting van de reviews

Zodra een product het minimum aantal gepubliceerde reviews bereikt (standaard 3), genereert de cron een blok bovenaan het reviewtabblad van de productpagina: sterke punten, aandachtspunten en samenvatting.

• De samenvatting wordt gecachet per product en per taal: met Polylang of WPML toont elke taalversie een samenvatting in de eigen taal.
• Ze wordt automatisch opnieuw gegenereerd wanneer er nieuwe reviews verschijnen (invalidatie op basis van een vingerafdruk van de geanalyseerde reviews).
• De instelling Max reviews analyzed begrenst het aantal reviews dat naar het model wordt gestuurd.

Het tabblad AI tools toont de gegenereerde samenvattingen met hun taal en datum.

Automatisch AI-antwoord op reviews

Elke gepubliceerde review kan een antwoord van de verkoper krijgen dat door AI wordt opgesteld, geschreven in de taal van de review. Belangrijkste instellingen:

• Publicatiemodus: Concept (in het begin aanbevolen, elk antwoord wacht op uw goedkeuring in het menu Reacties) of Direct publiceren.
• Toon: hartelijk, professioneel of beknopt.
• Ondertekening: wordt getoond als auteur van het antwoord (leeg betekent de sitenaam).
• Antwoorden vanaf beoordeling: 1 om op alle reviews te antwoorden. Dit is aan te raden, want juist negatieve reviews profiteren het meest van een antwoord.

Ingebouwde waarborgen: bij een beoordeling van 3/5 of lager biedt het antwoord excuses aan en verwijst het naar de klantenservice, zonder ooit een terugbetaling toe te zeggen. Het antwoord is beperkt tot ongeveer 70 woorden en verschijnt met de badge Officieel antwoord; het telt niet mee in de gemiddelde beoordeling en niet in de rich snippets.

Foto’s, stemmen en beloningscode

• Klantfoto’s: klanten voegen tot 3 foto’s toe aan hun review (instelbaar, maximaal 10) in de formaten jpg, png, webp en gif, tot 5 MB, weergegeven in een lightbox.
• Nuttig-stemmen: knoppen met de vraag “Was deze review nuttig?” met bescherming tegen dubbele stemmen per account en per gehast IP-adres. Ze verschijnen nooit bij antwoorden van de verkoper.
• Kortingscode: bij publicatie van zijn review ontvangt de klant een procentuele coupon (standaard 10 procent, 30 dagen geldig), uniek, eenmalig te gebruiken en beperkt tot zijn e-mailadres. Anti-misbruik: één beloning per e-mailadres en per product.

Formulier en weergave

• Titelveld voor de review, optioneel of verplicht.
• Minimale lengte van de review in tekens (standaard 10).
• Verdelingsblok van de beoordelingen (balken van 5★ tot 1★) boven de reviewlijst.
• Kleur van de sterren aanpasbaar (hexadecimaal, standaard #e7a11a).

Rich snippets volgens Schema.org

De plugin behoudt de ingebouwde AggregateRating- en Review-markup van WooCommerce en schoont die op: antwoorden van de verkoper worden uitgesloten van de markup en van de gemiddelden, zodat de sterren in Google kloppen. De optie kan in de instellingen worden uitgeschakeld, waarna alle reviewmarkup verdwijnt.

Cron: betrouwbare verzending

De verwerking (verzoeken, herinneringen, AI-samenvattingen, inhaalantwoorden) draait elk uur via WP-Cron. Omdat WP-Cron alleen bij een sitebezoek afgaat, stelt u voor betrouwbare verzending een echte servercron in:

1. Kopieer de cron-URL met token die wordt getoond in Settings → Cron.
2. Voeg die toe aan de cron van uw hostingpartij (of aan crontab), elke 15 tot 60 minuten, bijvoorbeeld met curl -s "URL" > /dev/null.

Een vergrendeling voorkomt dat twee verwerkingen tegelijk lopen. De knop Run processing now op het tabblad Request queue start op elk moment een handmatige verwerking.

CSV-import en export

Tabblad Import / Export:

• Export: alle productreviews met beoordeling, titel, verificatie-indicator en datums.
• Import: CSV met kopregel en de kolommen product_id of sku, author, email, rating, title, content, date (Y-m-d H:i:s, optioneel) en verified (1/0, optioneel). De beoordelingsstatistieken worden na de import automatisch herberekend.

Klantomgeving

Er wordt een tabblad Mijn reviews toegevoegd aan het klantaccount (Mijn account): elke klant vindt daar zijn reviews terug met moderatiestatus, sterren en verificatiebadge. Geeft het tabblad na activering een 404-melding, sla dan de permalinks opnieuw op via Instellingen → Permalinks → Wijzigingen opslaan.

AVG en gegevens

• Afmeldlink in elke verzoekmail, afgemelde adressen gehasht opgeslagen met SHA-256 en nooit leesbaar.
• IP-adressen van stemmers gehasht met de WordPress-salt.
• Enige uitgaande verbinding: de OpenAI API die u zelf beheert, en alleen als er een sleutel is ingesteld.
• Bij het verwijderen van de plugin worden de eigen tabellen en instellingen gewist, maar alle reviews blijven behouden (het zijn ingebouwde WooCommerce-reviews).

Probleemoplossing

• De verzoeken vertrekken niet: controleer of de functie is ingeschakeld, of er bestellingen de triggerstatus bereiken en of de cron draait (de laatste cyclus staat in AI tools). Stel de servercron-URL in.
• Geen AI-samenvatting: is de OpenAI-sleutel ingesteld? Is het minimum aantal gepubliceerde reviews bereikt? De samenvatting wordt bij een croncyclus gegenereerd, niet direct.
• Geen AI-antwoord: controleer de modus (in conceptmodus wacht het antwoord in Reacties → In afwachting), de ingestelde minimale beoordeling en de API-sleutel.
• E-mails komen niet aan: de plugin verstuurt via de mailer van WooCommerce. Test uw algemene e-mailconfiguratie (een SMTP-plugin is aan te raden).