- 21 Jun 2022
- 4 Minutes to read
- Updated on 21 Jun 2022
- 4 Minutes to read
Whether you are using a customised theme or the in-built theme within Totara, you can configure a range of theme settings affecting display and navigation. To configure these settings, go to Quick-access menu > Appearance > Themes > Theme settings.
This lists the themes available for selection as a course or user theme. Leave this field blank to allow any installed theme to be selected. If you wish to shorten the display of the theme menu, you can enter a comma-separated list of theme names (without spaces).
You can preview the available themes in Quick-access menu > Appearance > Themes > Theme selector.
Theme designer mode
Normally all theme images and style sheets are cached in browsers and on the server for a very long time, for performance reasons. If you are designing themes or developing code then you probably want to turn this mode on so that you are not served cached versions.
This will make your site slower for all users. Alternatively, you can also reset the theme caches manually from the theme selection page.
Allow user themes
If enabled, each user may select their preferred theme when editing their profile. All Totara pages will be displayed in the user's selected theme, apart from courses where a course theme has been set and forced.
User themes allow learners a degree of personalisation and control over their learning environment and for them to set a theme which best suits their visual display/accessibility requirements.
User themes will not be optimised for mobile or tablet devices unless the Enable device detection setting is disabled (unchecked).
Allow course themes
If you enable this option then Trainers will be able to set their own course themes in Totara Learn. Course themes override all other theme choices (site, user, or session themes).
Each Editing Trainer may select their course theme via the Force theme option on the course settings page. The course will always be displayed in the theme specified in the course setting, with user and site themes being overridden.
Course themes can be used to visually distinguish course types (such as online, classroom-based or blended), subject areas or priority (Mandatory, Essential, Recommended, Optional, etc.).
Course themes will not be mobile or tablet device optimised unless the option Enable device detection is disabled (unchecked).
Allow category themes
If you enable this option then themes can be set at the category level, with all child categories and courses inheriting this theme (unless they have been specifically set their own theme).
Category themes can be used to visually distinguish subject areas or training providers.
Enabling category themes may affect performance, as it will result in a few extra database queries on each page, so only turn this on if you need it.
The category theme will not be available on mobile and tablet devices unless the Enable device detection setting is disabled (unchecked).
Allow theme changes in the URL
If enabled, the theme can be changed by adding either of the following:
You can turn this on to aid in troubleshooting problems that may be related to the theme. This will allow you to switch to a standard or different theme for your own session without affecting other users or the site theme.
Allow users to hide blocks
Allow blocks to use the docks
If enabled and supported by the selected theme, users can choose to move blocks to the side dock.
User menu items
You can configure the contents of the logged-in user menu (with the exception of the logout link, which is automatically added).
Each line is separated by | characters and consists of:
Dividers can be used by adding a line of one or more # characters where desired. The default user menu is:
Enable device detection
Enables detection of individuals using mobiles, smartphones, tablets or default devices (desktop PCs, laptops, etc.) to access Totara. This determines the application of themes and other features.
Device detection regular expressions
By default, Totara can detect devices of the following types:
The theme selector can be used to apply separate themes to all of these. This setting allows regular expressions that allow the detection of extra device types (these take precedence over the default types).
For example, you could enter the regular expression '/(MIDP-1.0|Maemo|Windows CE)/' to detect some commonly used feature phones add the return value 'featurephone'. This adds 'featurephone' on the theme selector, which would allow you to add a theme that would be used on these devices. Other phones would still use the theme selected for the mobile device type.
The Totara Academy has a whole course dedicated to using Dashboards and basic theming in Totara. Here you can learn more on how to customise your site's appearance, see best practice, and give it a go yourself.
© Copyright 2022 Totara Learning Solutions. All rights reserved.