=== CACR Отправка заявок с сайта в Telegram ===
Contributors: inmark24
Tags: contact-form-7, telegram, leads, forms, notifications
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Передает заявки с сайта из Contact Form 7 и других форм на `wp_mail` в личные сообщения, чаты и группы Telegram через CACR.

== Description ==

Плагин передает заявки с WordPress-сайта в Telegram через портал CACR. Он подходит для сайтов, где нужно быстро получать обращения в личные сообщения, чаты или группы Telegram.

Основные возможности:

- поддержка Contact Form 7 и других форм, которые отправляют письма через `wp_mail`;
- доставка заявок в личные сообщения, чаты и группы Telegram;
- настройка получателя выполняется в кабинете CACR, на сайте хранится только ключ интеграции;
- при необходимости можно включить маршрутизацию заявок по разным формам и полям формы внутри одного сайта;
- кнопка тестовой отправки из настроек плагина для проверки цепочки сайт -> CACR -> Telegram;
- фильтрация системных писем WordPress, чтобы в Telegram уходили только реальные заявки;
- поддержка отправки из форм сайта на `wp-admin/admin-post.php`.

Плагин не создает ключ интеграции на сайте и не настраивает получателя локально. Эти действия выполняются только в кабинете CACR.

Видео по установке и настройке: https://cacr.ru/plugins/tg_cf7/

== External services ==

Плагин подключается к сервису CACR по адресу `https://cacr.ru`, чтобы проверять ключ интеграции и доставлять заявки в Telegram.

Плагин отправляет запросы:

- на `https://cacr.ru/wp-json/mb/v1/tg-cf7/license` при проверке ключа или обновлении статуса лицензии;
- на `https://cacr.ru/wp-json/mb/v1/tg-cf7/lead` при отправке заявки из поддерживаемой формы.

В CACR могут передаваться ключ интеграции, URL и домен сайта, версия плагина, источник заявки, ID и название формы, поля формы, URL страницы, IP-адрес посетителя и user agent. Эти данные используются для проверки доступа, маршрутизации заявки и отправки сообщения в Telegram.

Для работы плагина нужны учетная запись или интеграция CACR и настроенный получатель Telegram. Устанавливая, активируя и настраивая ключ интеграции, администратор сайта соглашается на передачу этих данных в CACR для доставки заявок.

Политика конфиденциальности CACR: https://cacr.ru/privacy-policy/

== Installation ==

1. Установите и активируйте плагин.
2. Если вы используете Contact Form 7, установите и активируйте его.
3. В кабинете CACR создайте интеграцию `tg_cf7` для домена сайта.
4. Сгенерируйте ключ интеграции в кабинете CACR.
5. В WordPress откройте `Настройки -> CACR Отправка заявок с сайта в Telegram`.
6. Вставьте ключ интеграции и сохраните настройки.
7. Настройте получателя в Telegram через кабинет CACR.
8. Нажмите `Проверить ключ и лицензию`, затем отправьте тестовую заявку.

Подробные видео по установке и настройке доступны на странице плагина: https://cacr.ru/plugins/tg_cf7/

== Screenshots ==

1. Страница настроек плагина в WordPress: ввод ключа интеграции, проверка лицензии и тестовая отправка.
2. Пример заявки, доставленной из сайта в Telegram через CACR.

== Frequently Asked Questions ==

= Где получить ключ интеграции? =

Ключ создается только в кабинете CACR для интеграции `tg_cf7`. На сайте WordPress он не генерируется.

= Работает ли плагин без Contact Form 7? =

Да. Contact Form 7 поддерживается отдельно, но плагин также передает заявки из других форм, если они отправляют письмо через `wp_mail`.

= Где настраивается получатель в Telegram? =

Получатель настраивается в кабинете CACR. На сайте WordPress хранится только ключ интеграции.

= Можно ли для одного сайта отправлять разные формы в разные чаты или аккаунты Telegram? =

Да. Это реализуется как допуслуга CACR: внутри одной интеграции сайта на стороне CACR настраиваются правила маршрутизации по `form_id`, `form_title`, `page_url` и/или полям формы. Текущий получатель интеграции остается получателем по умолчанию и используется как fallback.

= Как лучше размечать формы для маршрутизации? =

Для Contact Form 7 рекомендуется использовать `form_id` или hidden-поле вроде `route_key`. Для кастомных форм, которые уходят через `wp_mail`, скрытое поле должно попасть и в письмо, иначе портал не сможет использовать его в правилах маршрутизации.

= Что будет, если лицензия неактивна? =

Плагин перестанет передавать заявки, пока лицензия или подписка не станут активными снова.

= Уходят ли в Telegram комментарии, обновления и системные письма WordPress? =

Нет. Плагин отфильтровывает системные уведомления и передает только заявки.

= Где посмотреть видео по установке и настройке? =

Видеоинструкции доступны на странице плагина: https://cacr.ru/plugins/tg_cf7/

== Changelog ==

= 1.0.1 =

- Исправлена отправка реальных заявок после успешного теста при устаревшем локальном кэше лицензии.
- Добавлен повтор подключения к CACR через IPv4 при сетевых timeout/connection errors.

= 1.0.0 =
* Первая версия плагина для WordPress.org.
* Добавлена передача заявок из Contact Form 7 в Telegram через CACR.
* Добавлена передача заявок из других форм через `wp_mail`.
* Добавлены проверка лицензии, настройки ключа интеграции, тестовая заявка и журнал отладки.
* Добавлена фильтрация системных уведомлений WordPress.
