Using Themes

Downloading and organizing

Using a Galleria theme is very easy, and can be done in several ways. We recommend you to put all your themes in one directory called themes, close to your galleria source. When downloading / purchasing new themes, just add them to your existing themes directory for easy access. Here is an example of how your structure could look like:

/index.html
/galleria
    /galleria.1.3.6.min.js
    /themes
        /classic
            /galleria.classic.js
            /galleria.classic.css
        /twelve
            /galleria.twelve.js
            /galleria.twelve.css

Please note that there are no restrictions placed on where and how you organize your files, this is just an example to simplify the documentation.

Loading a theme

There are two ways of loading a theme in your document:

1. Using Galleria.loadTheme

This is probably the easiest way to load a theme. The theme path should be relative to the url you are loading the theme from, so assuming the previously defined structure, we would use the following JavaScript command to load the classic theme from the index.html file:

Galleria.loadTheme('galleria/themes/classic/galleria.classic.js');

This command loads all theme specific files and holds the gallery initialization until all files are loaded and ready. So now we just have to fire upp Galleria:

Galleria.run('.galleria');

2. Loading a theme manually using <script>

Another option for loading the theme is to manually add a script tag that points to the theme, f.ex:

<script src="galleria/themes/galleria.classic.js"></script>

You can put this script anywhere in your document, before initializing Galleria. To speed things up and gain more control, you can also load the CSS file associated with the theme:

<link rel="stylesheet" href="galleria/themes/galleria.classic.css">

However, this is not necessary as the script will automatically load the CSS for you.

Multiple themes

Since 1.4, Galleria also supports multiple themes. To load multiple themes, use the same loadTheme syntax or script tags as described above, f.ex:

Galleria.loadTheme('galleria/themes/classic/galleria.classic.js');
Galleria.loadTheme('galleria/themes/twelve/galleria.twelve.js');

Then specify the theme name as an option when intializing:

Galleria.run('.galleria.twelve', { theme: 'twelve' });
Galleria.run('.galleria.classic', { theme: 'classic' });