Поля WT Max для Joomla Form
Семь готовых полей WT Max: статус подключения, выбор и карточка чата, секрет и URL вебхука, управление подписками. Примеры XML для ваших расширений.
Подключение полей
Установите полный пакет WT Max и включите системный плагин. Поля библиотеки находятся в пространстве имён Webtolk\Wtmax\Field. Укажите addfieldprefix на группе полей или на отдельном поле XML-формы.
| Тип поля | Назначение |
|---|---|
connectionstatus |
Статус подключения и сведения о боте. |
chatmodalselect |
Выбор чата через ModalSelect Joomla; сохраняет chat_id. |
chatinfo |
Карточка чата, ID которого читается из соседнего поля. |
webhooksecret |
Поле секрета; генерирует значение, если поле пустое. |
webhookurl |
Показывает URL входящего вебхука с секретом. |
webhookactions |
Создание и удаление подписок через системный плагин. |
subscriptionslist |
Список текущих подписок MAX. |
Статус подключения, выбор и карточка чата
<form>
<fields name="params" addfieldprefix="Webtolk\Wtmax\Field">
<fieldset name="max" label="MAX">
<field type="connectionstatus" name="connectionstatus" />
<field type="chatmodalselect" name="max_chat_id"
label="Чат MAX" />
<field type="chatinfo" name="max_chat_info"
chat_field="max_chat_id" />
</fieldset>
</fields>
</form>
chatinfo не хранит самостоятельное значение. Атрибут chat_field указывает имя поля с ID в той же группе формы. Группа может называться иначе, чем params. Карточка обновляется после сохранения и повторной загрузки формы.
Как работает выбор чата
В текущей реализации введите известный ID чата или канала, выполните поиск и выберите найденную строку. Поддерживаются отрицательные ID. Если поиск пустой, отображаются известные ID из текущего значения поля и сохранённых настроек системного плагина: default_chat_id и allowed_chat_ids. Для каждого вызывается получение карточки по ID; недоступный чат сопровождается предупреждением.
Это не список всех чатов бота: соответствующий список MAX API не предоставляет. Выбор не добавляет чат в разрешённый список входящих вебхуков. Подробнее — как получить chat_id.
Поля вебхуков
<form>
<fields name="params" addfieldprefix="Webtolk\Wtmax\Field">
<fieldset name="webhook" label="Вебхуки MAX">
<field type="webhooksecret" name="webhook_secret"
label="Секрет вебхука" filter="raw" />
<field type="webhookurl" name="webhook_url"
label="Webhook URL" />
<field type="webhookactions" name="webhook_actions"
label="Действия с подпиской" />
<field type="subscriptionslist" name="webhooks_list" />
</fieldset>
</fields>
</form>
Эти поля помогают собрать интерфейс, но управление подпиской и приём запросов выполняет System - WT Max со своими сохранёнными настройками. Поля в форме стороннего расширения сами по себе не перенастраивают системный плагин. Для рабочего входящего вебхука сначала настройте его вкладку «Вебхуки».
Параметры подключения и доступ
connectionstatus и subscriptionslist используют токен системного плагина, когда в параметрах формы нет собственного bot_token. Явно заданный пустой токен остаётся пустым. Выбор чата и управление подписками используют административные AJAX-точки WT Max и сессию Joomla.
plugininfo из настроек WT Max — отдельное поле самого плагина с префиксом Joomla\Plugin\System\Wtmax\Field. Оно не входит в семь перечисленных полей библиотеки.