Gallery management


Infradox XS - all versions


Being edited

Last update

8 January 2016, category searches

18 July 2016, category searches in 27.3

Related articles

Set editor for galleries

Dynamic subdomains

Configuring restrictions on supplier files

Creating custom filters

Search filters and gallery access control

The gallery Features page


Galleries are an essential part of most photo library websites. The gallery system provides a way of grouping certain files together and presenting those as such to end users. Within the Infradox system, the word gallery is a more or less generic term. A gallery can be a photo story, a feature, a photographer's portfolio, an event, or simply a group of related files (sets).  Furthermore, you can set up gallery structures to provide categorized searches, to create full screen slide shows and so on.  

The gallery manager

To be able to use the Gallery manager, you must be signed in with an admin account with such permissions, and you must have enabled the Admin toolbar (in the Account dropdown menu). In the Admin toolbar, click Gallery Manager. 

Note that if you are viewing a gallery page on the client facing website, that gallery will be automatically selected when you open the gallery manager. If not, you can find a specific gallery by typing part of its name in the search bar on the top left. This function searches within the current "root level" (more underneath) only though. 

Finding a gallery 

In the panel on the left, click on the small arrow in front of a group name to expand it and to show the titles in that group. Clicking on the name instead will show the galleries and thumbnails in the panel on the right. Items are loaded 100 at a time. You can type (part of) a gallery name to find it if you have many galleries in a group. The list will show found titles. Click a name to locate it in the tree view. Version 26.4 or later: If the item is not already in the treeview, then you can autoamtically load additional items until the item that you are trying to locate appears. The suggestions list also shows an edit link. You can click this link to edit a gallery without having to load all the tree items (i.e. other galleries in the same group).

Set editor

Besides the gallery manager, you can also use the Set editor to create or change galleries on the client facing pages. This function is described in detail (with screen shots) in this article:  Set editor

Gallery structure

The galleries are structured as a tree. You can create an unlimited number of so called "root levels", and within each root level you can create groups. Each group can have any number of galleries. You can apply different settings to the root level and to its groups. Those settings will affect anything inside that level or group, so you have to make sure that you understand the consequences of any changes that you make. 

Before you can create a gallery, you'll have to create a root level (add root level link, top left of the Gallery manager window). It is best to create separate root levels for galleries that have a different meaning or that function in a different way. For instance, create a root level for subject galleries and create a separate root level for categories. The difference between categories and normal galleries is explained further down. 

Note that in many cases, a single root level and sometimes even a single group may suffice. As an example, photographer portfolios can be created in a separate group within one and the same root level that you use for your subject galleries, model shoots, photo stories and so on. All within a single root level.

Gallery root page

You can configure a page that will list all (or selected) groups and galleries.  The URL for this page is /galleries/{anyname}.html. Replace {anyname} with something you want to display in the URL. For instance /galleries/showcase.html or /galleries/overview.html. You can add this URL to your menu or anywhere you like. If you want to highlight one of your menu items when the page is loaded, then use the URL /galleries/{menuid}/{anyname}.html. Replace {menuid} with the id of the menu item that you want to highlight. E.g. /galleries/4/overview.html.

To configure how this page works, go to Site configuration, General settings and open the section Gallery pages. One of the configuration options allows you to display a so-called tree that lists all the top levels and groups on either the left or the right of the page. Clicking the top most item will display all so-called top levels including the number of groups in each level. The label of the top most item is the Page title that you enter in Site configuration as described above. You can choose to load a new page with the groups of a selected top level when a user clicks on a level title. Or you can display the groups "in-page". The latter means that the user stays on the same page and only the HTML that displays the groups will be replaced (in the same page without reloading).

There are currently two display styles for the groups that you can choose from. You can of course change the appearance of the group boxes by applying custom CSS. 

Including galleries and groups from selected top levels on the gallery root page

To include a root level on the gallery root page, open the Gallery manager and select the top level in the dropdown box on the top left. Then click the arrow button on the left of the root level's title (displayed in orange). Click on Edit level. Check the box Use for gallery root page and finally click the Save button at the bottom of the panel.

Setting up a top level for category searches

You can configure a top level to act as a page with categorized searches where each group represents a category and each gallery represents a subcategory. On the client facing pages, clicking on a group (i.c. a category) will display the subcategories, clicking on a gallery thumbnail (i.c. a subcategory) will execute a search (as opposed to loading a gallery page).

To configure a top level for categories, edit its properties with the Gallery manager (click on the icon left of the top level title, then click edit level) and change the top level root style dropdown box to Categories.

The top of the categories page can display an instruction, for instance the text "Click a category on the left to display its subcategories". You can enter your text in the description of the top level. This is the text that will show on the client facing categories page.

Now you can start adding gallery groups that will act as Categories. For example, you can add a group with the name Architecture. To add subcategories to this group, simple create a gallery and add just one thumbnail. E.g. add the galleries Buildings, Bridges, Interiors and so on. Galleries that you create inside a Categories toplevel will be automatically configured as Search only.

You'll have to enter a search query for each of the galleries (subcategories) that you create. If the user clicks on a subcategory, the search page will load. It will display the Category and the subcategory as the page title. The search query can use normal keywords (with Boolean operators and wildcards), but you can also add unique codes to your files to make the search results more precise. For example, you can use the code SCP for People and the code SCP1 for Couples, SCP2 for Children and so on. These codes are just examples, actual codes can be anything.

If your website uses XS version 26.3 or later, you can choose between default size and large size thumbnails for the categories page. Further styling is possible by adding your own custom CSS. Note that you can both have groups with default size and groups with large size thumbnails.

The URL for the category page is:

/categories/[toplevelid]/3/categories.html where [toplevelid] must be replaced with the id of the top level that you have created for this purpose.

You'll need to add this URL to the menu or wherever you want to make it available on your pages. You can of course create a rewrite rule if you want to change the above URL. More information can be found in the article about Custom URL rewrites

The category page displays the category names on the left of the page, and the subcategories for the selected category - with thumbnails - on the right.

Changes in XS version 27

In XS version 27, the category search URL's have changed. The query is no longer part of the URL that executes the search query. The web server software looks up the details by the category and subcategory names that are part of the URL.

For example:

The first part tells the software to retrieve data from the database for a subcategory (gallery) with name portraits and a parent (category or group) with the name people. The retrieved data has the search query to execute and - if any) the filters to apply to the search. The search query and filters are not part of the URL.

To apply filters to the category searches, specify filters in the gallery manager. You can add filters to the root/top level, to the categories/groups and to the subcategories/galleries - if the root level is set up for categories. The search filters are compound, i.e. all filters are applied top down. 

In the gallery manager, where you can enter filter codes, you can click help for an explanation about how to enter the filter codes. You can use both the standard filter codes (f0 to f7) and your own custom filter codes - starting with f10. 

Changes in XS version 27.3

In 27.3 or later you can configure a category root level to use "long url's". This will include the root level name in the URL's in addition to the group (category) and gallery (subcategory) name. As a result, you can have categories and subcategories with the same names but in different top levels. For example:
/images/politics/labour.html and 
Before 27.3 this would cause problems because the names had to be unique.

Display a gallery in additional groups / different contexts

With version 26 or later, you can attach a gallery to one or more additional gallery groups. You can use this function to display galleries in different contexts. The below example explains how this can be made to work on the client facing pages. We'll explain the steps you need to take for this example to work in detail further down in this article.

We have created a gallery root level with the name "Photographer series" and within this root level we have created groups for each photographer. Each group (i.e. photographer) is linked to the correct contributor. We have configured Datamatic to automatically create galleries within these photographer groups, when multiple files are uploaded with the same "series title". 

We have created a gallery root level with the name "Photo stories" and within this root level we have created several groups to organise our photo stories by subject matter. 

Linking galleries or groups to contributors

With version 26 or later, you can link galleries and/or groups to contributors. This function was added so that you can for instance display all of the contributor's galleries on his/her profile page. It can also be used to show e.g. all features of a contributor when viewing one of his/her features and so on.

As an example, create a top level and call it "Photographer galleries". Then create groups inside this top level for one or more photographers. Link the groups (i.c. photographers) to the correct contributors. Then create galleries in each of the photographer groups. You can now list all the photographer's galleries on his/her profile page. In this example, the root id that we have created for "Photographer galleries" is 881. You can now use the following widget in the profile template to automatically list the photographer's galleries:

<?xs contributor('galleries',{source:1,rootid:881,style:4,max:15,sort:0,widgetid:contributorgalleries,textoption:2}) ?>

For a detailed explanation and an example, please read this article: Setting up the contributor pages.

Testing the gallery layout settings 

In the Gallery manager, click on a group or gallery title in the tree panel on the left. The grey box at the top of the dialog will show the URL that will be used to access the final client facing page. Click the Test url link next to it to open the page in a new browser window (or tab).

Note that you can also change the parameters of the URL to test different layout settings without having to make changes to a gallery's settings. The last digit in the URL is the layout parameter, e.g. in, the number 0 is the layout parameter. However, certain layouts require specific files to have been generated.

  • Parameter value 1 is used to show a full screen slideshow, the required files must have been generated with the tools in the gallery manager.
  • Parameter value 2 is used for a blog style gallery layout, this layout also requires the files to have been generated with the Gallery manager or you won't be able to test it. 
  • Parameter value 3 is used to display the so-called Biography layout. This layout can be used without having to generate additional files first.
  • Parameter value 4 is used for Features. The features layout must have been configured first. More information about the latter option can be read in this article: Customising the feature page

Note that the described layout parameters apply to galleries, not gallery groups.

Cover photos on gallery pages

In XS version 26.3 or later, you can enable Cover photos for every single gallery, group or root level page. In the Gallery manager, tick the Enable cover photo checkbox and save the gallery, group or the toplevel that you are editing. When you next load the page (gallery, group or toplevel), the top of the page will show a grey area. This is a place holder for your banner photo. Hover over it to make the "change cover photo" area appear. Click on it to upload a cover photo.

Setting up galleries to search

You can configure a gallery to execute a search as opposed to displaying an actual gallery (also see above about using galleries for categories). To do this, click the gallery's title in the Gallery manager to open the properties. Add only one image to the gallery. In the properties panel, change the top most dropdown box to Search only. In the Query input box, enter a (Boolean) search query. Use + instead of spaces. For instance women+or+woman.

You may want to change the page title that is displayed as a result of a search query. You can do this as follows:


The above example will search for women or woman but it will display females as the title.

Important: If you are entering search queries for galleries that you are using as subcategories (read above), then don't use the technique described in this article.

Frequently asked questions

  • Can I make a gallery appear in another group without moving or copying the gallery?
    Edit the gallery that you want to add to an additional group. Above its title, click Also appears in... (a number behind this will indicate the number of additional groups it already appears in). In the dialog, enter (part of) the group name that you are looking for. In the list of matching groups, click the group to which you want to add the gallery.
  • Can I move or copy a gallery to a different group? 
    You can move a gallery to another group that exists in the same top level. In the panel on the left, click on the group in which the gallery exists. Click and hold the gallery thumbnail and drag it onto the name of the group where you want to move the gallery. Its name will be surrounded by an orange box when you hover over it. When you drop the thumbnail, a dialog will appear. You can either copy or move the gallery.
  • Can I move all galleries in a group at once to another group in the same or in a different top level?
    Click on the small arrow in front of the group name in the panel on the left. Then click Move galleries. In the dialog, first choose the top level in which the group that you want to move galleries to exists. This can be the same top level as the current one. Then select the destination group and click save. 
  • How do I remove all files from a gallery without deleting the gallery?
    Click the gallery thumbnail to display its contents. In the bar at the bottom click empty to remove all files from the gallery. Note that you remove single files by dragging a thumbnail onto the bin icon in the bottom toolbar.
  • How do I delete a gallery?
    Click on the gallery thumbnail. In the gallery properties panel on the left, you'll find a delete button at the bottom.
  • How do I change the index thumbnail of a gallery?
    Drag one of the thumbnails from the panel on the right onto the index thumbnail box when you are editing a gallery.
  • I want to rearrange the order of display, how do I do that?
    When you are editing a gallery, simply drag the thumbnails into the order that you want them to appear. 
  • How do I add files from my lightbox to a gallery?
    In the gallery manager you'll see a dropdown box on the left at the bottom. Click it and you'll see your lightbox names. Click on a name and the thumbnails will show in the panel at the bottom. You can click thumbnails in the bottom panel to add them to your gallery. You can add all files from your lightbox at once by clicking Add all files in the toolbar at the bottom. You can also add files from your batch this way. 
  • Can I search for files that I want to add to a gallery when the gallery manager is open?
    Select Search results in the dropdown box at the bottom. Then type a keyword in the input box next to it to search. The results will appear in the panel at the bottom. You can add files to your gallery as described above. 
    Note that you can also list files that were uploaded on a specific date. The dropdown box shows the last dates and the number of files that were added to the database. Click on a date to display the files from that date.



Have more questions? Submit a request


Article is closed for comments.
Powered by Zendesk