craft-recaptcha
craft-recaptcha copied to clipboard
Google reCAPTCHA for Craft CMS
Craft plugin to dispaly Google's new reCaptcha form widget and validate responses.
Install
- Upload entire recaptcha directory to
craft/pluginson your server. - Navigate to your site's Plugin settings from the Control Panel.
- Click Install
- 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.