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

(Provide an iframe for the content area (since 7.8))
 
(2 intermediate revisions by 2 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 and launcher link</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__
 
 
 
==Provide an iframe for the content area (since 7.8)==
 
 
 
Developing an app with an iframe for the content area is quite easy.
 
All it needs is a manifest file (manifest.json) and the app 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.
 
 
 
<pre class="language-javascript">
 
define('com.example/main', [
 
    'io.ox/core/tk/iframe',
 
    'gettext!com.example'
 
], function (createIframeApp, gt) {
 
 
 
    'use strict';
 
 
 
    var iframeApp = createIframeApp({
 
        name: 'com.example', // the name of the app
 
        title: gt('Hallo, World!'), // the title of the app as used in the launcher
 
        pageTitle: gt('Hallo, World!'), // the page Title
 
        url: 'https://www.example.com/', // the domain which should be used for the iframe
 
        acquireToken: true // generates a login token and appends it to the supplied url as ox_token parameter
 
    });
 
 
 
    return {
 
        getApp: iframeApp.getApp
 
    };
 
});
 
</pre>
 
 
 
The provided token can be used to generate a valid session with the  [[HTTP_API#Redeem_Token_.28since_7.4.0.29 | redeem token login process]].
 
 
 
==Add app to the launcher (since 7.8)==
 
 
 
To display an app in the launcher, the property 'topbar': true has to be set in the manifest.json file of the app.
 
To define the order, use the index value in the manifest.json file.
 
 
 
<pre class="language-javascript">
 
{
 
    "title": "Hallo, World!",
 
    "company": "external",
 
    "icon": "/images/icon.png",
 
    "category": "Dev",
 
    "settings": false,
 
    "index": 10000,
 
    "topbar": true
 
}
 
</pre>
 
 
 
==Reorder  / remove apps from launcher (since 7.6)==
 
 
 
To define a custom order of the apps or remove an app from the laucher the server-side setting topbar/order can be used to provide a comma-separated list of apps which should be available in the launcher.
 
 
 
Example: io.ox/core//topbar/order=io.ox/mail,com.example,io.ox/contacts,io.ox/portal
 
 
 
An app which is not listed here, is not available in the launcher anymore.
 

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.