A spam protector extension using Google's reCAPTCHA 2
Provides a FormField which allows form to validate for non-bot submissions
using Google's reCAPTCHA v2 service.
Best installed via composer. You may clone the repo or download the zip, however you should find a directory called
recaptcha with all files in your silverstripe root folder.
composer require kmedia/silverstripe-recaptcha
After installing the module via composer or manual install you must set the spam protector to ReCaptchaProtector, this needs to be set in your site's config file normally this is
SilverStripe\SpamProtection\Extension\FormSpamProtectionExtension: default_spam_protector: Kmedia\ReCaptcha\ReCaptchaProtector
Finally, add the "spam protection" field to your form fields.
You have to create your
secretkey in the environments (
.env) file, which you can get from the reCAPTCHA page. These configuration options must be added to your site's yaml config typically this is
Kmedia\ReCaptcha\ReCaptchaField: theme: "light" #Default theme color (optional, light or dark, defaults to light) size: "normal" #Default size (optional, normal, compact or invisible, defaults to normal) badge: "bottomright" #Default badge position (bottomright, bottomleft or inline, defaults to bottomright)
If you want to add a field label or help text to the Captcha field you can do so like this:
$form->enableSpamProtection() ->fields()->fieldByName('Captcha') ->setTitle("Spam protection") ->setDescription("Please tick the box to prove you're a human and help us stop spam.");
Module rating system helping users find modules that are well supported. For more on how the rating system works visit Module standards
Score not correct? Let us know there is a problem