Themes¶
Themes control the look and feel of the entire GUI interface. This contains all aspects of the presentation including the images, logos, colors, fonts, sizing and positioning. Login and interface header text can also be managed by the VOSS-4-UC theme feature.
Themes can also be managed using the ‘Themes Interface’ in the Business Admin Portal. See “Create a Theme in the Business Admin Portal” in the Business Admin Portal Guide for more details.
New themes can be added and existing themes can be edited. These are associated with a user’s role. There is no limit to the number of themes that can be added and applied. It is a common practice to have a theme associated with a specific customer (company).
The default theme that applies to the GUI when the system is initially built, is available on the VOSS-4-UC system and can be used as the baseline template. The theme is in the form of a Cascading Style Sheet (CSS) to be exported, edited and re-imported as required.
While all aspects of the exported CSS can be modified, we recommend that the default theme is used as a template in terms of basic design in order to prevent usability or functional issues.
The CSS file itself is simple to export and edit. Clear headers in the CSS file indicate which area of the GUI the design applies to. The headers include the following components:
- Navbar
- Shortcut menu
- Hierarchy breadcrumbs
- Quick search
- Tree menu
- Toolbar
- List
- Form
Images can be stored with the theme or referenced with the use of relative path names.
The ability to view themes created at a given hierarchy level can be restricted from users at a lower hierarchy level by use of the Hide from Lower Hierarchies check box. If this check box is checked for a particular theme, that theme will no longer be visible on the Themes list view screen at the lower level hierarchy.
The theme feature is applied to either the Administration or Self-Service interface. If no Interface is specified, the new login theme will also have its interface set to Administration.
It also includes a Use this Theme to style Login page check box, which when selected, applies the chosen look and feel to the Login page across the system. Currently, the system allows only a single theme to be applied to the Login page per Interface. This means that a new or updated theme with Interface and Login page setting that corresponds to an existing theme, will result in the disabling of the Login page style on an existing theme with the same Interface setting.
The Login page theme can also be applied to the Login page during the log in process by adding a suffix to the login request URL. See Set the Login Page Theme.
