Документация WP Ru-max

1. Установка

Поддерживается WordPress 5.8+ и PHP 7.4+. Протестировано на PHP 7.4 – 8.3.

Через панель WordPress

1. Скачайте ZIP-архив из GitHub Releases.
2. Перейдите в Плагины → Добавить новый → Загрузить плагин.
3. Выберите wp-ru-max.zip и нажмите Установить.
4. Активируйте плагин кнопкой Активировать плагин.

Через FTP / SSH

git clone https://github.com/RuCoder-sudo/wp-ru-max.git \
    /var/www/site/wp-content/plugins/wp-ru-max

Затем активируйте плагин в Плагины → Установленные плагины.

2. Активация лицензии

Перейдите в меню Ru-max → Активация. Введите ключ формата WPRM-XXXX-XXXX-XXXX-XXXX и нажмите «Активировать».

Нет ключа? Заполните форму «Запросить лицензионный ключ» на той же вкладке. Укажите имя, email и удобный мессенджер (Telegram / MAX / WhatsApp / VK) — владелец свяжется и вышлет ключ.

При открытии вкладки плагин сверяет ключ с сервером fixcoder.ru. Если ключ был отозван — статус сразу переключается на «приостановлен», на странице появляется красная плашка, в логе пишется «Лицензия отозвана сервером».

Кнопка «Проверить лицензию сейчас»

На активной лицензии есть кнопка ручной перепроверки и строка «Последняя проверка». В фоне ключ сверяется раз в час (RECHECK_SECONDS = 3600).

Стоимость

3. Подключение бота MAX

1. Получите токен на платформе max.ru/partner: «Чат-боты» → «Интеграция» → «Получить токен».
2. Вставьте токен на вкладке Ru-max → Главная.
3. Нажмите Проверить подключение — плагин дёрнет метод GET /me и покажет данные бота.

4. Автопубликация

В разделе Ru-max → Публикация:

• Включите «Автоматическая отправка постов».
• Укажите канал MAX: никнейм публичного канала вида @my_channel или числовой ID группы.
• Выберите типы записей (posts, pages, любые CPT).
• Настройте формат сообщения: переменные {title}, {excerpt}, {url}, {meta_FIELD}, {acf_FIELD}.
• Опционально включите/отключите ссылку «Читать полностью» и прикрепление миниатюры.

В редакторе записи появится отдельная кнопка «Отправить в MAX» для ручной отправки.

5. Уведомления с форм

В разделе Ru-max → Уведомления включите перехват wp_mail() и укажите ID чатов, в которые дублировать письма.

Поддерживаются:

• WooCommerce — новые заказы, смена статуса, оплата.
• Contact Form 7, Elementor Forms (включая Pro), Gravity Forms, Ninja Forms.
• Любые формы и плагины, использующие стандартный wp_mail().

Шаблон сообщения настраивается; по умолчанию: <b>{email_subject}</b>\n{email_message}.

6. Чат-виджет

В разделе Ru-max → Виджет:

• Включите виджет, укажите ссылку на бота / канал MAX.
• Текст приветствия с анимацией «печатания», размер виджета (S / M / L), позиция (слева / справа).
• Слайдер отступа от края (0–200 px).
• Задержка появления: 0 / 5 / 8 / 10 / 15 секунд.
• 3 варианта звука уведомления (Web Audio, без аудиофайлов), задержка звука 3 / 6 / 9 секунд.
• 4 анимации привлечения внимания: пульс, рябь, подпрыгивание, встряска.
• Попап удержания: заголовок и сообщение, кнопки «Остаться» и «Уйти», цвета и закругление.

7. Логи и тестирование

В разделе Ru-max → Логи:

• Таблица всех событий: отправки, ошибки, тесты.
• Фильтры по типу, дате, статусу.
• Просмотр полного JSON запроса/ответа API MAX для каждого события.

Тестовые сообщения отправляются с вкладки «Главная» в любой канал или личный чат.

8. Обновления

Раз в 12 часов плагин проверяет GitHub Releases. Если тег нового релиза новее установленной версии — в WordPress появится стандартное уведомление «Доступно обновление». Установка в один клик, как с обычным плагином из WordPress.org.

9. История версий

1.0.38

• UTM-метки для чат-виджета — параметры utm_source, utm_medium, utm_campaign, utm_content автоматически добавляются к ссылке виджета.
• Яндекс.Метрика — событие reachGoal при клике на иконку чат-виджета; настраиваются номер счётчика и идентификатор цели.
• Общая защита от дублей уведомлений — предотвращает двойные Telegram-уведомления от MPHB, Bookly, YClients (второй email с тем же #ID в теме пропускается).
• Исправлено: ссылки на платформу MAX обновлены с max.ru/partner на business.max.ru.

1.0.37

• Регулировка высоты значка над низом экрана (0–300 px) — значок не перекрывается нижним меню темы.
• Три новых звука уведомления (Вариант 4–6) с прослушиванием прямо в настройках.
• Три новые анимации привлечения внимания — Маятник, Взрыв, Сердцебиение.

1.0.36

• Поддержка bbPress форумов — топики (тип записи «topic») теперь корректно отправляются с изображением.
• Автоматический поиск изображений: миниатюра → первый <img> из контента → прикреплённый файл.
• Источник найденного изображения фиксируется в журнале для диагностики.

1.0.35

• Исправлено (критично): загрузка изображений через MAX Upload API — метод исправлен с GET на POST /uploads?type=image.
• Прямой multipart-upload файла как основной метод (Метод A), двухшаговая загрузка как резервный (Метод B).
• 4 уровня отказоустойчивости: Метод A → Метод B → URL → только текст.
• Детальное логирование всех этапов загрузки изображений с HTTP-кодами и телом ответа MAX API.

1.0.32

• Поддержка WordPress Multisite — плагин работает на всех подсайтах сети.
• Сетевая лицензия — страница «Сеть → Ru-max (Сеть)» для суперадминистратора.
• Поддомены — лицензия на example.com автоматически покрывает все поддомены.
• Тумблер «Включить поддержку сети и поддоменов» в Дополнительных настройках.
• Реорганизована папка assets: CSS → assets/css/, JS → assets/js/.
• Совместимость с PHP 7.4 – 8.3.

1.0.31

• Кнопка «Поделиться в MAX» в конце каждой статьи/страницы.
• MAX-авторизация через Mini App (HMAC-SHA256 + initData, без OAuth 2.0).
• Кнопка «Войти через MAX» на странице входа, регистрации и WooCommerce.

1.0.30

• Уведомления об обновлении плагинов/ядра WordPress.
• Уведомления о критических PHP-ошибках сайта (не чаще 1 раза в 5 минут).

1.0.21

• Лицензирование: фоновая перепроверка ключа сокращена с 1 раза в сутки до 1 раза в час.
• При открытии вкладки «Активация» — принудительная сверка ключа, отозванные ключи определяются мгновенно.
• Кнопка «Проверить лицензию сейчас» + строка «Последняя проверка».
• Если ключ отозван — статус suspended, красная плашка, запись в логе.
• На вкладку «Активация» добавлен блок «Важная информация о лицензии» (2 200 ₽, бессрочная).
• Блок «Система скидок» перенесён со вкладки «Инструкция» на вкладку «Активация».
• В форму запроса ключа добавлено поле «Контакт для быстрой связи» (Telegram / MAX / WhatsApp / VK).

1.0.20

• Расширенные настройки попапа удержания: многострочные тексты, выравнивание, цвета и закругление кнопок.

1.0.19

• Добавлены «Сообщения на удержание» — попап при попытке закрыть приветствие чат-виджета.
• Исправлен предварительный просмотр анимации привлечения внимания в админке.

Полный список изменений — в readme.txt.

10. Multisite и поддомены

Начиная с версии 1.0.32 плагин полностью поддерживает WordPress Multisite (сеть сайтов) и автоматическое распространение лицензии на поддомены.

Как активировать лицензию для всей сети

1. Убедитесь, что плагин активирован на уровне сети: Сеть → Плагины → WP Ru-max → Активировать сетево.
2. Перейдите в Сеть → Ru-max (Сеть).
3. Введите лицензионный ключ и нажмите «Активировать для всей сети».
4. Все подсайты сети автоматически получат активированный плагин.

Как включить поддержку поддоменов (один ключ — все субдомены)

1. На главном сайте перейдите в Ru-max → Дополнительные настройки.
2. Включите тумблер «Включить поддержку сети и поддоменов» и сохраните.
3. На вкладке Ru-max → Активация введите лицензионный ключ.
4. Готово — все поддомены этого сайта автоматически активированы.

Покрытие лицензии

Лицензия на домен example.com автоматически распространяется на:

• example.com ✓
• shop.example.com ✓
• blog.example.com ✓
• test.beta.example.com ✓
• otherdomain.com ✗ — чужой домен не покрывается

Важно: активация на чужом домене невозможна. Лицензия строго привязана к домену и его поддоменам.

Настройки на каждом подсайте

Каждый подсайт управляет своими настройками независимо: токен бота, каналы, уведомления, виджет. Общая только лицензия.

11. Поддержка

← На главную