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

Капча GateForm для 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-селекторам.

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

* `[gateform_callback]` — форма GateForm;
* `[gateform_form]` — то же, что `[gateform_callback]`;
* `[gateform_reviews]` — отзывы товара;
* `[gateform_widget]` — виджет связи.

Автоматический вывод отзывов на страницах товаров WooCommerce включается в
настройках. Подпись «Защищено GateForm» со ссылкой на сайт и логотип выводится
в формах Contact Form 7 и может быть отключена фильтром `gateform_cf7_branding`.

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

== Installation ==

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

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

== Frequently Asked Questions ==

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

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

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

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

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

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

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

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

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

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

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

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

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

Да. Виджетам нужны только публичные ключи `cf_...`, `rv_...` и `w_...`.
Секретный ключ для них не требуется.

== Changelog ==

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

= 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».
