Widgets
Homepage widgets are mini applications written in HTML, with JavaScript, and PHP. They allow the extension of Jadu Central to provide additional functionality and easy integration with third party applications.
note
Some widgets will have no checkbox in the list, as they are standard widgets provided by the system.
You can adjust the visibility settings of these widgets to prevent your authors using them.
Managing widgets
Widgets are managed via the Settings menu.
If your account has permission to access widgets, you navigate to their management area by the following:
- Click the Settings icon in the left navigation bar. The Settings menu will open.
- Click the Widget manager link in the first group of links. A list of widgets will now be shown, with links to create new widgets if your account has the appropriate access permissions.
Widget fields
| Field | Notes | Required? |
|---|---|---|
| Title | The name of the widget. | ✅ |
| Description | A short description of the widget. Limited to 200 characters. Can contain new lines. | ✅ |
| Default Width | The default width to apply when a widget is first dragged into a row. | |
| Requires Categories | Whether to show the Assign categories button in the widget settings tab. | |
| Signed in users only | Whether to show the widget's content to only users who have authenticated with the site. | |
| Scope | Which sites on this environment this widget is available to. | |
| Visible | Whether to show the widget in this site's homepage designer list of widgets. | |
| Front-end | The content of public.php. Used as the widget preview on Photon sites. | |
| Front-end JavaScript | The content of public.js | |
| Settings | The content of secure.php | |
| Settings JavaScript | The content of secure.js |
What to include in a widget zip archive
| File | Purpose |
|---|---|
| public.php | the file that contains the HTML or PHP you want your website visitors to see |
| public.js | the file that contains the JavaScript used in public.php. This file is optional. The javascript in this file is combined and published dynamically as widget.js. Dependent on your site's implementation, widget.js maybe included only on homepages or on all pages of the site. |
| secure.php | the file that contains the HTML or PHP used to specify any settings when using the homepages designer. This file is optional. |
| secure.js | the file that contains the JavaScript used in secure.php. This file is optional. |