Документация

О модуле

Модуль заменяет штатную капчу 1С-Битрикс на Google reCAPTCHA: вместо разгадывания букв с картинки посетитель проходит проверку Google, а чаще не проходит ничего — в невидимых версиях задание показывается только при подозрительном поведении.

Поддерживаемые версии проверки

Версия Что видит посетитель
reCAPTCHA v3 ничего: оценка считается по поведению, форма отправляется как обычная
reCAPTCHA v2, невидимый значок ничего, пока Google не сочтёт поведение подозрительным
reCAPTCHA v2, флажок «Я не робот» флажок в форме, иногда задание с картинками

Что умеет

  • Подменяет капчу Битрикса без правки форм — вход, регистрация, восстановление пароля, обратная связь, отзывы.
  • Работает с ajax-формами и модальными окнами: форма, появившаяся после загрузки страницы, подхватывается сама.
  • Защищает оформление заказа bitrix:sale.order.ajax — отдельным выключателем, с проверкой при сохранении заказа.
  • Ограничивает показ по страницам: везде, только на указанных или везде, кроме указанных.
  • Настраивается отдельно для каждого сайта — свои ключи, версия и правила показа.
  • Порог доверия и контекст для v3, расположение значка и цветовая схема для видимых версий.

Чего модуль не делает

Он подменяет ту капчу, которую формы Битрикса уже выводят. Форма со своим полем проверки или без капчи вовсе остаётся без защиты, пока её не подключат вручную — это описано в главе «Свои и нештатные формы».

Требования

  • PHP 8.0 и выше;
  • ключи reCAPTCHA — бесплатные, порядок получения в главе «Настройка»;
  • исходящие соединения сервера к www.google.com.