README

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.