AppSuite:Writing a simple application with embedded iframe: Difference between revisions

From Open-Xchange
No edit summary
No edit summary
 
(27 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Stability-experimental}}
The content on this page has moved to https://documentation.open-xchange.com/latest/ui/customize/app/simple-application-iframe.html


<div class="title">Writing a simple application with an embedded iframe</div>
Note: Open-Xchange is in the process of migrating all its technical documentation to a new and improved documentation system (documentation.open-xchange.com). Please note as the migration takes place more information will be available on the new system and less on this system. Thank you for your understanding during this period of transition.
 
__TOC__
 
==Add app to the launcher==
 
To display an additional App in the AppLauncher, the property „topbar“ = true has to be set in the manifest.json file of the app.
To define the order position use the index value in the manifest.json file.
 
==reorder  / remove Apps from AppLauncher==
 
To define a custom order of the apps or remove an app from the AppLaucher the server-side setting topbar/order can be used to provide a comma-separated list of apps wich should be available in the AppLauncher.
Example: io.ox/core//topbar/order=io.ox/mail,io.ox/contacts,io.ox/portal
An app wich is not listed here ain’t available in the AppLauncher.
 
==Provide an iframe for the content area==
 
Developing an additional app wich provide an iframe for the content area is quite easy.
All it needs is a manifest file
manifest.json
 
and the app file main.js
It is convention to name your main application file main.js.
 
Both should be located in an designated folder in the apps folder.
In this example the namespace com.example will be used. (apps/com.example)
 
To make use of the provided helper function io.ox/core/tk/iframe has to be required in the define section.
The following option for creating the app are available:
        name: 'com.example‘, // the name of the app
        title: gt('Hallo, World!‘), // the title of the app as used in the AppLauncher
        pageTitle: gt('Hallo, World!‘), // the page Title
        domain: 'https://ox6-dev.open-xchange.com/', // the domain wich should be used for the iframe
        cssNamespace: 'hallo_world‘ // a css class used for namespacing,
        acquireToken: true // generates a login token and appends it to the supplied url
 
Make sure you build the app (grunt clean default)

Latest revision as of 09:24, 22 May 2017

The content on this page has moved to https://documentation.open-xchange.com/latest/ui/customize/app/simple-application-iframe.html

Note: Open-Xchange is in the process of migrating all its technical documentation to a new and improved documentation system (documentation.open-xchange.com). Please note as the migration takes place more information will be available on the new system and less on this system. Thank you for your understanding during this period of transition.