README.md

Silverstripe hCaptcha spam protection

A spam protection field for Silverstripe using the hCaptcha service.

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"