YaSmartCaptcha - защитите ваши формы от спама умной капчей от Яндекс

Привет!

Представляю вам небольшой пакет, который упростит интеграцию Яндекс SmartCaptcha на ваш сайт.

Это дополнение позволит использовать SmartCaptcha от Яндекс на вашем сайте на MODX в формах, созданных с использованием сниппета FormIt (ну а также других компонентах, являющимися надстройкой над FormIt, такими как AjaxForm, SendIt).

Регистрация в Yandex Cloud

Перед началом работы ознакомьтесь с инструкцией и зарегистрируйтесь в сервисе: cloud.yandex.ru/ru/docs/smartcaptcha/quickstart

Для работы с капчей вам будет необходимо создать платежный аккаунт, для чего потребуется ввести данные банковской карты или зарегистрировать его на организацию.

После прохождения регистрации создайте свою первую капчу и вы получите 2 ключа (клиентский и серверный). У Яндекса хорошая и понятная документация, проблем быть не должно.

Это бесплатно?
На момент публикации (январь 2024) Яндекс дает 250000 бесплатных проверок на спам в месяц, больше уже за деньги.

Настройка компонента

Перейдите в системные настройки, выберите пространство yasmartcaptcha, и пропишите ключи:

yasmartcaptcha_client_key — Клиентский ключ
yasmartcaptcha_server_key — Серверный ключ

Добавление капчи в форму

Вообще принцип работы такой же, как в Google Recaptcha v2, если вы пользовались им ранее, то трудностей быть не должно.

Шаг 1. В том месте, где вам нужно добавить капчу, добавьте некешированный вызов сниппета:

[[!YaSmartCaptcha]]

Данный сниппет подключит на страницу (перед закрывающимся body) скрипт

https://smartcaptcha.yandexcloud.net/captcha.js

и добавит html блок с капчей.

У сниппета единственный параметр tpl, имеющий значение по умолчанию tpl.YaSmartCaptcha.

Шаг 2. Добавьте хук YaSmartCaptcha к FormIt, например:

[[!FormIt?
&hooks=`YaSmartCaptcha,email`
..
]]

Если проверка не будет пройдена, то хук установит сразу 2 одинаковые ошибки с ключами smart-token и yasmartcaptcha.

Можете использовать любой ключ для показа ошибки, они равнозначны, просто первая соответствует названию hidden поля, создаваемого SmartCaptcha, а вторая названию компонента.

Ссылки

Ссылка на github:
https://github.com/createit-ru/YaSmartCaptcha

Скачать пакет:
https://modstore.pro/packages/utilities/yasmartcaptcha
Также ссылка на транспортный пакет есть на github в разделе Releases (правда не гарантирую, что раздел Releases не забуду обновлять).

В заключение

Компонент бесплатный, но если вам понравился и пригодился — можно поблагодарить финансово по ссылке:

Ваши благодарности ускорят внедрение новых функций, увеличат мою мотивацию, заставят внимательнее прислушиваться к пожеланиям!

Наумов Алексей

12 января 2024, 15:22

6 689

Комментарии: 37

Евгений Лазарев

20 сентября 2024, 15:22

Подскажите пожалуйста, я правильно понял что YaSmartCaptcha работает только с компонентом FormIt? Пытался ее включить для компонента Login, но даже с незаполненным secret_key проходило валидацию. Удалось решить доработав сниппет YaSmartCaptcha:

if ((isset($formit) || isset($login)) && isset($hook)) {

Наумов Алексей

20 сентября 2024, 16:19

Ага, верное замечание.

Я только для formit писал. И исправили верно сниппет.

Если я доберусь до github и будет свободное время — нужно сделать обновление)

Может PR сделаете, чтобы не забыл? Или issue)

Евгений Лазарев

25 сентября 2024, 16:17

Готово. Добавил. Спасибо Вам.

Наумов Алексей

04 октября 2024, 09:35

Я выпустил обновление с этим исправлением. Теперь компонент работает с FormIt и Login

Роман

22 ноября 2024, 08:43

Подскажите, если на странице будет две формы, они будут работать? К примеру reCaptchaV3 этого сделать не может, нужно через костыль в виде скрипта, который сбрасывал через указанное время отправку и обновлял ключи.

Евгений Лазарев

27 ноября 2024, 12:36

Добрый день. Появилась новая ошибка:

27.11.2024 	12:30:20 	ERROR 	/www/site.ru/core/components/yasmartcaptcha/model/yasmartcaptcha.class.php 	60

Recoverable error: Object of class Login could not be converted to string
27.11.2024 	12:30:20 	ERROR 	/www/site.ru/core/components/yasmartcaptcha/model/yasmartcaptcha.class.php 	60

Recoverable error: Object of class LoginHooks could not be converted to string

Видимо при превращении в строку в массиве $config присутствует объект Login и LoginHooks.

Виктор

30 января 2025, 17:25

Приветствую! Подскажите, как можно добавить капчу в несколько форм на странице? Делаю несколько — работает только первая.

Наумов Алексей

30 января 2025, 17:50

Добрый день! Честно говоря, как помню, там нет привязок к id элемента или чего-то такое, по идее должны работать все. Может ошибки есть в консоли браузера или в логах?

Виктор

30 января 2025, 23:08

Вроде, ничего по капче не увидел. Вот пример страницы.
titanremont.ru/pages-2024

Здесь отображается капча в форме на странице, а в модалке из шапки капчи нет. Но в коде видно, что блоку «smart-captcha» присвоен стиль «height:0». Если я отключаю стиль или своим css его перебиваю, то капча уже отображается и работает.
С чем может быть такое поведение связано?

Наумов Алексей

31 января 2025, 09:23

Странно… но в компоненте нет ни css ни js кода, так что вина тут лежит на том коде, что дает яндекс. Может как-то некорректно рассчитывает высоту элемента

Виктор

01 февраля 2025, 21:57

Понял, спасибо! В целом, манипуляции с css проблему решают. Сама капча работает корректно

Максим

11 апреля 2025, 10:38

А какие манипуляции с css ты делаешь для решения этой проблемы? У меня в шаблоне инлайн-стиль height:100 стоит, но скрипт перебивает его в 0.

Наумов Алексей

11 апреля 2025, 16:47

навроде

.smart-captcha {height:102px !important;}

Виктор

01 июля 2025, 23:31

Я ставил css файле — form .smart-captcha {height: 102px !important;}
Нормально работает, эти стили не перебивались.

Еще обнаружил странный баг в модальном окне на fancybox. Если стоит такой стиль на внешнем контейнере .modal {width: 100%;}, то бегунок капчи двигается но проверка не происходит и он снова сбрасывается в начало. Заменил параметр на «width: auto;» и все заработало.

Максим

11 апреля 2025, 10:36

Подтверждаю, такая же проблема. Именно с модалками через AjaxForm. Если капча НЕ в модалке, то 2 сразу отображаются корректно

Максим

28 марта 2025, 14:50

Здравствуйте, скажите, а можно ее сделать невидимой для пользователей, только чтоб ботам и подозрительным пользователям показывалась?

Наумов Алексей

28 марта 2025, 15:33

Думаю, что лучше официальной документации ответ никто не даст.

Максим

11 апреля 2025, 10:35

У меня не работает с Login. Когда сниппет возвращает false, страница сыпется в 500-ю ошибку (в консоле на вкладе Сеть). Login 1.9.12. К логам сервера нет доступа, в логах MODX ничего нет.
Я же правильно понимаю, что название сниппета нужно добавлять в preHooks? Больше ведь ничего не надо делать? (ну кроме вызова сниппет в html-форме)

Наумов Алексей

11 апреля 2025, 16:48

Вроде не в preHooks, а просто в hooks (для Formit точно).
500 ошибка — надо смотреть логи сервера…

Платон

29 апреля 2025, 09:43

Добрый день, получаю ошибку после отправки формы
Fatal error: Uncaught Error: Object of class FormIt could not be converted to string in /core/components/yasmartcaptcha/model/yasmartcaptcha.class.php:60 Stack trace: #0
Подскажите в чем может быть проблема. Причем не важно пройдена капча или нет.

Наумов Алексей

29 апреля 2025, 11:15

Мало информации… какая версия компонента?..

Платон

29 апреля 2025, 12:32

1.0.1, какая ещё информация необходима?

Наумов Алексей

29 апреля 2025, 14:30

Я честн говоря не понимаю, что за ошибка на 60 строке здесь:
github.com/createit-ru/YaSmartCaptcha/blob/1.0.1-pl/core/components/yasmartcaptcha/model/yasmartcaptcha.class.php#L60

В этом файле ни слова про FormIt нету

Наумов Алексей

19 июня 2025, 21:25

Спустя 2 месяца дошли руки до обновления ), выпусти версию 1.0.3-pl

Илья Павлов

20 мая 2025, 18:02

Добрый день!
Установил, настроил, капча выводится, но если не чекнуть её и отправить форму получаю ошибку:

Failed to load resource: the server responded with a status of 500 ()

Журнал ошибок ModX пуст.
Modx 3.1.2-pl, YaSmartCaptcha 1.0.2-pl, Formit 5.1.1-pl.

В логе сервера такая ошибка:

[Tue May 20 17:49:57 2025] [error] [pid 78865] sapi_apache2.c(358): [client] PHP Fatal error: Uncaught Error: Object of class Sterc\\FormIt could not be converted to string in /public_html/core/components/yasmartcaptcha/model/yasmartcaptcha.class.php:58\nStack trace:\n#0 /public_html/core/components/yasmartcaptcha/model/yasmartcaptcha.class.php(58): str_replace(Array, Array, 'https://smartca...')\n#1 /public_html/core/cache/includes/elements/modx/revolution/modsnippet/52.include.cache.php(42): YaSmartCaptcha->initialize('web', Array)\n#2
/public_html/core/src/Revolution/modScript.php(88): include('/home/p...')\n#3 /public_html/core/src/Revolution/modParser.php(508): MODX\\Revolution\\modScript->process(NULL)\n#4 /public_html/core/components/pdotools/src/Parsing/Parser.php(276): MODX\\Revolution\\modParser->processTag(Array, true)\n#5 /public_html/core/src/Revolution/modParser.php(221): ModxPro\\PdoTools\\Parsing\\Parser->processTag(Array, true)\n#6 /public_html/core/components/pdotools/src/Parsing/Parser.php(73): MODX\\Revolution\\modParser->processElementTags('', '<!doctype html>...', true, false, '[[', ']]', Array, 9)\n#7 /public_html/core/src/Revolution/modResource.php(520): ModxPro\\PdoTools\\Parsing\\Parser->processElementTags('', '<!doctype html>...', true, false, '[[', ']]', Array, 10)\n#8 /public_html/core/src/Revolution/modResource.php(468): MODX\\Revolution\\modResource->parseContent()\n#9 /public_html/core/src/Revolution/modResponse.php(72): MODX\\Revolution\\modResource->prepare()\n#10 /public_html/core/src/Revolution/modRequest.php(154): MODX\\Revolution\\modResponse->outputContent(Array)\n#11 /public

Подскажите, пожалуйста, может я что-то не так настроил?

Наумов Алексей

20 мая 2025, 21:19

Вы уже второй с такой ошибкой, то ли в свежем MODX что-то изменилось, толи в Formit. Я поправлю в ближайшие дни, постараюсь

Илья Павлов

20 мая 2025, 22:04

я сегодня уже после того как столкнулся с ошибкой обновил до актуальных ModX c 3.0.6 и Formit тоже версия была 2024 года

Илья Павлов

17 июня 2025, 15:36

Добрый день! Не нашлось времени глянуть что там?

Наумов Алексей

19 июня 2025, 10:42

Добрый день. Пока не поправил… постараюсь в ближ дни

Наумов Алексей

19 июня 2025, 21:26

Дошли руки до обновления ), выпусти версию 1.0.3-pl
Попробуйте… я просто убрал код, вызывающий ошибку, но к сожалению самому проверить сейчас негде.

Евгений Лазарев

07 ноября 2025, 13:32

Нашел проблему еще одну. Я так понял нельзя вызывать сниппет с помощью fenom {'!YaSmartCaptcha' | snippet}. Поскольку при авторизации через Login если не проходил проверку то перезагрузится страница и весь fenom выйдет на странице необработанный в виде {'site_name' | option}

Наумов Алексей

07 ноября 2025, 15:22

Я слабо понял суть вопроса. Подозреваю что этот комментарий дублирует суть вопроса modx.pro/help/25398

Еще раз в этом случае — сниппет Login не работает с pdoTools и Fenom синтаксисом.

Scorp Satex

16 января 2026, 19:24

Добрый день.

На странице в модальных окнах есть 5 форм.

В каждой форме вставлен [[!YaSmartCaptcha]] в нужное место.

Из-за этого он 5 раз закачивает два файла:

* smartcaptcha.cloud.yandex.ru/slider.xxxxxxxxxx.js
* smartcaptcha.cloud.yandex.ru/captchapgrd

Из-за этого размер страницы сильно раздувается.

Как можно решить проблему дублирования?

Наумов Алексей

19 января 2026, 09:29

зайти в настройки компонента, убрать значение у «yasmartcaptcha_service_js», а скрипт подключить вручную

sunchea

27 мая 2026, 08:11

Приветствую!
Странная ситуация, на тестовом домене/сайте в Менеджере пакетов есть YaSmartCaptcha, а на основном домене/сайте нет в списке доступных пакетов. Почему такое может быть?

Наумов Алексей

27 мая 2026, 09:59

привет. версию php (>=7.4) проверьте, версию modx (>= 2.8). В целом других причин быть не должно.

sunchea

27 мая 2026, 10:50

Спасибо за оперативный ответ!

Уже проверил и пофиксил, плюс скачал пакет с GitHub дополнительно
Кто-то одаренный на основном домене переключил версию PHP с 8.2 на 7.1, со всеми прелестями 500 ошибок )))

Авторизуйтесь или зарегистрируйтесь, чтобы оставлять комментарии.

YaSmartCaptcha - защитите ваши формы от спама умной капчей от Яндекс

Регистрация в Yandex Cloud

Настройка компонента

Добавление капчи в форму

Ссылки

В заключение

Комментарии: 37

Здесь упомянуты