3dgoo/silverstripe-hcaptcha

A spam protector and form field using hCaptcha

Installs: 936

Dependents: 0

Suggesters: 0

Security: 0

Stars: 5

Watchers: 2

Forks: 1

Type:silverstripe-vendormodule

2.0.2 2024-01-10 11:28 UTC

This package is auto-updated.

Last update: 2024-04-10 12:08:30 UTC


README

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

A spam protection field for Silverstripe using the hCaptcha service.

hCaptcha screenshot

Requirements

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"