recaptcha

Последнее обновление May 27th, 2026 | История страницы | Улучшить эту страницу | Сообщить о проблеме

Support the team building MODX with a monthly donation.

The budget raised through OpenCollective is transparent, including payouts, and any contributor can apply to be paid for their work on MODX.

Backers

Budget

$0 per month—let's make that $500!

Learn more

Хук recaptcha для FormIt¶

Хук recaptcha включает поддержку reCAPTCHA v3 для форм FormIt. reCAPTCHA v3 работает незаметно в фоне — пользователю не показывается никаких чекбоксов или заданий. Google возвращает оценку (0.0–1.0), отражающую вероятность того, что форму отправил человек; заявки ниже минимального порога отклоняются.

Требования¶

Ключи reCAPTCHA v3 (site key и secret key) с https://www.google.com/recaptcha
Фронтенд JS FormIt включён через системную настройку formit.frontend_js (значение: js/web/formit.js)

Использование¶

Добавьте recaptcha в параметр &hooks:

[[!FormIt?
    &hooks=`recaptcha,email`
]]

Добавьте плейсхолдер reCAPTCHA и плейсхолдер ошибки в форму:

[[+formit.recaptcha_html]]
[[!+fi.error.recaptcha]]

[[+formit.recaptcha_html]] выводит два скрытых поля (g-recaptcha-response и g-recaptcha-action), необходимых для v3. FormIt автоматически подключает скрипт Google reCAPTCHA и выполняет запрос токена при отправке формы.

Системные настройки¶

Настройте ключи в Системных настройках в области formit_recaptcha:

Настройка	Описание	По умолчанию
`formit.recaptcha_site_key`	Ваш публичный ключ reCAPTCHA v3 (site key).
`formit.recaptcha_secret_key`	Ваш приватный ключ reCAPTCHA v3 (secret key).
`formit.recaptcha_min_score`	Минимальная оценка для принятия заявки (0.0–1.0).	`0.5`

Поддерживаемые параметры¶

Имя	Описание	По умолчанию
`recaptchaAction`	Имя action, отправляемое в Google вместе с токеном. Отображается в панели администратора reCAPTCHA.	`submit`

Смотрите также¶