Defining Image Collections

The images to be displayed in FSI Pages have to be defined in an <images> node added to your XML configuration file.

There are two different ways of defining image lists:

Method 1: Retrieving automatically generated image lists from FSI Server​

The most convenient way to create image collections is using the template system of FSI Server. You can do so by using the "Publish to Web" option in FSI Server web interface.

<Pages>
<ListTemplate value="catalog_list" />
<dir value="images/catalogs/foo" />
</Pages>

This way FSI Server uses the specified ListTemplate to return the matching images in XML format. Depending on the list template, FSI Server serves IPTC data belonging to an image (e.g. for links) as well. (catalog_list is the default ListTemplate)

Method 2: Creating collections manually using XML configuration files​

<Images>
...
<Image file="image1.xml"
label="My First Image" />
<Image file="image2.xml"
label="My Second Image" />
...
</Images>

Method 1 retrieves a complete image list ignoring previously defined <images> nodes.

Image Order​

The order of the images (this is the page order) corresponds to the order of the <image> declarations within the <images> section.

Inserting Blank Pages​

You can insert blank pages by adding <image empty="true" /> nodes anywhere in your image collection. Alternatively you can use the FSI Pages parameter to pass the page numbers to insert blank pages before seperated by commas. This is especially useful if you retrieve the image collection from FSI Server (Method 1).

Removing certain Images from a List​

Using the parameter removePages you can disable (remove) certain images from an image list. In this case you pass the page number(s) of the pages you want to remove separated by commas.