Предназначен для плагинов comments
, feedback
, а также для формы регистрации пользователей на сайте.
Плагин запрашивает у сервиса Google оценку действий пользователя без его участия для блокирования отправки форм ботами, которые чаще всего спамят.
Перед использованием плагина вам необходимо убедиться, что ваш сервер соответствует следующим требованиям:
- PHP ^7.3|^8.0
- irbees2008/ng-helpers
Плагин irbees2008/ng-helpers должен быть обязательно включен.
Перед обновлением плагина, отключите его в панели управлении. Старую версию также нужно удалить с сервера.
Те же самые манипуляции относятся и к старой версии плагина
ggg_recaptcha
.
Плагин выпускается в двух вариациях, каждая из которых поддерживает свой тип кодировки: UTF-8 и Windows-1251. Для подключения вы можете просто скачать плагин в необходимой для вашего проекта кодировке:
Обратите внимание, что кодировка UTF-8 является основной.
- Перед использованием плагина зарегистрируйтесь и получите Ключ и Секретный ключ reCAPTCHA v3 здесь.
- Активируйте плагин
ng-grecaptcha
в админ. панели. - Вставьте Ключ и Секретный ключ в соответствующие поля.
- Никаких дополнительных действий с плагином не требуется.
Теперь на вашем сайте в правом нижнем углу информационный блок от reCAPTCHA.
При использовании опции Встраивать на страницу файл JavaScript из шаблона, вы можете отслеживать действия пользователей, разграничивая их в консоли администрирования. Для этого необходимо к каждой из форм добавлять соответствующий идентификатор.
Например, для формы регистрации пользователей это может выглядеть так:
<!-- \templates\ВАШ_ШАБЛОН\registration.tpl -->
<form id="register_user" ...>
<!-- Остальной код формы -->
</form>
Для использования в плагине comments
, отредактируйте шаблон формы, добавив скрытое поле перед закрывающим тегом </form>
:
<!-- \templates\ВАШ_ШАБЛОН\plugins\comments\comments.form.tpl -->
<input type="hidden" name="g-recaptcha-response" value="" />
В том случае, если вы используете технологию AJAX для отправки комментариев, то вам необходимо добавить значение поля ввода капчи до того, как будет отправлен AJAX запрос вашим JavaScript.
Например, в этом же шаблоне добавить в секции script
после [not-logged] ... [/not-logged]
:
cajax.setVar('g-recaptcha-response', form['g-recaptcha-response'].value);
Для использования в плагине feedback
, отредактируйте шаблон формы, добавив скрытое поле перед закрывающим тегом </form>
:
<!-- \templates\ВАШ_ШАБЛОН\plugins\feedback\site.form.tpl -->
<input type="hidden" name="g-recaptcha-response" value="" />
Для использования в форме регистрации пользователей, отредактируйте шаблон формы, добавив скрытое поле перед закрывающим тегом </form>
:
<!-- \templates\ВАШ_ШАБЛОН\registration.tpl -->
<input type="hidden" name="g-recaptcha-response" value="" />
Для использования в формах модальных окон, отредактируйте шаблон формы, добавив скрытое поле перед закрывающим тегом </form>
:
<input type="hidden" name="g-recaptcha-response" value="" />
ng-grecaptcha
- программное обеспечение с открытым исходным кодом, распространяющееся по лицензии MIT.