z1bun / yii2-module-recaptcha-v3
This is reCAPTCHA v3 for Yii2.
Installs: 17
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 1
Forks: 14
Open Issues: 0
Type:yii2-extension
Requires
- ext-curl: *
- yiisoft/yii2: ~2.0.15
README
Adds recaptcha-v3 into yii2 project
Installation
The preferred way to install this extension is through composer.
Either run
php composer.phar require --prefer-dist z1bun/yii2-module-recaptcha-v3 "dev-master"
or add
"z1bun/yii2-module-recaptcha-v3": "dev-master"
to the require section of your composer.json
file.
Usage
Once the extension is installed, simply use it in your code by :
add this to your components main.php
'components' => [ ... 'reCaptcha3' => [ 'class' => 'z1bun\recaptcha3\ReCaptcha', 'siteKey' => env('recaptcha_site_key'), 'secretKey' => env('recaptcha_secret_key'), ],
and in your model
acceptance_score the minimum score for this request (0.0 - 1.0) or null
public $reCaptcha; public function rules() { return [ ... [['reCaptcha'], \z1bun\recaptcha3\ReCaptchaValidator::class, 'acceptance_score' => 0] ]; }
<?= $form->field($model, 'reCaptcha')->widget(\z1bun\recaptcha3\ReCaptchaWidget::class) ?>
For tests
When use YII_ENV_TEST
in index-test.php
then disabled recaptcha's validate:
defined('YII_ENV') or define('YII_ENV', 'test');
TODO
Option to hide the badge and display a link to recaptcha terms of use in the form