---
title: "Поля WT Max для Joomla Form — WT Max - WebTolk"
description: "Семь готовых полей WT Max: статус подключения, выбор и карточка чата, секрет и URL вебхука, управление подписками. Примеры XML для ваших расширений."
url: "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/polya-wt-max-joomla-form"
date: "2026-11-17T13:18:12+00:00"
language: "ru-RU"
---

## Breadcrumbs

[Главная](https://web-tolk.ru/) > [Расширения Joomla](https://web-tolk.ru/dev) > [Библиотеки](/dev/biblioteki) > [WT Max библиотека для интеграции с Joomla](/dev/biblioteki/wt-max-platform) > Документация > Поля WT Max для Joomla Form

# Поля WT Max для Joomla Form

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

**Категория:** [Библиотеки](https://web-tolk.ru/dev/biblioteki)

[Проект](https://web-tolk.ru/dev/biblioteki/wt-max-platform)[Версии](https://web-tolk.ru/dev/biblioteki/wt-max-platform/versions)[Документация](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation)[GitHub](https://github.com/WebTolk/WT-Max-Joomla-library)

Семь готовых полей 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](https://dev.max.ru/docs-api/use-cases/getting-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

- [Установка и настройка WT Max для Joomla](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/ustanovka-i-nastrojka-wt-max)
- [Отправка сообщений через onWtmaxSendMessage](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/onwtmaxsendmessage-otpravka-soobshchenij)
- [Входящие вебхуки MAX и событие onWtmaxIncomingWebhook](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/vebhuki-max-onwtmaxincomingwebhook)
- [Работа с MAX API через PHP SDK в Joomla](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/max-php-sdk-v-joomla)
- [Логирование и диагностика WT Max](https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/dev/biblioteki/wt-max-platform/documentation/logirovanie-i-diagnostika-wt-max)

## JSON-LD Schema

```json
{
    "@context": "https://schema.org",
    "@type": "BreadcrumbList",
    "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17",
    "itemListElement": [
        {
            "@type": "ListItem",
            "position": 1,
            "item": {
                "@id": "https://web-tolk.ru/",
                "name": "Главная"
            }
        },
        {
            "@type": "ListItem",
            "position": 2,
            "item": {
                "@id": "https://web-tolk.ru/dev",
                "name": "Расширения Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 3,
            "item": {
                "@id": "/dev/biblioteki",
                "name": "Библиотеки"
            }
        },
        {
            "@type": "ListItem",
            "position": 4,
            "item": {
                "@id": "/dev/biblioteki/wt-max-platform",
                "name": "WT Max библиотека для интеграции с Joomla"
            }
        },
        {
            "@type": "ListItem",
            "position": 5,
            "item": {
                "name": "Поля WT Max для Joomla Form"
            }
        }
    ]
}
```

```json
{
    "@context": "https://schema.org",
    "@graph": [
        {
            "@type": "Organization",
            "@id": "https://web-tolk.ru/#/schema/Organization/base",
            "name": "WebTolk",
            "url": "https://web-tolk.ru/",
            "logo": {
                "@type": "ImageObject",
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo",
                "url": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "contentUrl": "https://web-tolk.ru/images/webtolk-1080p.jpg",
                "width": 1920,
                "height": 1080
            },
            "image": {
                "@id": "https://web-tolk.ru/#/schema/ImageObject/logo"
            },
            "sameAs": [
                "https://github.com/WebTolk",
                "https://github.com/sergeytolkachyov",
                "https://vk.com/web_tolk",
                "https://vk.com/webtolkru",
                "https://tenchat.ru/sergeytolkachyov",
                "https://t.me/sergeytolkachyov",
                "https://t.me/webtolkru"
            ]
        },
        {
            "@type": "WebSite",
            "@id": "https://web-tolk.ru/#/schema/WebSite/base",
            "url": "https://web-tolk.ru/",
            "name": "WebTolk",
            "publisher": {
                "@id": "https://web-tolk.ru/#/schema/Organization/base"
            }
        },
        {
            "@type": "WebPage",
            "@id": "https://web-tolk.ru/#/schema/WebPage/base",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/polya-wt-max-joomla-form",
            "name": "Поля WT Max для Joomla Form — WT Max - WebTolk",
            "description": "Семь готовых полей WT Max: статус подключения, выбор и карточка чата, секрет и URL вебхука, управление подписками. Примеры XML для ваших расширений.",
            "isPartOf": {
                "@id": "https://web-tolk.ru/#/schema/WebSite/base"
            },
            "about": {
                "@id": "https://web-tolk.ru/#/schema/TechArticle/base"
            },
            "inLanguage": "ru-RU",
            "breadcrumb": {
                "@id": "https://web-tolk.ru/#/schema/BreadcrumbList/17"
            }
        },
        {
            "@type": "TechArticle",
            "headline": "Поля WT Max для Joomla Form",
            "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/polya-wt-max-joomla-form",
            "description": "Семь готовых полей WT Max: статус подключения, выбор и карточка чата, секрет и URL вебхука, управление подписками. Примеры XML для ваших расширений.",
            "mainEntityOfPage": {
                "@type": "WebPage",
                "url": "https://web-tolk.ru/dev/biblioteki/wt-max-platform/documentation/polya-wt-max-joomla-form"
            }
        }
    ]
}
```
