danny3b/recaptcha

Easily use Google Recaptcha in CakePHP 3.2+ projects

, _(*1)

Integrate Google Recaptcha v2 to your CakePHP project

Installation

You can install this plugin into your CakePHP application using composer., _(*2)

The recommended way to install composer packages is:, _(*3)

composer require crabstudio/recaptcha

Or add the following lines to your application's composer.json:, _(*4)

"require": {
    "crabstudio/recaptcha": "^2.0"
}

followed by the command:, _(*5)

composer update

Load plugin

From command line:, _(*6)

bin/cake plugin load Recaptcha

Or this line to the end of Your_project\config\bootstrap.php, _(*7)

Plugin::load('Recaptcha');

Load Component and Configure

Override default configure from loadComponent:, _(*8)

$this->loadComponent('Recaptcha.Recaptcha', [
    'enable' => true,     // true/false
    'sitekey' => 'your_site_key', //if you don't have, get one: https://www.google.com/recaptcha/intro/index.html
    'secret' => 'your_secret',
    'type' => 'image',  // image/audio
    'theme' => 'light', // light/dark
    'lang' => 'vi',      // default en
    'size' => 'normal'  // normal/compact
]);

Usage

Display recaptcha in your view:, _(*9)

    <?= $this->Form->create() ?>
    <?= $this->Form->control('email') ?>
    <?= $this->Recaptcha->display() ?>  // Display recaptcha box in your view, if configure enable = false, nothing to display here
    <?= $this->Form->button(__('Submit')) ?>
    <?= $this->Form->end() ?>

Enable button on callback if recaptcha successful:, _(*10)

    <?= $this->Form->button(__('Submit'), ['disabled']) ?>

    <script>
        function recaptcha_callback(){
            $('button[type="submit"]').prop("disabled", false);
        }
    </script>

Verify in your controller function, _(*11)

    public function forgotPassword() {
        if ($this->request->is('post')) {
            if ($this->Recaptcha->verify()) { // if configure enable = false, always return true
                //do something here
            }
            $this->Flash->error(__('Please pass Google Recaptcha first'));
        }
    }

Done, _(*12)