=== CACR Отправка заявок с сайта в Мессенджер MAX ===
Contributors: inmark24
Tags: contact-form-7, leads, forms, max, messenger
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 1.2.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

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

== Description ==

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

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

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

Кнопка принятия заявки включается отдельно для нужного подключения в кабинете CACR. После первого нажатия в сообщении отображается, кто принял заявку и во сколько.

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

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

== Installation ==

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

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

== Screenshots ==

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

== Frequently Asked Questions ==

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

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

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

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

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

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

= Можно ли принять заявку прямо в чате MAX? =

Да. Для групповых чатов в кабинете CACR можно включить кнопку «Принять заявку». После нажатия в сообщении появится отметка, кто взял заявку и во сколько.

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

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

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

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

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

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

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

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

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

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

== Changelog ==

= 1.2.8 =
* Добавлена передача email-адреса получателя формы в CACR для правил маршрутизации по адресу отправки формы.
* Для Contact Form 7 адрес берется из настройки письма формы, для других форм через `wp_mail` — из фактического получателя письма.
* Улучшена совместимость endpoint проверки интеграции при одновременном использовании MAX и Telegram relay-плагинов.

= 1.2.7 =
* Добавлен автоматический fallback на IPv4 для запросов к CACR при сетевых ошибках `cURL`, чтобы обходить хостинги со сломанным IPv6.
* Повторная отправка через IPv4 применяется только при ошибке соединения и не меняет поведение на сайтах, где сеть работает штатно.

= 1.2.6 =
* Добавлена кнопка «Принять заявку» для групповых чатов MAX с отметкой, кто взял заявку и во сколько.
* Описание плагина обновлено для пользователей: добавлены новые сценарии работы в групповых чатах.
* Пользовательские тексты и описание релиза приведены к локализации `ru_RU`.

= 1.2.5 =
* Удалена локальная быстрая настройка из настроек клиента: настройка получателя остается в кабинете CACR.
* Обновлены тексты в настройках: конфигурация получателя выполняется в CACR, а не на сайте клиента.

= 1.2.4 =
* Приведены релизные имя папки и bootstrap-файл к каноническому slug `cacr-relay-cf7-max`.
* CSS и JS страницы настроек переведены на стандартные `wp_enqueue_style()` и `wp_enqueue_script()`.
* Небезопасное чтение входных данных заменено на nonce-проверки и санитизацию.
* Универсальная обработка `wp_mail` переделана так, чтобы разбирать исходящее письмо, а не весь `POST`.

= 1.2.3 =
* Расширено описание для модерации WordPress.org: уточнены режимы доставки в MAX.
* Добавлены пояснения про тестовую отправку, поддержку `admin-post.php` и фильтрацию только лидов.

= 1.2.2 =
* Плагин переименован в `CACR Отправка заявок с сайта в Мессенджер MAX`.
* Канонический slug и text domain оставлены как `cacr-relay-cf7-max`.

= 1.2.1 =
* Обновлено название плагина.
* Text domain приведен к `cacr-relay-cf7-max` для проверок slug-согласованности.

= 1.2.0 =
* Добавлены режимы доставки: личные сообщения MAX и приватные чаты/группы.
* Добавлена быстрая настройка в настройках плагина.
* Добавлено безопасное fallback-поведение, если чат еще не привязан.

= 1.1.1 =
* Исправлена передача заявок из форм сайта через `admin-post.php`, включая кастомные формы через `wp_mail`.
* Усилена фильтрация тем и тел системных писем WordPress.

= 1.1.0 =
* Добавлена универсальная передача для не-CF7 форм через `wp_mail_succeeded`.
* Добавлена фильтрация комментариев и системных уведомлений.
* Сохранен отдельный CF7-поток для защиты от дублей.

= 1.0.0 =
* Добавлены CF7-хук, проверка лицензии через CACR и отправка заявок в MAX через портал.
