README

Laravel package for Yandex Smart Captcha. This is a lightweight package which focuses on the backend validation of Yandex Smart Captcha.

Installation

To get started, use Composer to add the package to your project's dependencies:

composer require msglaravel/yandex-smart-captcha

Add to your .env file:

YANDEX_SMARTCAPTCHA_ENDPOINT=https://smartcaptcha.cloud.yandex.ru
YANDEX_SMARTCAPTCHA_SITEKEY=sitekey
YANDEX_SMARTCAPTCHA_SECRET=secret

Optionally, you can publish the config file:

php artisan vendor:publish --provider="MSGLaravel\YandexSmartCaptcha\YandexSmartCaptchaServiceProvider"

Usage

Init Recaptcha Javascript

Желательно добавлять скрипт вызова библиотеки Yandex Smart Captcha в самом верху страницы. Например, в вашем header Blade-шаблоне:

@yandexSmartCaptchaScript                  {{-- Basic use --}}
@yandexSmartCaptchaScript('myOnloadCb')    {{-- With custom onload callback --}}

Forms

Insert the captcha widget into your form using Blade include:

    @include('yandex-smart-captcha::captcha')

If you need a version with a custom onload function, use:

    @include('yandex-smart-captcha::captcha-extend')

Use it together with @yandexSmartCaptchaScript('onloadFunction').

<form method="post" action="/register">
    @include('yandex-smart-captcha::captcha')
    <input type="submit" value="Register"></input>
</form>

Validation

In your controller:

use MSGLaravel\YandexSmartCaptcha\Rules\YandexSmartCaptchaRule;

$request->validate([
    // ...
    'smart-token' => ['required', new YandexSmartCaptchaRule()],
]);

You can customize the error message for the captcha in your controller (applies to all errors of this rule):

use MSGLaravel\YandexSmartCaptcha\Rules\YandexSmartCaptchaRule;

$request->validate(
    [
        'smart-token' => ['required', new YandexSmartCaptchaRule()],
    ],
    [
        'smart-token' => 'Ошибка проверки капчи. Попробуйте ещё раз.',
    ]
);

Advanced

Override templates: Copy captcha.blade.php or captcha-extend.blade.php from resources/views/vendor/yandex-smart-captcha/ to your project for full customization.

Localization & Custom Error Messages

This package includes localized validation error messages for Yandex Smart Captcha in both Russian and English.

If you want to customize error messages for your project, publish the language files to your application:

php artisan vendor:publish --provider="MSGLaravel\YandexSmartCaptcha\YandexSmartCaptchaServiceProvider" --tag=lang

This command will copy the language files to:

resources/lang/vendor/yandex-smart-captcha/ru/validation.php
resources/lang/vendor/yandex-smart-captcha/en/validation.php

You can now edit these files to override any validation error messages as needed.

Note:

Laravel will use your published files in resources/lang/vendor/yandex-smart-captcha instead of the package defaults.