How they work
Because the Domain Widget code is loaded directly from a central database, any updates that are made to the Domain Widget by the admins are automatically reflected on all widgets of that type throughout the domain. Unlike Custom Widgets, Domain Widgets will render the same way for the dashboard owner, portal managers, private viewers or public viewers. As it is added by the domain admin, it is considered ‘safe’ and warning messages to anyone but the owner are disabled.
More information about how the Custom Widget works can be found on the Custom Widget documentation page.
Examples for Custom Widget scripts can be found on the Custom Widget Github page.
Setting up a Domain Widget
Domain Widgets can be created and managed on the ‘Domain Widget’ page in the subdomain admin interface, found on the left menu under 'Domain Setup'.
There are three fields which can be configured when creating or editing a Domain Widget.
- Name : Displays as the ‘Widget Type’ when a user is creating a new widget or is viewing the widget’s edit page. Required field.
- Description : The ‘Description’ when a user is creating a new widget. Optional.
After a Domain Widget has been created, it will need to be ‘Published’ in order for a user to be able to select it from the add widget process on their dashboard. Domain Widgets that have already been added to a dashboard will continue to function properly if it has been ‘Unpublished’. If the Domain Widget has been deleted, the user’s widget will not work anymore.