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

1. Установка

Поддерживается WordPress 5.8+ и PHP 7.4+. Тестировано на PHP 8.0–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) — владелец свяжется и вышлет ключ.

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

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

На активной лицензии есть кнопка ручной перепроверки и строка «Последняя проверка». В фоне ключ сверяется раз в час (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.21

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

1.0.20

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

1.0.19

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

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

10. Поддержка

← На главную