wdmg/yii2-recaptcha

Google ReCaptcha widget for Yii2

1.0.2 2020-03-25 15:49 UTC

Requires

• yiisoft/yii2: ^2.0.33

MIT

• Alexsander Vyshnyvetskyy
• W.D.M.Group, Ukraine

• bootstrap
• recaptcha
• extension
• captcha
• yii
• widget
• yii2
• wdmg

README

Yii2 ReCaptcha

Google ReCaptcha widget for Yii2

Requirements

• PHP 5.6 or higher
• Yii2 v.2.0.33 and newest
• jQuery

Installation

To install the widget, run the following command in the console:

$ composer require "wdmg/yii2-recaptcha"

Usage

Add in your view:

<?php

use wdmg\widgets\ReCaptcha;
...

$form = ActiveForm::begin();
...
echo $form->field($model, 'userVerify')->widget(\wdmg\widgets\ReCaptcha::class, [
    'language' => 'uk-UA',
    'siteKey' => '_your_site_key_',
    'callbacks' => [
        'onload' => 'console.log("ReCaptcha: onload")',
        'success' => 'console.log("ReCaptcha: success")',
        'expired' => 'console.log("ReCaptcha: expired")',
        'error' => 'console.log("ReCaptcha: error")'
    ],
    'widgetOptions' => [
        'class' => 'pull-right'
    ]
]);
...
ActiveForm::end();

?>

And add in your model validation rules:

<?php

use wdmg\validators\ReCaptchaValidator;
...

/**
 * @return array the validation rules.
 */
public function rules()
{
    return [
        ...
        ['userVerify', ReCaptchaValidator::class, 'secretKey' => '_your_secret_key_', 'message' => 'Please confirm that you are not a robot.'],
        ...
    ];
}

?>

Widget options

Name	Type	Default	Description
language	string	en	See https://developers.google.com/recaptcha/docs/language.
siteKey	string	null	Your public sitekey.
apiURL	string	null	The URL for reCaptcha API (//www.google.com/recaptcha/api.js or use alternative URL if necessary '//www.recaptcha.net/recaptcha/api.js').
callbacks	array	[]	Javascript callback`s for reCaptcha events.
render	string	explicit	Optional. Whether to render the widget explicitly. Defaults to onload, which will render the widget in the first g-recaptcha tag it finds..
theme	string	light	Optional. The color theme of the widget
type	string	null	Optional. The type of CAPTCHA to serve.
badge	string	null	Optional. Reposition the reCAPTCHA badge. 'inline' lets you position it with CSS.
size	string	null	Optional. The size of the widget. Use invisible value for create an invisible widget bound to a div and programmatically executed.
tabIndex	integer	0	Optional. The tabindex of the widget and challenge. If other elements in your page use tabindex, it should be set to make user navigation easier.
isolated	boolean	false	Optional. For plugin owners to not interfere with existing reCAPTCHA installations on a page. If true, this reCAPTCHA instance will be part of a separate ID space.
options	array	[]	Default input options.
widgetOptions	array	[]	Default widget options.

You can use the application parameters in config or in bootstrap, like Yii::$app->params("recaptcha.siteKey") = "***" to store the public and private key, as well as the URL to request the API and verify. Currently, the widget and validator polls the following parameters: recaptcha.siteKey, recaptcha.apiURL, recaptcha.secretKey, recaptcha.verifyURL

This widget supports Google reCaptcha v2 in a normal and invisible way. Support for v3 is planned.

Status and version [in progress development]

• v.1.0.2 - Up to date dependencies
• v.1.0.1 - Added support for siteKey, apiURL, secretKey, verifyURL from application params.
• v.1.0.0 - First release. Added widget and validator.