Bitrix24 Applications

In addition to the main independent interface of the app itself located on a separate page, your app can add features into specially designated areas of standard interface: CRM object detail forms, various item lists and etc.

Install embedding location handler using placement.bind. Single application can setup an arbitrary number of handlers, even for the same embedding location (for example, when you need to add several actions into a Lead's context menu in CRM).

Handler is limited by following conditions:

• request for handler installation must be executed with administrator authentication granted,
• handler is located on the same domain as the registered redirect_uri of the application
• each placement is regulated by access permissions (scope). To install embedding location handler in the CRM interface, allow application to access the CRM. Additionally, the app must have embedding mechanism placement scope indicated directly.

When handler is installed, the method determines the embedding location. Take into account when developing context menu that any embedding location can have its own specifics for displaying and its own custom JS interface. For example, CRM_*_LIST_MENU embedding locations are sliders opened from context menu of corresponding CRM entities. On the other hand, a CALL_CARD is a switch of apps as tabs within call details.

Current available list of application embedding locations described in the REST API documentation.

Call example:

http://portal.bitrix24.com/rest/placement.bind/?access_token=sode3flffcmv500fuagrprhllx3soi72
    &PLACEMENT=CRM_CONTACT_LIST_MENU
    &HANDLER=http%3A%2F%2Fwww.applicationhost.com%2Fplacement%2F
    &TITLE=Text application

HTTP/1.1 200 OK

{
    "result": true
}

Call result: Application menu item with sub-item Test application appears within list of contacts context menu.

The example above, clicking on application item opens  the app's slider form. The slider form will show a frame with uploaded application using specified handler URL. Working inside this frame not very different from app operating in a separate page (basic variant of adding an interface), with several small exceptions:

• Changing frame size or affect parent window aren't allowed everywhere, methods BX24.resizeWindow, BX24.fitWindow, BX24.scrollParentWindow, BX24.reloadWindow are blocked.
• Placement handler call context data is passed via POST data when calling this handler. Such data is available via JS library using the method BX24.placement.info.

Here is a standard handler code:

echo '<pre>'; print_r($_REQUEST); echo '</pre>';

App embedded into the menu does not have any additional interface. Its obvious, because a slider overlaps the interface before it and doesn't allow handling it until the app is closed.

JS methods for application embedding are available for both embedding into an interface and for embedding on a simple app page with IFRAME employed. In this case, embedding locations are passed as DEFAULT, and menu context parameters are passed as page GET-parameters.

To open the app, use the method BX24.openApplication, for app closing - BX24.closeApplication