Difference between revisions of "AppSuite:Writing a notification area plugin"

(Basic Notification)
(Replaced content with "The content on this page has moved to https://documentation.open-xchange.com/latest/ui/customize/notifications.html Note: Open-Xchange is in the process of migrating all...")
 
(34 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="title">Writing a plugin for the notification area</div>
+
The content on this page has moved to https://documentation.open-xchange.com/latest/ui/customize/notifications.html
  
'''Abstract:''' This article is a step by step tutorial to build your own notification plugin.
+
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.
These plugins can be used for various purposes, for example reminding the user of something or showing him new invitations.
 
 
 
__TOC__
 
 
 
==Basic Notification==
 
 
 
First let's start with showing the most basic notification plugin you can write.
 
Create a file named ''register.js'' at ''plugins/notifications/tutorial''.
 
 
 
This code doesn't have api suppport or other things but adds a hello world notification:
 
 
 
<pre class="language-javascript">
 
define('plugins/notifications/tutorial/register', [
 
    'io.ox/core/extensions',
 
    'io.ox/core/notifications/subview'
 
], function (ext, Subview) {
 
 
 
    'use strict';
 
 
 
    ext.point('io.ox/core/notifications/tutorial/item').extend({
 
        draw: function () {
 
            this.append( $('<span>').text('hello world'));
 
        }
 
    });
 
 
 
    ext.point('io.ox/core/notifications/register').extend({
 
        id: 'tutorialplugin',
 
        index: 1000,
 
        register: function () {
 
            var options = {
 
                    id: 'io.ox/tutorialplugin',
 
                    title: 'Test Notifications',
 
                    extensionPoints: {
 
                        item: 'io.ox/core/notifications/tutorial/item'
 
                    }
 
                },
 
                subview  = new Subview(options);
 
 
 
            subview.resetNotifications({ id: 'myNotification1' });
 
        }
 
    });
 
 
 
    return true;
 
});
 
 
 
</pre>
 
 
 
This code extends two extension points: ''io.ox/core/notifications/tutorial/item'' and ''io.ox/core/notifications/register''
 
 
 
We use ''io.ox/core/notifications/tutorial/item'' to draw our notification items. Here it's a simple ''hello world'' text.
 
 
 
''io.ox/core/notifications/register'' is used by the notification area to load the different plugins. Those plugins are implemented as subviews of the main notification area. The index determines the order of the different subviews.
 
We define some options for our view here:
 
 
 
* id: the internalId for our subview
 
* title: the text in the header of our subview
 
* extensionPoints: here we tell the subview which extensionpoints to use when drawing our notifications. For now we only use ''io.ox/core/notifications/tutorial/item'' to draw our items.
 
 
 
More options will be explained later on.
 
 
 
Now we create our view and add notification to it:
 
<pre class="language-json">
 
subview  = new Subview(options);
 
 
 
subview.resetNotifications({ id: 'myNotification1' });
 
</pre>
 
 
 
===Adding a manifest===
 
 
 
Now we need to add a ''manifest.json'' file at ''plugins/notifications/tutorial'' with the following contents:
 
 
 
<pre class="language-json">
 
{
 
    "namespace": "io.ox/core/notifications",
 
    "requires": ""
 
}
 
</pre>
 
 
 
This manifest makes sure our code is loaded. You can also define capabilities like ''webmail'' here, if your notifications require specific capabilities to be enabled. They only show up if a user has these capabilities.
 
 
 
===Testing our notification===
 
 
 
Now it's time to test our notification. Build the UI and add ''&customManifests=true'' to the url, because our manifest is only present locally.
 
 
 
after reloading you should see something like this:
 
 
 
[[Image: basicNotification.png]]
 

Latest revision as of 09:36, 22 May 2017

The content on this page has moved to https://documentation.open-xchange.com/latest/ui/customize/notifications.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.