README

👁 Build Status
👁 codecov.io
👁 Scrutinizer Code Quality
👁 Latest Stable Version
👁 Total Downloads
👁 Latest Unstable Version
👁 License

A spam protection field using the hCaptcha service for Silverstripe.

👁 hCaptcha screenshot

Requirements

• Silverstripe Framework
• Silverstripe Spam Protection
• Guzzle

Installation (with composer)

$ composer require 3dgoo/silverstripe-hcaptcha

Configuration

After installing the module via composer we must set the spam protector to HCaptchaProtector through a config yml file.

Create a app/_config/spamprotection.yml file and add the following details:

---
name: app-spamprotection
---
SilverStripe\SpamProtection\Extension\FormSpamProtectionExtension:
 default_spam_protector: X3dgoo\HCaptcha\Forms\HCaptchaProtector

X3dgoo\HCaptcha\Forms\HCaptchaField:
 site_key: "YOUR_SITE_KEY"
 secret_key: "YOUR_SECRET_KEY"

We generate our site key and secret key at https://www.hcaptcha.com/

The default language of the captcha will be set to the site language. This can be changed by setting the language_code variable to any of the available hCaptacha languages. If not set this will default to the current site locale:

X3dgoo\HCaptcha\Forms\HCaptchaField:
 language_code: "de"