Pages source - Images
This pages source provides ability to define selection parameters which will be used to get image files from the selected folder(s) and each selected image will be a separate page in the publication. It is possible to define the following parameters for this pages source:
- Description file is a name of CSV file which will locate in folder with images (each folder uses own file). This file can contain additional fields which can be used in template when "Choose template type" parameter is set to "Content". The sample CSV file with additional "Title" and "Link" fields is here. OpenOffice application can be used to edit CSV files.
- Directories allows to specify directories with images. Use relative paths and enter path to each folder on a new line. For example if images are located in <joomla_directory>/images/publications/pub1/ folder, use images/publications/pub1 value.
- Files filter allows to specify a RegExp for matching necessary file names. Only files which file names match the RegExp will be selected. Don't change default value of the parameter if you don't know syntax of regular expressions.
- Sort by is used to specify how to sort the selected files. It is possible to use the following values:
- None - the files will not be sorted.
- File name - the files will be sorted by file name.
- Last modified data - the files will be sorted by last modified date.
- CSV - files order will be the same as in description CSV file. See "Description file" parameter.
- Sort direction allows to select sorting direction.
- Scan subfolders is used to specify should the extension selects images from sub-folders of folders from "Directories" parameter or not.
- Choose template type
- image is used if want to show only images as pages
- content is used if want to use fields from description file (see "Description file" parameter). It is possible to define page template in "Template" parameter. {$bookimage}predefine variable contains an image. It is also possible to use values for fields from CSV file. For example if CSV file contains "Description" and "Link" fields, it can be used in template like {$Description} and {$Link}
Thumbnails settings
This section is used to specify where pages thumbnails are located. The thumbnails are used by the slider with pages preview. The section contains the following parameters:
- Use thumbnails allows to indicate use thumbnails for the publications or not.
- Create thumbnails if the parameter is set to "Yes", the extension will generate thumbnails automatically. Use "Thumbnail width" and "Thumbnail height" parameters to define thumbnails width and height. If one of the parameter is empty or have 0 value, it will be calculated automatically to save ratio.
- Thumbnails path is used to indicate path to thumbnails. It is possible to use the following predefined variables:
- {$fileName} will be replaced with file name of original image
- {$baseFileName} will be replaced with file name of original image with file extension (for example for image01.jpg image, the variable will have image01 value)
For example if thumbnails are located in "thumbs" sub-folder of folder with images and have the same names as original images, set the parameter to thumbs/{$fileName} value.