Custom gadgets
The following procedure describes how to configure/install custom gadgets for the Planon home page.
Custom gadgets are html files referred to from an external content web definition in Web configuration.
Currently, there are two ways of creating custom gadgets: a preferred way that is available for both on-premise and Cloud, and a way that is only available to on-premise installations.
Preferred way
This way creating custom gadgets is done from within the Planon application itself. It does not require you to meddle with the installation directory.
The configuration of custom gadgets is done in Web configuration: Adding Web content.
On-premise only
 | The following procedure is only possible for on-premise installations. |
The Planon installation root folder contains a folder called customization. This folder can be used for your custom files. This folder will not be removed during upgrades.
To install/deploy a custom gadget
1. Create a subfolder called gadgetsin the customization folder.
2. Place all gadget related files in the gadgets folder. For example: \customization\gadgets\gadget.html
Note that each gadget must be configured in Web configuration.
1. Create an External content web definition.
2. Point the Content URL field to the gadget.
For example, http://[server]:[port]/customization/gadgets/gadget.html. Or using a relative path such as "../../customization/gadgets/gadget.html"
3. Add a block to the Homepage web definition and link it to the external content web definition.
| | For more information, see Web Configuration > Adding gadgets to the homepage. |