140  /  166

IM_TEXTAREA

Просмотров: 10536
Дата последнего изменения: 20.04.2023
Анна Кокина
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
1
2
3
4
5

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

Код встраивания: 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',
        ]
    ]
);



0
Курсы разработаны в компании «1С-Битрикс»
Доступна новая документация по REST: понятнее описания, больше примеров, удобнее поиск
Перейти