Klantreviews.online voor PrestaShop
===================================

Module: klantreviews
Versie: 1.0.0
Vereist: PrestaShop 1.7.6 of nieuwer, PHP 7.4 of nieuwer
Licentie: Academic Free License 3.0

Geeft afgeronde bestellingen door aan Klantreviews.online, dat op het door jou
gekozen moment om een review vraagt.


Welke gegevens je winkel verstuurt
----------------------------------

Bij elke doorgegeven bestelling gaat er naar https://klantreviews.online:

* Het bestelnummer
* Het e-mailadres van de klant
* De voornaam van de klant
* Het moment waarop de bestelling is geplaatst
* De artikelen, alleen als je dat aanzet: artikelnummer, naam, link en afbeelding
* De vestigingscode, alleen als je die invult

Er gaat geen adres mee, geen bedrag, geen betaalgegevens, geen telefoonnummer en
geen aantekening bij de bestelling.

Je bent zelf verantwoordelijk voor de gegevens van je klanten. Klantreviews.online
verwerkt ze in jouw opdracht; de voorwaarden staan op klantreviews.online.


Installeren
-----------

1. Zip de map `klantreviews` en upload hem via Modules, Module uploaden.
2. Maak bij Klantreviews.online onder Ontwikkelaars een API-sleutel aan met het
   recht om bestellingen aan te leveren.
3. Open de instellingen van de module en plak die sleutel.
4. Kies bij welke bestelstatus er wordt doorgegeven. Verzonden is het gewone
   antwoord; kies Betaald als je alles digitaal levert. Kies nooit Geannuleerd of
   Terugbetaald.


De wachtrij
-----------

PrestaShop heeft geen taakplanner zoals WooCommerce die heeft. Deze module houdt
daarom zelf een kleine wachtrij bij, in de tabel `klantreviews_queue`.

Er wordt nooit iets verstuurd tijdens het afrekenen: dan zou een klant met zijn
kaartgegevens op onze server wachten. De wachtrij loopt leeg terwijl er bezoekers
in de winkel zijn, hooguit drie bestellingen per verzoek.

Heeft je winkel 's nachts geen bezoekers, zet dan het cron-adres van het
instellingenscherm in je crontab. Eens per kwartier is ruim voldoende.


Als er iets misgaat
-------------------

De uitkomst komt als privé-aantekening bij de bestelling te staan. Dat is de plek
waar je toch al kijkt als je je afvraagt waarom een klant geen uitnodiging kreeg.

Een netwerkfout of een storing wordt opnieuw geprobeerd, met oplopende tussenpozen
tot ruim een dag, zes keer. Een geweigerde sleutel of een bestelling zonder
e-mailadres wordt niet herhaald: dat komt niet goed door het opnieuw aan te
bieden.
