Установка и настройка WT Max для Joomla
Установка библиотеки WT Max, подключение бота MAX, настройка системного плагина и выбор чата для исходящих сообщений.
Что устанавливает WT Max
WT Max связывает Joomla с MAX Bot API. Пакет включает библиотеку Webtolk/Wtmax, системный плагин System - WT Max и готовые поля Joomla Form. Внутри используется самостоятельный PHP SDK webtolk/max.
Требования библиотеки: Joomla 5.0 или новее, PHP 8.1 или новее и токен бота MAX. Для входящих вебхуков нужен доступный из интернета HTTPS-сайт.
Установка и подключение
- Скачайте готовый установочный ZIP со страницы проекта или из GitHub Releases. Устанавливайте пакет целиком: он содержит библиотеку, плагин и зависимости SDK.
- Установите ZIP через стандартный установщик расширений Joomla.
- Откройте «Система → Управление → Плагины», найдите
System - WT Maxи включите его. - В параметре «Токен бота MAX» укажите токен вашего бота и сохраните настройки.
- Повторно откройте настройки. Поле статуса подключения должно показать сведения о боте. При ошибке проверьте токен, сетевой доступ сервера и доверенные сертификаты PHP.
Токен хранится в параметрах системного плагина. Сторонним расширениям обычно достаточно получить настроенный SDK через Wtmax::getInstance() или отправить событие onWtmaxSendMessage.
Чат по умолчанию
Поле «MAX chat_id по умолчанию» задаёт получателя для onWtmaxSendMessage, когда событие не передало свой корректный params['chat_id']. Сохраните настройки после выбора чата. Соседняя карточка показывает название, ID и доступные сведения о чате.
В текущем окне выбора чата можно ввести известный chat_id или ID канала и нажать «Найти чат / обновить», затем выбрать найденную строку. Отрицательные ID поддерживаются. Если строка поиска пуста, окно показывает сохранённое значение и чаты из настроек default_chat_id и allowed_chat_ids, запрашивая каждый по ID.
API MAX не предоставляет список всех групп и каналов бота. Как получить идентификатор, описано в официальной инструкции MAX. Если в установленной сборке нет поиска по ID, обновите WT Max до сборки с этим полем.
Исходящие сообщения и вебхуки
Для исходящих сообщений достаточно включённого плагина, токена и доступного боту чата. Входящие вебхуки включаются отдельно во вкладке «Вебхуки». Их список разрешённых чатов ограничивает только входящие события; выбор получателя исходящего сообщения его не меняет.
Первый запрос из Joomla
<?php
declare(strict_types=1);
use Webtolk\Wtmax\Wtmax;
defined('_JEXEC') or die;
$max = Wtmax::getInstance();
$bot = $max->bots()->me();
echo htmlspecialchars((string) $bot->getUsername(), ENT_QUOTES, 'UTF-8');
Код выполняется внутри загруженной Joomla, например в вашем расширении. Отдельно создавать HTTP-транспорт, подключать Composer на сервере или повторно указывать токен для обычной интеграции не требуется.