Skip to content

Latest commit

 

History

History
36 lines (28 loc) · 1.54 KB

README.md

File metadata and controls

36 lines (28 loc) · 1.54 KB
Raw

Google reCAPTCHA for Craft CMS

Craft plugin to dispaly Google's new reCaptcha form widget and validate responses.

Install

  1. Upload entire recaptcha directory to craft/plugins on your server.
  2. Navigate to your site's Plugin settings from the Control Panel.
  3. Click Install
  4. Click on the 'reCAPTCHA for Craft' link to enter in your reCAPTCHA site key and secret key. You can get both keys from the Google reCaptcha console.

Usage

Templates

To display a reCAPTCHA widget in any template, use {{craft.recaptcha.render()}}.

User Registration Form

To use the Recaptcha in a front-end User Registration form, simply do this:

<form method="post" accept-charset="UTF-8" >
    {{ getCsrfInput() }}
    <input type="hidden" name="action" value="recaptcha/service/saveUser">

...and assuming it passes Recaptcha validation, the user registration will be passed along to users/saveUser

Verification

To verify a user's input, call the plugin's verify service from your own plugin:

$captcha = craft()->request->getPost('g-recaptcha-response');
$verified = craft()->recaptcha_verify->verify($captcha);
if($verified)
{
    //User is a person, not a robot. Go on and process the form!
} else {
    //Uh oh...its a robot. Don't process this form!
}

Roadmap

Currently this only supports the standard reCAPTCHA widget, but I hope to add some capabilities to adjust the styling and functionality.