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

Установка

Порядок от покупки до работающей капчи — пять шагов, из них четыре в админке.

1. Поставить модуль

Marketplace → Решения → Установленные решения — модуль ставится оттуда как обычное решение маркетплейса. Отдельных действий с файлами не требуется.

2. Получить ключи

Ключи выдаёт облако Яндекса, они бесплатны. Порядок — в главе «Ключи Яндекса»: там же сказано, чем ключ клиента отличается от ключа сервера и почему их нельзя перепутать местами.

3. Вписать ключи и включить модуль

Настройки → Настройки продукта → Настройки модулей → DEV-BX Yandex SmartCaptcha.

На вкладке «Настройки сайтов» заполняются «Ключ клиента» и «Ключ сервера», ставится флажок «Активность», и настройки сохраняются. Пока флажок снят, модуль ничего не делает — формы работают со штатной капчой Битрикса.

4. Проверить на живой форме

Откройте любую страницу с капчой — обычно это форма входа или обратной связи. Вместо картинки с буквами должен появиться блок проверки Яндекса.

Отправьте форму по-настоящему: капча считается рабочей не тогда, когда она отрисовалась, а когда отправка прошла и данные дошли.

5. Сузить показ, если нужно

По умолчанию капча появляется всюду, где её выводит Битрикс. Если проверка нужна только на нескольких страницах, ограничьте показ — глава «Где показывается капча».

Обновление

Обновления приходят через Marketplace → Обновление решений вместе с остальными решениями. Настройки при обновлении сохраняются.

Удаление

Marketplace → Установленные решения → Удалить. Формы возвращаются к штатной капче Битрикса сразу после удаления. Если нужно временно отключить проверку, удалять модуль не нужно — достаточно снять флажок «Активность».