Google ReCaptcha widget for Yii2

Installs: 3

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 2

Forks: 0

Open Issues: 0


1.0.2 2020-03-25 15:49 UTC

This package is auto-updated.

Last update: 2022-01-04 15:18:27 UTC


Yii2 Downloads Packagist Version Progress GitHub license

Yii2 ReCaptcha

Google ReCaptcha widget for Yii2


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


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

$ composer require "wdmg/yii2-recaptcha"


Add in your view:


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'


And add in your model validation rules:


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.