IM_TEXTAREA

Просмотров: 10385
Дата последнего изменения: 20.04.2023

Анна Кокина

Сложность урока:

3 уровень - средняя сложность. Необходимо внимание и немного подумать.

Приложение для панели над полем ввода

Код встраивания: IM_TEXTAREA

Данный формат был и раньше – это генерация контента в момент написания сообщения.

Параметры

Параметр	Обязат.	Описание
iconName	Да	Название класса иконки в формате Font Awesome (например, fa-cloud).
context	Нет	Для какого типа чата встраивать приложение (по умолчанию ALL). Поддерживает множественный выбор через `;` следующих значений: USER – чаты всех пользователей, исключая ботов; CHAT – все групповые чаты, кроме lines и crm; LINES – тип чата lines (открытые линии); CRM – только чаты, созданные в рамках CRM; ALL – все чаты.
role	Нет	Роль пользователя, для которой доступно это приложение (по умолчанию USER). Поддерживает следующие значения: USER – приложение доступно для всех пользователей; ADMIN – приложение доступно только для администраторов портала.
color	Нет	Цвет. Доступны значения: RED, GREEN, MINT, LIGHT_BLUE, DARK_BLUE, PURPLE, AQUA, PINK, LIME, BROWN, AZURE, KHAKI, SAND, ORANGE, MARENGO, GRAY, GRAPHITE.
width	Нет	Рекомендуемая ширина фрейма как в старом чате (по умолчанию 100).
height	Нет	Рекомендуемая высота фрейма как в старом чате (по умолчанию 100).
extranet	Нет	Доступно ли приложение для экстранет-пользователей (по умолчанию N). Поддерживает следующие значения: N – приложение недоступно для экстранет-пользователей; Y – приложение доступно для экстранет-пользователей.

В данном встраивании доступен текущий контекст открытия, будет передан dialogId текущего чата.

const context = BX24.placement.info().options;

Будет открыт IFRAME приложения с заданными размерами. Если вы укажете размер приложения больше, чем может быть показан, то этот размер автоматически будет уменьшен (ваше приложение должно это учитывать).

Пример вызова:

CRest::call(
    'placement.bind',
    [
        'PLACEMENT' => 'IM_TEXTAREA',
        'HANDLER' => 'https://example.com/apps/immarket/handlers/textarea.php',
        'LANG_ALL' => [
            'ru' => [
                'TITLE' => 'Приложение для панели над полем ввода',
            ],
        ],
        'OPTIONS' => [
            'iconName' => 'fa-bars',
            'context' => 'USER;CHAT',
            'role' => 'USER',
            'color' => 'GRAPHITE',
            'width' => '200',
            'height' => '100',
            'extranet' => 'N',
        ]
    ]
);

Курсы разработаны в компании «1С-Битрикс»