Просмотров: 10536
Дата последнего изменения: 20.04.2023
Сложность урока:
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',
]
]
);