Captcha Anti-Spam - reCAPTCHA, hCaptcha & Turnstile. Captcha Anti-Spam beschermt de formulieren van uw webwinkel (inloggen, registratie, wachtwoord vergeten, contact, nieuwsbrief, productbeoordeling en afrekenen als gast) tegen bots en spam met de provider van uw keuze: Google reCAPTCHA v2/v3, hCaptcha of Cloudflare Turnstile. De controle gebeurt aan de serverzijde via HTTPS, elk formulier heeft een eigen schakelaar en vertrouwde IP-adressen of ingelogde klanten kunnen worden overgeslagen. Geen programmeerwerk, geen aanpassingen aan het thema.
Captcha Anti-Spam beschermt de formulieren van uw webwinkel (inloggen, registratie, wachtwoord vergeten, contact, nieuwsbrief, productbeoordeling en afrekenen als gast) tegen bots en spam met de provider van uw keuze: Google reCAPTCHA v2/v3, hCaptcha of Cloudflare Turnstile. De controle gebeurt aan de serverzijde via HTTPS, elk formulier heeft een eigen schakelaar en vertrouwde IP-adressen of ingelogde klanten kunnen worden overgeslagen. Geen programmeerwerk, geen aanpassingen aan het thema.
1. Installatie
- Ga in het back-office naar Modules → Module Manager → Upload a module en selecteer de ZIP van de module.
- Klik na de installatie op Configure om het instellingenscherm te openen.
.local, .test, localhost) zijn altijd toegestaan. Zodra er een nieuwe versie beschikbaar is, wordt dit direct in de module getoond.Als u in plaats van de bevestiging de melding ‘Upload failed’ ziet, heeft PrestaShop de module mogelijk zonder bericht uitgeschakeld: uw instellingen en gegevens blijven behouden. Hoe u een module bijwerkt en wat u doet bij de melding ‘Upload failed’.
2. Configuratie: stap voor stap
Het scherm Configure is opgebouwd uit panelen: Captcha provider, Protected forms, Advanced en Rate limiting. Elk paneel heeft een eigen knop Save.
Captcha provider begin hier
De hoofdschakelaar plus uw provider en de bijbehorende sleutels.
- Enable protection: hoofdschakelaar voor de hele module. Uit = er wordt in het front-office geen captcha getoond of gevalideerd.
- Provider: kies Google reCAPTCHA v2 (selectievakje of onzichtbaar), reCAPTCHA v3, hCaptcha of Cloudflare Turnstile. Maak de sleutels aan in het dashboard van de provider.
- Site key: de openbare sleutel die in de pagina staat. Kan veilig zichtbaar zijn.
- Secret key: de privésleutel, alleen gebruikt voor de controle aan de serverzijde. Komt nooit in de browser.
- reCAPTCHA v3 score threshold: de minimale score (0,0 = bot, 1,0 = mens) die voor reCAPTCHA v3 wordt geaccepteerd. Gebruikelijke waarde:
0.5. - Widget theme: Light of Dark, passend bij uw webwinkel.
- Badge position: Bottom right, Bottom left of Inline (voor reCAPTCHA v3 / onzichtbaar en Turnstile).
Protected forms
Schakel de captcha per formulier in. Activeer alleen de formulieren die u echt wilt beschermen.
- Login, Registration, Forgot password, Contact form, Newsletter, Product review en Guest checkout: elk heeft een onafhankelijke schakelaar.
Advanced optioneel
Stel het gedrag van de controle nauwkeurig af. De standaardwaarden zijn verstandig; u kunt ze laten staan.
- Fail closed: als de captchadienst niet bereikbaar is: AAN blokkeert het verzenden, UIT laat het door.
- Skip for logged-in customers: toon of valideer de captcha niet voor ingelogde klanten.
- Verification timeout (s): maximaal aantal seconden dat op het verificatie-eindpunt van de provider wordt gewacht (1-30).
- Trusted IP whitelist: één IP-adres per regel (of gescheiden door komma's). Deze IP-adressen slaan de captcha volledig over.
- Verify hostname: weiger tokens die op een ander domein zijn opgelost (replay / token farming). Aanbevolen: AAN.
- Expected hostname (optional): overschrijf de hostnaam waartegen de captcha moet valideren. Laat leeg om automatisch het domein van uw webwinkel te gebruiken; scheid meerdere hosts met komma's (bijv. een CDN- of previewdomein).
- Verify action: voor reCAPTCHA v3 en Turnstile: weiger een token dat voor een ander formulier is gegenereerd. Aanbevolen: AAN.
Rate limiting optioneel
Blokkeer een IP-adres tijdelijk na te veel mislukte captchapogingen op hetzelfde formulier, een extra bescherming tegen brute force.
- Enable rate limiting: schakelt de begrenzer in.
- Max failed attempts: toegestane mislukte pogingen per IP-adres en formulier vóór een tijdelijke blokkering (1-1000).
- Window (minutes): lengte van het voortschrijdende venster waarin mislukte pogingen worden geteld (1-1440).
3. Controleer of het werkt
- Open een beschermde pagina in het front-office (bijv. de pagina voor inloggen of contact) en controleer dat de captchawidget verschijnt.
- Verzend het formulier zonder de captcha op te lossen, het moet met een antispambericht worden geweigerd.
- Controleer bij reCAPTCHA v3 / Turnstile dat de zwevende badge op de gekozen positie verschijnt.
- Als u uw IP-adres op de whitelist hebt gezet of ‘Skip for logged-in customers’ hebt ingeschakeld, controleer dan dat de captcha in die gevallen correct wordt overgeslagen.
4. FAQ
Welke provider moet ik kiezen?
Elk van de vier werkt. reCAPTCHA v2 toont een zichtbare uitdaging; reCAPTCHA v3 en Turnstile zijn onzichtbaar en gebaseerd op een score; hCaptcha is een alternatief met focus op privacy. Maak de bijbehorende site- en geheime sleutels aan in het dashboard van die provider.
Vertraagt het mijn webwinkel?
Nee. De controle gebeurt alleen aan de serverzijde wanneer een beschermd formulier wordt verzonden, en vertrouwde IP-adressen of ingelogde klanten kunnen volledig worden overgeslagen.
Moet ik mijn thema aanpassen?
Nee. De module voegt de widget toe via standaardhooks en is compatibel met elk thema.
Wat gebeurt er als de captchadienst uitvalt?
U beslist. Met Fail closed AAN wordt het verzenden geblokkeerd; met UIT wordt het formulier doorgelaten, zodat legitieme bezoekers nooit vastlopen.