Установка и настройка WT Max для Joomla

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-сайт.

Установка и подключение

  1. Скачайте готовый установочный ZIP со страницы проекта или из GitHub Releases. Устанавливайте пакет целиком: он содержит библиотеку, плагин и зависимости SDK.
  2. Установите ZIP через стандартный установщик расширений Joomla.
  3. Откройте «Система → Управление → Плагины», найдите System - WT Max и включите его.
  4. В параметре «Токен бота MAX» укажите токен вашего бота и сохраните настройки.
  5. Повторно откройте настройки. Поле статуса подключения должно показать сведения о боте. При ошибке проверьте токен, сетевой доступ сервера и доверенные сертификаты 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 на сервере или повторно указывать токен для обычной интеграции не требуется.

Другие разделы WT Max

Расширения Joomla WebTolk

113 Всего расширений
12 Категорий
588 Выпущено версий
949240 Всего скачиваний