A new feature of Exago v2016.3 is the ability to add Application Themes. An Application Theme is a set of custom styles and images which change the overall look and feel of the application. Admins can Create and Customize their own theme with relative ease.
App themes are set on a per-application basis in the Admin Console or config file. However, when entering through the API, an admin can check the incoming identity parameters and switch the theme dynamically. In the example below, the Application Theme is switched by the value of the @CompanyId@ system parameter.
case "AMA Electronics and Shipping":
myApi.SetupData.General.CssTheme = "AMA Theme";
case "GLA Analytics":
myApi.SetupData.General.CssTheme = "GLA Theme";
myApi.SetupData.General.CssTheme = "Basic";
There are two ways to create a custom Exago Application Theme:
- Automatically with the Application Theme Maker, available for download on the Downloads page
- Manually, following the procedure below
Customizing an Application Theme is as quick and simple as editing CSS and replacing image files. To create a customized theme:
This article references
<WebApp>\as a placeholder for the Web Application's install location.
- Duplicate the
- Rename the duplicated directory to the name of the new custom theme.
- Edit the CSS, Fonts and Images directories accordingly to layout the theme.
- See Getting Started with Application Themes for more information.
The CSS folder contains the stylesheets for every area of the application. See Styling for a list of some commonly customized elements.
The Images folder contains the application icons in png and svg (sub-folder) formats. (See SVG Icons for details on the SVG format). To replace images, simply overwrite the image files.
The Fonts folder is optional. This allows you to add custom fonts that may not be present on your users' local machines.
Please note that the "Basic" built-in theme will be overwritten upon upgrading Exago to a new version. Therefore if you plan to style Exago, we recommend creating a new theme folder so that any changes are not lost.