silverware/recaptcha

SilverWare Recaptcha Module.

Installs: 125

Dependents: 0

Suggesters: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

Type:silverstripe-vendormodule

1.0.0 2018-01-22 02:56 UTC

README

Latest Stable Version Latest Unstable Version License

Provides a Google Recaptcha Spam Guard for use with SilverStripe v4 forms.

Contents

Requirements

Installation

Installation is via Composer:

$ composer require silverware/recaptcha

Configuration

In order to use Recaptcha as the default spam guard for all forms, you will need to set it as the DefaultSpamGuard in your YAML configuration:

SilverStripe\Core\Injector\Injector:
  DefaultSpamGuard:
    class: SilverWare\Recaptcha\Guards\RecaptchaGuard

Additionally, you will need to create public and private API keys via the Google Recaptcha admin. Google refers to these as a "site key" and a "secret", respectively. Once you have created your keys, add them to your YAML configuration:

SilverWare\Recaptcha\Fields\RecaptchaField:
  public_api_key: '<your-site-key>'
  private_api_key: '<your-secret>'

Each RecaptchaField has a config array which defines the data attributes for the Recaptcha element. You can define the default config by adding the following to your YAML configuration:

SilverWare\Recaptcha\Fields\RecaptchaField:
  default_config:
    theme: dark
    size: compact

This would configure each instance of Recaptcha to use the dark theme and compact size.

Issues

Please use the issue tracker for bug reports and feature requests.

Contribution

Your contributions are gladly welcomed to help make this project better. Please see contributing for more information.

Attribution

Maintainers

Colin Tucker Praxis Interactive
Colin Tucker Praxis Interactive

License

BSD-3-Clause © Praxis Interactive