Gallery Templates

Each page within the gallery app has its own template to display that page's content.

Where to save template files

Template files will go in a folder that has the same name as the app instance key. For example, if the gallery app instance key is "gallery" then you would put all of your template files within the gallery folder inside the templates folder.

If your theme was called "Custom" then this would be an example folder structure:

  • themes
    • custom
      • theme.json
      • templates
        • home.twig
        • one-column.twig
        • two-column.twig
        • gallery
          • categories.twig
          • category.twig
          • home.twig
          • item.twig
          • items.twig
          • search.twig
          • search-results.twig
          • tag.twig
          • tags.twig

Gallery pages and their templates

Below is the list of gallery app pages and the name of the template file that you should create.

App home

The app home page often shows the gallery items, categories, or tags.

Template name: home.twig

Categories list

This page shows the list of categories.

Template name: categories.twig

Category detail

This page shows the detail information for an individual category. The items assigned to the category are often shown.

Template name: category.twig

Item detail

This page shows the full details for an individual gallery item.

Template name: item.twig

Item list

This page shows a paginated list of gallery items.

Template name: items.twig

Search

The search page can be used to show the form to search for items.

Template name: search.twig

Search results

The search results page can show the results of a gallery app search. It can show a paginated list of matching items.

Template name: search-results.twig

Tags list

This page shows the list of tags.

Template name: tags.twig

Tag detail

This page shows the detail information for an individual tag. The items assigned to the tag are often shown.

Template name: tag.twig