himiklab/yii2-recaptcha-widget Yii2 Google reCAPTCHA widget

captchawidgetrecaptchagoogle

Google reCAPTCHA widget for Yii2

Based on reCaptcha API 2.0.

Installation

The preferred way to install this extension is through composer.

  • Either run
php composer.phar require --prefer-dist "himiklab/yii2-recaptcha-widget" "*"

or add

"himiklab/yii2-recaptcha-widget" : "*"

to the require section of your application's composer.json file.

  • Sign up for an reCAPTCHA API keys.

  • Configure the component in your configuration file (web.php). The parameters siteKey and secret are optional. But if you leave them out you need to set them in every validation rule and every view where you want to use this widget. If a siteKey or secret is set in an individual view or validation rule that would overrule what is set in the config.
'components' => [
    'reCaptcha' => [
        'name' => 'reCaptcha',
        'class' => 'himiklab\yii2\recaptcha\ReCaptcha',
        'siteKey' => 'your siteKey',
        'secret' => 'your secret key',
    ],
    ...
  • Add ReCaptchaValidator in your model, for example:
public $reCaptcha;

public function rules()
{
  return [
      // ...
      [['reCaptcha'], \himiklab\yii2\recaptcha\ReCaptchaValidator::className(), 'secret' => 'your secret key', 'uncheckedMessage' => 'Please confirm that you are not a bot.']
  ];
}

or just

public function rules()
{
  return [
      // ...
      [[], \himiklab\yii2\recaptcha\ReCaptchaValidator::className(), 'secret' => 'your secret key']
  ];
}

or simply

public function rules()
{
  return [
      // ...
      [[], \himiklab\yii2\recaptcha\ReCaptchaValidator::className()]
  ];
}

Usage

For example:

<?= $form->field($model, 'reCaptcha')->widget(
    \himiklab\yii2\recaptcha\ReCaptcha::className(),
    ['siteKey' => 'your siteKey']
) ?>

or

<?= \himiklab\yii2\recaptcha\ReCaptcha::widget([
    'name' => 'reCaptcha',
    'siteKey' => 'your siteKey',
    'widgetOptions' => ['class' => 'col-sm-offset-3']
]) ?>

or

<?= $form->field($model, 'reCaptcha')->widget(\himiklab\yii2\recaptcha\ReCaptcha::className()) ?>

or simply

<?= \himiklab\yii2\recaptcha\ReCaptcha::widget(['name' => 'reCaptcha']) ?>

Multiple reCaptcha on a one page

Each the reCaptcha instance must have unique id

<?= $form1->field($modelForm1, 'reCaptcha')
    ->widget(\himiklab\yii2\recaptcha\ReCaptcha::className(), [
        'widgetOptions' => [
            'id' => 're-captcha-form1',
        ]
    ]) ?>

<?= $form2->field($modelForm2, 'reCaptcha')
    ->widget(\himiklab\yii2\recaptcha\ReCaptcha::className(), [
        'widgetOptions' => [
            'id' => 're-captcha-form2',
        ]
    ]) ?>

If you use one model in a few forms (ex. feedback form) must use unique ids.

Notes

Exclude a reCaptcha field from ajax validation. It creates problem.

Resources

Statistics

Downloads
GitHub Stars
GitHub Forks

Releases

Comments



1.0.7 is the latest of 7 releases



MIT license
Stats
87 github stars & 69 github forks
281 downloads in the last day
8153 downloads in the last 30 days
91102 total downloads