3dgoo/silverstripe-hcaptcha

A spam protector and form field using hCaptcha for Silverstripe

3.0.0 2025-06-12 06:32 UTC

Requires

• guzzlehttp/guzzle: >=7
• silverstripe/framework: ^6
• silverstripe/spamprotection: ^5

Requires (Dev)

• phpunit/phpunit: ^11
• squizlabs/php_codesniffer: *

MIT

• 3dgoo

• silverstripe
• spamprotection
• hcaptcha

README

A spam protection field using the hCaptcha service for Silverstripe.

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"