Розробнику додатків для Маркетплейса Бітрікс24 доступний простий механізм вбудовування додатки в інтерфейс Бітрікс24.
Як вбудувати додаток
Для цього встановіть обробник місця вбудовування за допомогою placement.bind. Один додаток встановлює довільне число обробників, навіть для одного і того ж місця вбудовування.
Оброблювач обмежений умовами:
Метод при установці обробника визначає місця вбудовування додатки. При розробці контекстних додатків враховуйте, що кожне місце вбудовування - свої особливості відображення і свій js-інтерфейс. Наприклад, місця вбудовування CRM _ * _ LIST_MENU є попап, що відкриваються з контекстного меню відповідних сутностей CRM, а CALL_CARD буде являти собою перемикач додатків.
Результат виклику - в контекстному меню списку контактів з'являється пункт меню Програми з підпунктом Тестове додаток.
Як працює вбудований додаток
- Не скрізь буде дозволено змінювати розмір фрейму або впливати на батьківське вікно, методи BX24.resizeWindow. BX24.fitWindow. BX24.scrollParentWindow. BX24.reloadWindow заблоковані.
- Дані про контекст виклику обробника плейсменту будуть передані в POST-даних при виклику обробника і доступні через js-бібліотеку за допомогою методу BX24.placement.info.
Ось що вийде для найпростішого обробника з кодом:
При встановленні в меню додатка не надається ніякого додаткового інтерфейсу. Це не дивно, враховуючи, що модальне вікно перекриває інтерфейс CRM і не дає ніяк з ним працювати, поки у відкритій програмі.
JS методи вбудовування додатків доступні і при встановленні в інтерфейс і на звичайній сторінці додатка з фреймом. У цьому випадку місця вбудовування передається як DEFAULT, а параметри контексту виклику - GET-параметри сторінки.