DataFirefly Geverifieerde Reviews: volledige gids

Vereisten en installatie

DataFirefly Geverifieerde Reviews werkt op PrestaShop 8.0 tot 9.0 met PHP 8.0 tot 8.4. Sinds versie 1.1.0 dekt één ZIP beide branches: er is bij het downloaden geen keuze meer tussen een PS 8- en een PS 9-versie.

1. Open in uw backoffice Modules → Modulebeheer en klik op Een module installeren.
2. Upload het bestand dfreviews.zip dat u vanuit uw DataFirefly-account hebt gedownload.
3. Klik op Configureren zodra de installatie is afgerond.

De installatie maakt zes eigen tabellen aan (reviews, media, aanvragen, nuttig-stemmen, AI-samenvattingen, statistieken) en voegt een tabblad Geverifieerde Reviews toe onder het menu Catalogus. Vanuit dat tabblad modereert u de reviews; het configuratiescherm blijft bereikbaar via het modulebeheer.

Het versturen van reviewaanvragen instellen

Dit is de kern van de module. Twee instellingen, in de sectie Algemene instellingen:

• Activeren na status: Verzonden (standaard) of Geleverd. Kies de status die in uw daadwerkelijke flow aangeeft dat de klant het product in handen heeft.
• Wachttijd vóór verzending: standaard 3 dagen. Reken de levertijd plus enkele dagen gebruik. Voor een product dat pas na gebruik te beoordelen is (cosmetica, matras), verhoogt u naar 10 of 15 dagen.

Wanneer een bestelling de gekozen status bereikt, wordt een aanvraag in de wachtrij geplaatst met haar berekende verzenddatum. Ze wordt niet onmiddellijk verzonden: dat doet de CRON.

De CRON instellen

Zonder CRON vertrekt er geen enkele e-mail. De aan te roepen URL staat bovenaan het configuratiescherm van de module; ze bevat een uniek token dat bij de installatie is gegenereerd. Plan ze elk uur in bij uw host:

0 * * * * wget -q -O /dev/null "CRON_URL_GETOOND_IN_DE_MODULE"

Bij elke doorloop voert de CRON drie bewerkingen uit en geeft hij een JSON-samenvatting van het verrichte werk terug:

• versturen van de vervallen aanvragen, in batches van 50;
• versturen van de herinneringen voor aanvragen zonder antwoord;
• laten verlopen van aanvragen ouder dan 60 dagen.

Herinneringen en promocode als beloning

De sectie Herinnering activeert een tweede e-mail als de review na een instelbare termijn niet is geplaatst (standaard 5 dagen, geteld vanaf de eerste verzending). Per aanvraag wordt maar één herinnering verzonden.

De sectie Stimulerende promocode genereert een kortingsbon zodra een review door een geïdentificeerde klant wordt gepubliceerd. U bepaalt het percentage (standaard 10%) en de geldigheidsduur (30 dagen). De aangemaakte code is een native PrestaShop-winkelwagenregel, persoonlijk en voor eenmalig gebruik, u vindt haar dus terug in Catalogus → Kortingen.

De AI-samenvatting activeren

Vul uw OpenAI-API-sleutel in in de sectie Kunstmatige Intelligentie en kies een model. gpt-4o-mini is de standaard: het voordeligste, in de orde van een halve cent per samenvatting.

De samenvatting wordt geactiveerd vanaf drie gepubliceerde reviews op een product. De module stuurt tot 100 reviews naar OpenAI en haalt drie gestructureerde elementen op: sterke punten, zwakke punten, algemene synthese. Het resultaat wordt gecachet per product, per winkel en per taal, en daarna bovenaan de reviewzone van de productpagina getoond.

U kunt de weergave uitschakelen zonder de sleutel te verwijderen met de optie De AI-samenvatting op de productpagina tonen.

Rich snippets en frontoffice-weergave

Wanneer de optie Rich Snippets actief is, injecteert de module gestructureerde Schema.org-gegevens (AggregateRating, Review, Offer, Brand) op elke productpagina die het geconfigureerde minimumaantal reviews bereikt. Controleer de weergave met de test voor zoekresultaten met rich results van Google nadat de robot is langsgekomen.

Voor de weergave haakt de module in op de native hooks van het thema:

• displayProductAdditionalInfo: de sterren en de gemiddelde score onder de producttitel;
• displayProductExtraContent: het tabblad “Klantreviews” met de lijst, de filters en het formulier;
• displayProductListReviews: de sterren op de categorielijsten;
• displayCustomerAccount: de link “Mijn reviews” in het klantaccount.

Deze hooks bestaan in de thema’s Classic en Hummingbird. Op een maatwerkthema dat ze heeft verwijderd, moeten ze in de betreffende templates worden hersteld, anders worden de reviews nergens getoond.

Reviews modereren

Het scherm Catalogus → Geverifieerde Reviews toont een dashboard (totaal, gepubliceerd, in afwachting, gemeld, gemiddelde score, aanvragen in wachtrij), gevolgd door de volledige reviewlijst.

Standaard wacht elke review op uw goedkeuring. Activeer Automatische goedkeuring als u de voorkeur geeft aan onmiddellijke publicatie. Vanuit de lijst kunt u in bulk goedkeuren of afwijzen, en een review openen om te bewerken of te beantwoorden.

Het antwoord van de winkelier wordt publiek onder de review getoond. Is een OpenAI-sleutel geconfigureerd, dan stelt een knop AI-antwoordsuggestie een concept voor dat bij de toon van de review past, altijd na te lezen en aan te passen vóór het opslaan, nooit ongewijzigd te publiceren.

Klantfoto’s

Klanten kunnen tot N foto’s per review bijvoegen (standaard 3). Geaccepteerde formaten: JPEG, PNG en WebP, maximaal 5 MB per bestand. Het echte bestandstype wordt bij ontvangst gecontroleerd, onafhankelijk van de bestandsnaam.

De afbeeldingen worden opgeslagen in modules/dfreviews/uploads/. Neem deze map op in uw back-ups: een review verwijderen verwijdert ook de bijbehorende bestanden.

Reviews importeren en exporteren

Vanuit het scherm Geverifieerde Reviews produceert de knop CSV exporteren een UTF-8-bestand gescheiden door puntkomma’s, direct leesbaar in Excel. Het importblok, er net onder, laat u een bestand in hetzelfde formaat laden.

Twee kolommen zijn verplicht: id_product en rating (van 1 tot 5). De andere zijn optioneel: customer_name, customer_email, title, content, id_customer, id_order, verified_purchase, active, merchant_reply en date_add. Regels waarvan het product niet bestaat worden genegeerd en gemeld. Vink Automatisch goedkeuren aan om de geïmporteerde reviews direct te publiceren.

De eenvoudigste manier om een migratie vanaf Trustpilot of een oude module voor te bereiden: exporteer eerst een bestand vanuit de module om de exacte kopregel op te halen en giet daar uw gegevens in.

Multistore en meertaligheid

De volledige configuratie is per subwinkel onafhankelijk: OpenAI-sleutel, triggerstatus, termijnen, kleuren, beloning. De reviews worden gescheiden per id_shop, dus eenzelfde product dat in meerdere winkels staat, kan afhankelijk van de context verschillende reviewsets tonen.

De reviews en de AI-samenvattingen worden opgeslagen met hun id_lang. Een samenvatting wordt gegenereerd voor de taal waarin ze wordt aangevraagd.

Van PrestaShop 8 naar PrestaShop 9

Er is geen enkele gegevensmigratie nodig: het schema is identiek op beide branches. Vervang de module door versie 1.1.0 vóór of na uw PrestaShop-upgrade, in de volgorde die u schikt.

Werkt u bij vanaf een 1.0.x op een winkel die al naar PS 9 is overgestapt, dan zijn twee punten goed om te weten: versies ouder dan 1.1.0 installeren niet op PS 9 (het registreren van hooks zonder bijbehorende methode wordt daar geweigerd), en de bestaande configuratie blijft bij de update volledig behouden.

Probleemoplossing

Er wordt geen enkele aanvraagmail verzonden. Controleer eerst of de CRON daadwerkelijk draait door de URL handmatig aan te roepen: het JSON-antwoord toont het aantal verzendingen. Controleer daarna de geconfigureerde triggerstatus en vervolgens de e-mailinstellingen van de winkel in Geavanceerde instellingen → E-mail.

De sterren verschijnen niet op de productpagina. Het thema roept waarschijnlijk de hierboven genoemde hooks niet aan. Controleer ook of minstens één review is gepubliceerd: zonder actieve review wordt niets getoond.

De AI-samenvatting wordt niet gegenereerd. Er zijn minimaal drie gepubliceerde reviews nodig en een geldige OpenAI-sleutel met tegoed. De API-fouten worden gelogd in Geavanceerde instellingen → Logboeken.

De sterren verschijnen niet in Google. De indexering duurt enkele dagen tot enkele weken. Controleer de markup met de test voor rich results en controleer of geen andere SEO-module een tweede, concurrerend Product-blok op dezelfde pagina injecteert.

De CSV-import doet niets. Dat was een gebrek van de 1.0.x-versies, verholpen in 1.1.0.