angelxmoreno/recaptcha

Recaptcha plugin for CakePHP

Recaptcha Plugin for CakePHP 2.x

The Recaptcha plugin for CakePHP provides spam protection in an easy use helper.

Usage

To use the recaptcha plugin its required to include the following two lines in your /app/Config/bootstrap.php file.

Configure::write('Recaptcha.publicKey', 'your-public-api-key');
Configure::write('Recaptcha.privateKey', 'your-private-api-key');

Don't forget to replace the placeholder text with your actual keys!

Keys can be obtained for free from the Recaptcha website.

Controllers that will be using recaptcha require the Recaptcha Component to be included. Through inclusion of the component, the helper is automatically made available to your views.

In the view simply call the helpers display() method to render the recaptcha input:

echo $this->Recaptcha->display();

You could select another theme, setup it as parameter, for istance:

echo $this->Recaptcha->display(array('recaptchaOptions'=>array('theme' => 'blackglass')));

For the complete list of themes, take a look here: http://code.google.com/intl/it-IT/apis/recaptcha/docs/customization.html.

To check the result simply do something like this in your controller:

if ($this->request->is('post')) {
	if ($this->Recaptcha->verify()) {
		// do something, save you data, login, whatever
	} else {
		// display the raw API error
		$this->Session->setFlash($this->Recaptcha->error);
	}
}

Requirements

• PHP version: PHP 5.2+
• CakePHP version: Cakephp 2.0

Support

For support and feature request, please visit the Recaptcha Plugin Support Site.

For more information about our Professional CakePHP Services please visit the Cake Development Corporation website.

Branch strategy

The master branch holds the STABLE latest version of the plugin. Develop branch is UNSTABLE and used to test new features before releasing them.

Previous maintenance versions are named after the CakePHP compatible version, for example, branch 1.3 is the maintenance version compatible with CakePHP 1.3. All versions are updated with security patches.

Contributing to this Plugin

Please feel free to contribute to the plugin with new issues, requests, unit tests and code fixes or new features. If you want to contribute some code, create a feature branch from develop, and send us your pull request. Unit tests for new features and issues detected are mandatory to keep quality high.

License

Copyright 2009-2010, Cake Development Corporation

Licensed under The MIT License
Redistributions of files must retain the above copyright notice.

Copyright

Copyright 2009-2011
Cake Development Corporation
1785 E. Sahara Avenue, Suite 490-423
Las Vegas, Nevada 89104
http://cakedc.com