Яндекс SmartCaptcha и Google reCAPTCHA для OpenCart 4

Яндекс SmartCaptcha и Google reCAPTCHA для OpenCart 4

Расширение защищает формы магазина на OpenCart 4.1.0.4 от роботов. В ядре есть только простая капча с картинкой; пакет добавляет два компонента типа «Защита от ботов»: Yandex SmartCaptcha — российский сервис, который большинство посетителей проходят без задания, и Google reCAPTCHA v2 (флажок «Я не робот») как запасной вариант. Капча подключается через штатный механизм OpenCart: страницы выбираются в настройках магазина, ядро не изменяется.

Для кого

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

Что умеет

• Виджет в формах регистрации, отзывов, комментариев, возвратов и обратной связи — на тех страницах, которые отмечены в настройках магазина.
• Проверка токена на сервере: магазин сам обращается к серверу SmartCaptcha или Google с секретным ключом, подделать ответ в браузере нельзя.
• Язык виджета SmartCaptcha — по языку витрины или заданный (русский, английский, белорусский, казахский, татарский, украинский, узбекский, турецкий); тема reCAPTCHA — светлая или тёмная.
• Повторная отправка формы: после ответа магазина виджет сбрасывается и выдаёт новый токен — вторая попытка после ошибки в другом поле не проваливается.
• Тестовый режим SmartCaptcha: виджет всегда показывает задание — удобно проверять на стенде.
• Поведение при недоступности сервиса проверки — на выбор: пропускать форму с записью в журнал ошибок (по умолчанию) или не отправлять форму с сообщением покупателю.
• Для reCAPTCHA — домен скриптов recaptcha.net (работает там, где google.com недоступен) или google.com.
• Раздел «Безопасность» в левом меню панели со страницами настроек обеих капч.
• Руководство пользователя — вкладкой «Руководство» прямо на странице расширения.

Как это выглядит для покупателя

Вместо картинки с цифрами в форме появляется виджет выбранной капчи. При отправке формы магазин проверяет токен на сервере; если проверка не пройдена, под виджетом появляется подсказка «Подтвердите, что вы не робот!», а форма не отправляется. Одновременно в магазине работает одна капча — та, что выбрана в настройках.

Установка

1. «Расширения → Установщик» → «Загрузить» → файл smartcaptcha_oc4.ocmod.zip (имя не менять: OpenCart 4 берёт из него код расширения) → «Установить».
2. «Расширения → Расширения», тип «Защита от ботов» → «Установить» у «Яндекс SmartCaptcha» и, если нужна, у «Google reCAPTCHA».
3. Откройте настройки капчи (кнопка «Редактировать» или раздел меню «Безопасность»), вставьте ключи и включите «Статус». Без ключей включить нельзя — иначе формы перестали бы отправляться.
4. «Система → Настройки → Опции → Капча»: выберите капчу и отметьте страницы.

Модификаторов нет, обновлять их не нужно. Права на страницы настроек получает группа пользователя, который нажал «Установить».

Ключи

SmartCaptcha: в консоли Yandex Cloud создайте капчу, добавьте домен магазина и скопируйте клиентский и серверный ключи. reCAPTCHA: зарегистрируйте сайт в консоли Google reCAPTCHA (тип v2, флажок «Я не робот») и скопируйте ключ сайта и секретный ключ. Серверный и секретный ключи хранятся только в настройках магазина.

Обновление и удаление

Обновление — установка нового архива поверх прежних файлов через Установщик; настройки и ключи сохраняются. Удаление: «Расширения → Расширения → Защита от ботов» → «Удалить» у каждой капчи, затем удалить пакет в Установщике. Ключи удаляются вместе с настройками, раздел меню исчезает.

Совместимость и ограничения

• OpenCart 4.1.0.4, PHP 8.2, тема Default — проверено; нужно расширение PHP cURL.
• Другие версии OpenCart 4 и сторонние темы не проверялись.
• Невидимая капча, выбор положения значка и проверка поля host в ответе в эту версию не входят.
• Страницу «Гость» в оформлении заказа ядро 4.1.0.4 капчей не проверяет; регистрация при оформлении защищается значением «Регистрация».

Расширение входит в состав бесплатной русской сборки OCM Store: там обе капчи уже установлены и выключены до ввода ключей. Этот пакет — для обычного OpenCart 4.1.0.4.

Список изменений

1.0.0 — первая версия: Yandex SmartCaptcha и Google reCAPTCHA v2, серверная проверка, язык и тема виджета, тестовый режим, режим поведения при недоступности сервиса, раздел меню «Безопасность», руководство вкладкой.