=== GateForm ===
Contributors: gateform
Tags: captcha, spam, contact-form-7, comments, woocommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.2.3
License: MIT
License URI: https://opensource.org/licenses/MIT

GateForm CAPTCHA для WordPress и Contact Form 7, а также виджет связи для подвала сайта.

== Description ==

Плагин загружает `client.js` из сервиса [GateForm](https://gateform.ru) в формы WordPress
и проверяет одноразовый токен на сервере. Секретный ключ хранится только в базе данных
WordPress и никогда не выводится в HTML.

**Сайт:** [gateform.ru](https://gateform.ru)  
**Документация:** [gateform.ru/docs](https://gateform.ru/docs)  
**Поддержка:** [info@gateform.ru](mailto:info@gateform.ru)

Защищаемые формы:

* форма комментариев;
* вход в админку и на сайт через `wp-login.php`;
* форма регистрации;
* Contact Form 7 (капча и тег `[gateform]`);
* WPForms;
* Gravity Forms;
* Ninja Forms;
* Elementor Pro Forms;
* Formidable Forms;
* Fluent Forms;
* WooCommerce: оформление заказа, вход и регистрация;
* произвольные формы по CSS-селекторам.

Виджет связи (не требует секретного ключа):

* если в настройках указан **ID виджета** (`w_...`), код виджета автоматически
  добавляется в подвал сайта (`wp_footer`);
* также поддерживается шорткод `[gateform_widget]`.

Надпись «Protected by GateForm» со ссылкой на сайт и логотипом отображается
в формах Contact Form 7; её можно отключить фильтром `gateform_cf7_branding`.

Значения полей форм не отправляются в сервис проверки. Плагин не сохраняет
IP-адреса посетителей.

== External services ==

Этот плагин подключается к внешнему сервису GateForm по адресу [https://gateform.ru](https://gateform.ru)
для защиты форм WordPress капчей и отображения необязательного виджета связи.

GateForm используется для:

* загрузки клиентского скрипта капчи (`client.js`) на страницах с защищёнными формами;
* загрузки скрипта виджета связи (`widget.js`), если указан ID виджета;
* проверки одноразового токена капчи при отправке защищённой формы.

Сервис необходим для функций капчи и виджета связи.

**Проверка капчи**

Когда посетитель открывает страницу с защищённой формой, браузер загружает
`https://gateform.ru/client.js`. Скрипт может собирать поведенческие сигналы,
необходимые для отличия человека от автоматических запросов.

Когда посетитель отправляет защищённую форму, плагин отправляет публичный ключ сайта,
секретный ключ и одноразовый токен капчи на
`https://gateform.ru/api/v1/validate` по HTTPS.

Плагин не отправляет в GateForm значения полей форм, комментарии, текст сообщений
или IP-адреса посетителей.

**Виджет связи**

Если указан ID виджета, браузер загружает `https://gateform.ru/widget.js`.
Виджет может отображать форму связи, чат, ссылки на социальные сети или другие
способы связи — в зависимости от настроек виджета в кабинете владельца сайта GateForm.

Если владелец сайта включил форму связи или чат, данные, введённые посетителем
в этом виджете — например, имя, email, телефон или сообщение, — могут передаваться
в GateForm для обработки и доставки обращения. Сам плагин не передаёт данные
посетителей; обработка данных зависит от настроек виджета, выбранных владельцем сайта.

**Условия использования и конфиденциальность**

* Условия использования: [https://gateform.ru/agreement](https://gateform.ru/agreement)
* Политика конфиденциальности для посетителей: [https://gateform.ru/privacy/visitors](https://gateform.ru/privacy/visitors)
* Сайт GateForm: [https://gateform.ru](https://gateform.ru)

== Installation ==

1. Загрузите папку `gateform` в `/wp-content/plugins/` или установите ZIP-файл
   через «Плагины → Добавить новый → Загрузить плагин».
2. Активируйте плагин на странице «Плагины».
3. Откройте «Настройки → GateForm».
4. Введите публичный ключ (`site_key`) и секретный ключ (`secret_key`).
5. Выберите формы, которые нужно защитить.
6. При необходимости введите **ID виджета** (`w_...`) — код виджета сразу
   появится в подвале сайта.

Ключи создаются в кабинете GateForm. Домен сайта должен быть указан
в настройках ключа.

== Frequently Asked Questions ==

= Как добавить капчу в Contact Form 7? =

Включите «Contact Form 7» в настройках плагина. Добавьте в форму тег `[gateform]` —
он выводит скрытое поле токена и надпись GateForm. Если тег не добавлен,
`client.js` подключится к форме автоматически и добавит поле самостоятельно.

= Почему капча не видна в форме Contact Form 7? =

GateForm использует невидимую поведенческую проверку и показывает кнопку
«Я не робот» только при подозрении на бота. Скрытое поле `gf_token`
и надпись GateForm добавляются автоматически.

= Нужны ли плагину внешние сервисы или CDN? =

Нет. Загружается только скрипт с вашего экземпляра GateForm.

= Что произойдёт, если сервис проверки недоступен? =

По умолчанию формы отклоняются (безопасный режим). Включите
«Принимать формы без проверки (fail-open)», если важнее не терять заявки.

= Совместим ли плагин с кэшированием страниц? =

Да. Скрипт добавляется в подвал страницы, а токен запрашивается
в момент отправки формы.

= Где хранится секретный ключ? =

В таблице `wp_options`. Он не выводится в HTML и не передаётся в JavaScript.

= Можно ли использовать только виджет связи? =

Да. Введите только ID виджета `w_...` в настройках — скрипт виджета
сразу появится в подвале сайта. Секретный ключ не требуется.

== Changelog ==
= 1.2.2 =
* Исправления релиза и обновление версии.

= 1.2.1 =
* Первый созданный тег рели

= 1.2.0 =
* Единый плагин: капча и виджет связи.
* Полная интеграция с Contact Form 7: тег `[gateform]`, проверка через
  `wpcf7_validate`, скрытое поле токена и брендинг со ссылкой на gateform.ru.
* Шорткод `[gateform_widget]` для размещения виджета связи в любом месте сайта.
* Логотип и ссылка на сайт в админ-панели и в формах Contact Form 7.
* Кэширование результата проверки в рамках одного запроса.

= 1.1.0 =
* Поддержка Contact Form 7, WPForms, Gravity Forms, Ninja Forms, Elementor Pro,
  Formidable Forms, Fluent Forms и WooCommerce.
* Защита входа через `wp-login.php`.
* Произвольные CSS-селекторы форм и фильтр `gateform_validate_token`.
* Режим fail-open и отдельные настройки для каждой интеграции.

= 1.0.0 =
* Первый релиз: комментарии, вход, регистрация и режим fail-open.

== Upgrade Notice ==

= 1.2.0 =
Единый плагин: капча для Contact Form 7 и виджет связи. После обновления
проверьте настройки виджета в разделе «Настройки → GateForm».