Отправка сообщений через onWtmaxSendMessage
Как отправить сообщение MAX из расширения Joomla: получатель, форматы plain/Markdown/HTML, локальные вложения, кнопки и результат отправки.
Событие для исходящей отправки
onWtmaxSendMessage обрабатывается системным плагином WT Max. Он использует настроенный токен, выбирает чат, готовит сообщение и вложения, вызывает MAX API и сохраняет сведения об успешной отправке.
Полный пример
Замените ID чата и путь к изображению своими значениями. Файл должен существовать внутри сайта Joomla.
<?php
declare(strict_types=1);
use Joomla\CMS\Event\AbstractEvent;
use Joomla\CMS\Factory;
use Joomla\CMS\Plugin\PluginHelper;
defined('_JEXEC') or die;
$app = Factory::getApplication();
$dispatcher = $app->getDispatcher();
PluginHelper::importPlugin('system', 'wtmax', true, $dispatcher);
$event = AbstractEvent::create('onWtmaxSendMessage', [
'subject' => $app,
'message' => "**Новый заказ**\nНомер: 10",
'attachments' => [
['type' => 'image', 'path' => 'images/orders/order-10.jpg'],
['type' => 'link', 'url' => 'https://example.com/orders/10', 'text' => 'Открыть заказ'],
],
'params' => [
'chat_id' => 123456,
'text_format' => 'markdown',
'context' => 'com_example.order',
'item_id' => 10,
'notify' => true,
'disable_link_preview' => false,
],
]);
$dispatcher->dispatch($event->getName(), $event);
$result = $event->getArgument('result', []);
if (($result['success'] ?? false) !== true) {
$app->enqueueMessage(
(string) ($result['error'] ?? 'Обработчик WT Max не вернул успешный результат'),
'error'
);
}
Аргументы события
| Аргумент | Назначение |
|---|---|
message |
Текст сообщения. Можно передать пустую строку при наличии вложений. |
attachments |
Массив файловых вложений, link-кнопок или готовых объектов AttachmentPayloadInterface. |
link |
Дополнительный HTTP(S) URL или HTML-ссылка. Корректная ссылка превращается в inline-кнопку. |
params['chat_id'] |
Получатель конкретного сообщения. Если корректный ID не задан, используется чат по умолчанию из плагина. |
params['text_format'] |
plain, markdown или html. |
params['context'], params['item_id'] |
Привязка записи журнала к объекту вашего расширения. |
params['notify'] |
Флаг уведомления MAX. |
params['disable_link_preview'] |
Управление предпросмотром ссылок для этой отправки. |
Форматирование текста
По умолчанию используется plain text: HTML-теги удаляются, сущности декодируются, переносы <br> и границы абзацев сохраняются. Для Markdown или HTML формат нужно указать явно. В этих режимах текст передаётся с разметкой.
// Фрагменты аргументов для AbstractEvent::create():
'message' => '<strong>Новый заказ</strong><br><em>Номер: 10</em>',
'params' => ['text_format' => 'html'],
Поддерживаемая MAX разметка описана в официальном справочнике форматирования. Любое неподдерживаемое значение text_format отклоняется до загрузки файлов и отправки сообщения.
Файлы и кнопки
- Строка
'images/example.jpg'задаёт локальный файл с автоматическим определением типа по MIME. - Массив
['type' => 'image|video|audio|file', 'path' => '...']задаёт тип явно. Он должен соответствовать MIME файла. - Для файлов принимаются только локальные пути внутри корня Joomla. Удалённый URL не загружается как файловое вложение.
['type' => 'link', 'url' => 'https://...', 'text' => 'Открыть']создаёт inline-кнопку. Разрешены HTTP и HTTPS.
Результат и журнал
При успехе в result возвращаются success => true и message с данными MAX. При ошибке — success => false и error. Проверяйте этот результат после dispatch.
Плагин записывает идентификатор сообщения, чат, контекст, ID объекта, число вложений и время в таблицу #__plg_system_wtmax_messages. Прямые вызовы SDK обходят этот механизм. Если отправка прошла, а запись в БД завершилась ошибкой, повторная отправка может создать дубликат: сначала проверьте чат.