To make an add-on available in the Marketplace for users within an organization's Private Cloud or On-Premises installation, navigate to Marketplace in the System Admin panel and choose Manage add-ons.
Click + add-on and select the add-on script (.js file)
In the first step of the add-on installation process, all add-on properties are extracted and the add-on code is validated. Click Next to proceed.
In the second step, additional information can be added for the add-on that will be displayed in the add-on details:
- Website - to link the add-on to a site for more information about the add-on or the developer of the add-on.
- Developer email - email address of the developer used to receive suggestions, improvements or bug reports from users
- Icon / Image - image or icon for the add-on as displayed in the Marketplace
- Images - images displayed in the additional add-on information to promote, demonstrate or explain the add-on functionality
- Category - the category under which the add-on will be listed in the Marketplace
- Product Compatibility - the compatibility with our software products eLabJournal or eLabInventory
- Release Notes - information specific to the release of this add-on version
In the final step the add-on scope can be added. The add-on scope defines the level for which installation of the add-on will be possible. Typically installing the add-on for the scope user offers the most flexibility but depending on the add-on functionality or requirement to control installation of the functionality a different scope is more suitable.
An add-on can be installed on one of the 3 following scopes:
- System - The add-on will become available for installation for the system. (upon installation the add-on will be activated for all users in the system)
- Group -The add-on will become available for installation for a group (upon installation the add-on will be activated for all users in the group)
- User - The add-on will become available for installation for a user (upon installation the add-on will only be activated for the user)
The chosen add-on scope also defines who can install and activate the add-on.
- System add-ons can only be installed and activated by the System administrator via the System Marketplace. System add-ons will be displayed in the Marketplace for all users but users will not be able to install these add-ons themselves. Once a system add-on has been installed, it appears as installed for all users in the system.
- Group add-ons can only be installed by users with the permission to add add-ons for the group. Group add-ons will appear in the Marketplace for all users, but only users with the permission to install group add-ons can do so. Once a group add-on has been installed, it appears as installed for all users in the group.
- User add-ons can be installed by all users as long as they have the permission to install add-ons for the user.
Note: an add-on can currently only be installed for 1 scope
After selecting the scope, click Save. All added add-ons are by default available in the Marketplace for users within the system or all users or groups. To restrict access to the add-on select the corresponding option, select the option Make this add-on only available in the Marketplace for specific users or groups.
Depending on the selected scope, optionally select specific organisations, groups or users for which the add-on should be made available in the Marketplace only.
Note: when adding the add-on for a specific organisation, group or user, the add-on will not be made available in the Marketplace for other organisations, groups or users
In an eLabNext Private Cloud or On-Premises installation, only add-ons that are available for the system (e.g. private add-ons) can be installed. In cases where a private add-on has been developed that might be of interest for public use, please contact eLabNext support for more information on how to submit the add-on to the public Marketplace.