Theme Selection

The Theme section of the Site menu allows you to select the theme for your site, and to set theme-specific settings.

Install a theme

In order to appear on the Themes page for sites, themes must be manually added to the /themes folder of the installation, using an FTP program or an SSH connection.

To add a theme to the site using FTP:

  1. Download the zipped theme to your computer.
  2. Open your FTP client, log on to the server that houses the Omeka S install and navigate to the /themes folder (this should be located in the main folder of the install).
  3. Upload the zipped theme to the /themes folder .
  4. Unzip the theme.

You can also use git to clone a theme directly from the git repository. Do this only if you are comfortable with git.

Select a theme

When you navigate to the Theme screen, the currently active theme will appear on the top of the page. If you did not select a theme when adding the site, this will be the Default theme.

A large image of the active theme appears on the left, with the theme title, version, creator, and a button to "Edit theme settings" on the right.

Theme tab with Center Row as the current theme

Below the current theme are tiles for all other installed themes. The tiles have a small image of the theme in action, the theme name and version, and a link to the creator of the theme.

To switch themes, click on the theme which you want to use. It will highlight slightly in gray, with a checkbox in the lower right-hand corner of the theme tile.

A selected theme showing the highlight and checkmark

Click the "Save" button in the upper right-hand corner of the window to save changes. Click the "Cancel" button to leave without saving your changes.

Theme settings

Theme settings allow you to customize aspects of the site's theme, such as adding a logo to the top or writing footer text.

To edit the settings of your selected theme, click on the button labeled "Edit theme settings" to the right of the current theme thumbnail.

Note that your settings for a specific theme on a site will be saved when you change themes. For example, if you customized the footer for the default theme, then switched to using The Daily for a while, then switched back to the default theme, your custom footer would still be there.

Settings options

Depending on which theme you have selected, you may see any of the following setting options:

(All themes)

Upload a asset (file) to function as a logo in the header of your site. Allowed file types are: jpg, gif, png, svg, and svgz.

This asset is not associated with any of the items, and will be stored separately; once uploaded to a site you will be able to select it again without re-uploading even if you change themes for a while. Any asset uploaded to one site will be available for all sites on the installation.

Logo option

To upload a logo, click the "Select" button. This will open a sidebar where you can either upload a new file from your computer or choose from assets already uploaded to the installation.

Logo option with sidebar open

Note that the logo completely replaces the header, including the site title, for the site, so you may want to consider an image with text if it is important to you that users see the site title.

To remove a logo, click the "Clear" button in that block (only visible when a logo is active) and save changes.

(All themes)

A text field in which you can enter content to appear in the footer of the site.

footer text field with prompt visible

By default the message is "Powered by Omeka S."

You can add HTML formatting to the text by manually adding the tags.

Top Navigation Depth

(Default, Cozy, Foundation)

Top Navigation Depth allows you the limit the depth of the top navigation menu on the public side of the site. The default setting, 0, does not restrict the number of levels of the top navigation menu. Setting it to one would only show the top-level pages or links of your site.

Theme settings with Top Navigation depth at 0

Color Selection

(Default, Cozy, The Daily)

The themes Default, Cozy, and The Daily include an option to enter values for the main accent color; Cozy also has an option for the navigation background color.

color option fields

The Main Accent color is used for link text and on-hover colors, as in the image below:

arrow points to instances of main accent color in use

The navigation background color sets the color of the navigation sidebar for the theme.

arrow points to sidebar

Edit either field by typing a color value into the field. Either a triplet or a six-character hexadecimal code will work. Once you have entered a valid value, the color bar on the left will automatically update to show the color entered, even without saving changes.

The default values are stored in the prompt text for the field. For the Cozy theme, the default values are: the main accent color is 087b94 and the navigation background color is bfdcdc.

Layout for browse pages

(Center Row, Foundation)

Select how to display items within their browse views.

  • Grid: Items are organized into rows and columns. This is recommended for items that prominently feature images.
  • List: Items are stacked into a single column.
  • Toggle (default: grid): Site visitors can choose to display the browse views as grids or lists, with grids as the default.
  • Toggle (default: list): Site visitors can choose to display the browse views as grids or lists, with lists as the default.

Foundation theme settings

Foundation is a theme that comes with a few default stylesheets for fast prototyping or getting started with modifying themes. As a result, it has some unique settings. For more information on using Foundation, including working with Sass, see the theme ReadMe file.

Settings not described above:

  • Stylesheet: The theme provides 4 style options.
    • Default uses ZURB Foundation's default styles for prototyping, which are all viewable in their documentation under the Kitchen Sink.
    • Revolution aims to capture the feel of old documents and juxtaposes it with a bright red accent. It includes a textured paper background image.
    • Sea Foam offers a clean, friendly look with a teal palette.
    • Inkwell features a high contrast serif family for its typography, as well as sunny yellow accents.
  • Navigation layouts: Global navigation can display as a horizontal top bar with optional dropdown menus or a left vertical column.
  • Show Top Navigation Child Pages: Toggle display of child pages within the main navigation. If unchecked, only the top-level navigation will display.
  • Layout for Show Pages: Resource metadata can show display as stacked with properties as headings above their values, or inline with properties as headings inline with their values.
  • Truncate Body Property: Set how much of the browse body property displays on the browse page. You can:
    • Show full value which displays all of the property text.
    • Show 4 lines and fade out which displays 4 lines of text with a fade at the end of the text block.
    • Show 4 lines and ellipsis which displays 4 lines of text concluding with an ellipsis (...).