Поля WT Max для Joomla Form

WT Max библиотека для интеграции с Joomla - Документация
Категория: Библиотеки

Семь готовых полей 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. Оно не входит в семь перечисленных полей библиотеки.

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

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

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