Version 2.7 is a legacy release, and these documents are no longer being maintained.

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 theme homepage

Dominion Canada theme homepage

Archives Canada theme homepage

Archives Canada theme homepage

To change the theme:

  1. Click on the gears Admin menu in the main menu located in the header bar and select Themes.
List themes page
  1. Click on the radio button in the “Enabled” column for the theme you wish to have enabled and click “Save.”

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:

  1. Click on the gears Admin menu in the main menu located in the header bar and select Settings.
  2. 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.
Settings for default page elements.

Change site title, description, and base URL

To change the site title, site description, and/or site base URL:

  1. Click on the gears Admin menu in the main menu located in the header bar and select Settings.
  2. 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.
Settings for site information

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 instution logo, banner and changing the background colour. For instructions, see Archival institutions- Edit theme

Back to the top