AppSuite:Capabilities: Difference between revisions
Line 23: | Line 23: | ||
com.openexchange.capability.[myproduct]=false # off for everyone | com.openexchange.capability.[myproduct]=false # off for everyone | ||
Then restart the OX Application Server and afterwards use the general OX AppSuite commandline tools to enable the capability/capabilities. The commandline tools | Then restart the OX Application Server and afterwards use the general OX AppSuite commandline tools to enable the capability/capabilities. | ||
The commandline tools used in the following examples are located in: | |||
/opt/open-xchange/sbin | /opt/open-xchange/sbin |
Revision as of 08:25, 10 January 2014
Synopsis: How to use capabilities so that your new AppSuite plugin can be enabled or disabled.
What are capabilities?
Usecase
You write a new UI app or plugin (chat module, for example) and want to make sure that only a specific set of users or contexts within the system can it.
Example: Your chat app should only be available after a user has bought it in your online shop. To do so, you will need to implement the capabilities logic within your UI app or plugin and restrict it to a user or context marked accordingly (called "premium" in further examples).
Set a capability
First, disable it for everyone as default (or enable it for everyone, depending on what your aim is).
In /opt/open-xchange/[myproduct].properties:
com.openexchange.capability.[myproduct]=false # off for everyone
Then restart the OX Application Server and afterwards use the general OX AppSuite commandline tools to enable the capability/capabilities.
The commandline tools used in the following examples are located in:
/opt/open-xchange/sbin
In this example, only for a specific user:
changeuser ... --config/com.openexchange.capability.[myproduct]=true
...or for a full context:
changecontext -c ... --config/com.openexchange.capability.[myproduct]=true
...or set the capability to a context set:
changecontext -c ... --taxonomy/types=premium
in /opt/open-xchange/etc/contextSets/premium.yml:
premium: com.openexchange.config.capability.[myproduct]: true withTags: premium
Query capabilities via the HTTP API
Query:
GET /appsuite/api/capabilities?action=all&session=991fd40f635b45...
Response:
{"data":[{"id":"oauth","attributes":{}},{"id":"webmail","attributes":{}},{"id":"document_preview","attributes":{}},{"id":"printing","attributes":{}},{"id":"spreadsheet","attributes":{}},{"id":"gab","attributes":{}},{"id":"multiple_mail_accounts","attributes":{}},{"id":"publication","attributes":{}},{"id":"rss_bookmarks","attributes":{}},{"id":"linkedin","attributes":{}},{"id":"filestore","attributes":{}},{"id":"ical","attributes":{}},{"id":"rt","attributes":{}},{"id":"olox20","attributes":{}},{"id":"forum","attributes":{}},{"id":"active_sync","attributes":{}},{"id":"conflict_handling","attributes":{}},{"id":"rss_portal","attributes":{}},{"id":"oxupdater","attributes":{}},{"id":"infostore","attributes":{}},{"id":"contacts","attributes":{}},{"id":"collect_email_addresses","attributes":{}},{"id":"facebook","attributes":{}},{"id":"drive","attributes":{}},{"id":"rss","attributes":{}},{"id":"pinboard_write_access","attributes":{}},{"id":"mobility","attributes":{}},{"id":"calendar","attributes":{}},{"id":"participants_dialog","attributes":{}},{"id":"edit_public_folders","attributes":{}},{"id":"text","attributes":{}},{"id":"groupware","attributes":{}},{"id":"msisdn","attributes":{}},{"id":"carddav","attributes":{}},{"id":"tasks","attributes":{}},{"id":"portal","attributes":{}},{"id":"mailfilter","attributes":{}},{"id":"read_create_shared_folders","attributes":{}},{"id":"vcard","attributes":{}},{"id":"pim","attributes":{}},{"id":"caldav","attributes":{}},{"id":"projects","attributes":{}},{"id":"usm","attributes":{}},{"id":"webdav","attributes":{}},{"id":"dev","attributes":{}},{"id":"delegate_tasks","attributes":{}},{"id":"freebusy","attributes":{}},{"id":"subscription","attributes":{}},{"id":"linkedinPlus","attributes":{}},{"id":"autologin","attributes":{}},{"id":"webdav_xml","attributes":{}},{"id":"twitter","attributes":{}}]}
Here id is the name of the capability.
Query capabilities in the UI
require(['io.ox/core/capabilities'], function (cap) { if cap.has('[myproduct]' { ... } );
Require the capabilities in your UI manifest
{ namespace: ... requires: '[myproduct]' }
The plugin will only be loaded if the capability is set for the specific user.
Testing the capabilities
- For testing purposes use these 2 easy steps:
+ Add the "&cap=[myproduct]" URL parameter in your AppSuite browser tab + Reload the UI to temporarly test/enable a capability.
Further informations
- Similarly, you can disable a capability with &disableFeature=[myproduct]
- If you want to know about existing capabilities and the way they are used for upsell, see AppSuite:Upsell#Capabilities_and_Upsell_triggers