Enable your custom widgets to include the Common Options tab, ensuring consistency in widget configuration. The Common Options tab allows you to control the devices on which your widget displays, set alignment and print parameters, and add additional style classes.
Step-by-step guide
1. Log into CMS
2. Navigate to Advanced Content → Custom Widgets
3. Click Edit next to a widget that is in use (depicted by Used n time indicator in the In Use? column).
4. If we look at the DashboardBackOrders custom widget, then we see that the Include Common Options parameter is OFF.
5. You can check where that widget is used by clicking Options → Where is it used?
6. Click the Template directly from the Where is this widget used? pop-up, or navigate to the page location: Content → Pages & Templates → Accounts → Dashboard Page
7. Find the widget in the Page Template and click Edit
8. You can see that there are only two tabs: General Options and Personalisation.
9. View the HTML code (Chrome: Inspect; Firefox: Inspect Element). Take note of the lines between the highlighted line:<div class="content-box dashboard-module dashboard-back-orders"...> and the <header class="box-title"... "Back Orders" </header>.
10. Exit out of the widget and head back to the DashboardBackOrders custom widget by clicking Options and selecting <>View Source Code or navigating to Advanced Content → Custom Widgets.
11. Click Edit on the DashboardBackOrders widget, and this time, toggle Include 'Common Options' to ON.
12. Save your changes and head back to Content → Pages & Templates → Accounts → Dashboard Page.
13. Edit the DashboardBackOrders widget and click on the Common Options tab.
14. You will see all the options available on the Common Options tab that is available on all non-Custom widgets.
15. View the HTML code (Chrome: Inspect; Firefox: Inspect Element).
Note the addition of the '<div>' tag for the Dashboard Back Order Custom Widget surrounding the <div class="content-box dashboard-module dashboard-back-orders"...> and the <header class="box-title"... "Back Orders" </header> highlighted in the pre-enabled view (step 9).
16. Just for fun, edit the CUSTOM:DashboardBackOrders widget again and toggle Show On Mobile? to OFF.
17. Save your changes and notice the difference to the widget.
You can read more about the device icon display in the Widget Device Display Indication: Mobile, Tablet, and Desktop knowledge base article.
Additional Information
Contact CV Support if you have any questions or issues enabling this option.
| Minimum Version Requirements | 4.15.00 |
|---|---|
| Prerequisites | -- |
| Self Configurable | Yes |
| Business Function | Behaviour & Personalisation |
| BPD Only? | Yes |
| B2B/B2C/Both | Both |
| Ballpark Hours From CV (if opting for CV to complete self config component) | Contact CV Support |
| Ballpark Hours From CV (in addition to any self config required) | Contact CV Support |
| Third Party Costs | n/a or Fees apply |
| CMS Category | Custom Widgets |
Related articles
