Themes and theming¶
This section describes how to change the theme, site title, site description, and site base URL in your AtoM application.
Note
Customizations beyond what can be achieved in the user interface are covered in the Administrator manual under Theming.
Important
Bootstrap 2 themes have been deprecated and will be removed in a future release. Please consider switching to a Bootstrap 5 theme.
Change theme¶
AtoM 2.7 and up ships with 3 themes: the default Dominion theme (arDominionB5Plugin) and the Archives Canada theme (arArchivesCanadaPlugin).
The Dominion themes are grey, white and black with the AtoM logo. The Archives Canada theme is yellow, blue and white with the ArchivesCanada logo (see images below).
The default version of the Dominion theme is based on Bootstrap 5 (“BS5”), a framework for developing websites. BS5 provides a number of improvements over the previous version (“BS2”) such as better security, responsiveness and accessibility.
If you’re a brand new AtoM user, please use the default BS5 theme. If you are performing an upgrade from an older version, and you have a custom theme, we recommend upgrading that theme to use BS5.
Dominion Canada theme homepage
Archives Canada theme homepage
To change the theme:
- Click on the
Admin menu in the main
menu located in the header bar and select Themes.
- Click on the radio button in the “Enabled” column for the theme you wish to have enabled and click “Save.”
See also
Add or remove elements¶
To add or remove the site title, site description, site logo, or language menu from the AtoM header bar, or to hide the digital object carousel that appears when there are multiple digital objects attached to lower-level descriptions:
- Click on the Admin menu in the main
menu located in the header bar and select Settings.
- Click on or scroll down to Default page elements. Check or uncheck the boxes beside the elements you would like to add or remove and click Save.
Change site title, description, and base URL¶
To change the site title, site description, and/or site base URL:
- Click on the Admin menu in the main
menu located in the header bar and select Settings.
- Click on or scroll down to Site information. Update the text in Site title, Site description, and Site base URL as desired, and click Save.
Edit theme for an archival institution¶
In multi-repository systems institutions can change the appearance of individual institution pages and results pages by uploading an institution logo, banner and changing the background colour. For instructions, see Archival institutions- Edit theme