There may be situations where you may need a customized view for a particular dashboard and need to maintain different custom themes per dashboard. In such situations you can create your own custom theme and apply it for a particular dashboard. However, if you do not require a custom theme for your dashboard you can simply use the default theme that is provided.
Follow the instructions below to create a custom theme per dashboard:
Create a custom theme file.
Create a custom theme file as a Carbon archive file, which has the .car extension. The artifact type of the theme file should bedashboards/theme
.
For example, theartifact.xml
file for a custom theme is as follows:Code Block <artifact name="custom-theme-sample" version="1.0.0" type="dashboards/theme" serverRole="DashboardServer"> <file>custom-theme-sample</file> </artifact>
The folder structure for the custom theme file is as follows:
Code Block css js ----- ues.js ues-prefs.js ues-gadgets.js ues-dashboards.js gadget-properties.js gadget-handlebar-helpers.js dashboard.js ds-ajax-api.js templates --- includes ---- portal-header.jag portal-footer.jag control-panel.jag light-dark-switcher.jag project-title.jag
Thecss
folder can contain any stylesheets with the.css
extension. However, thejs
andtemplate
folders should contain the files defined in the above structure.Deploy the custom theme.
Sign into the WSO2 Data Analytics Server (WSO2 DAS) Management Console.
https://<hostname>:9443/carbon
- Click Main, navigate to Carbon Application and click Add.
- Choose the Carbon Application Artifact (
.car
) file and upload it.
Info |
---|
You can use one of the following methods to apply your custom theme to a specific dashboard.
|
After creating a custom dashboard theme and applying the theme, you can preview the final view of the dashboard using the dashboard view option.