Fotogallery_XH – User Manual
Fotogallery_XH facilitates the presentation of image galleries on a CMSimple_XH website. Contrary to most other existing gallery plugins, the galleries are created completely automatically from existing images in a given folder, so that the galleries don't have to be prepared in the back-end. That makes Foldergallery_XH especially suited for large amounts of images, and also for use with Extedit_XH.
Important Notice
Foldergallery_XH couldn't be tested so far in various environments. It is a so called beta version. Use with caution!
Requirements
Foldergallery_XH is a plugin for CMSimple_XH ≥ 1.6.3. It requires PHP ≥ 5.4.0 with the Fileinfo, GD, JSON and optionally Exif extensions.
Installation
The installation is done as with many other CMSimple_XH plugins. See the CMSimple_XH wiki for further details.
- Backup the data on your server.
- Unzip the distribution on your computer.
- Upload the whole directory fotogallery/ to your server into CMSimple_XH's plugins directory.
- Set write permissions for the subdirectories cache/, config/, css/ and languages/.
- Go to Plugins→Foldergallery in the back-end to check if all requirements are fulfilled.
Settings
The plugin's configuration is done as with many other CMSimple_XH plugins in the website's back-end. Select Plugins→Foldergallery.
You can change the default settings of Foldergallery_XH under Config. Hints for the options will be displayed when hovering over the help icon with your mouse.
Localization is done under Language. You can translate the character strings to your own language if there is no appropriate language file available, or customize them according to your needs.
The look of Foldergallery_XH can be customized under Stylesheet.
Usage
Prepare the galleries by uploading images into CMSimple_XH's image folder, or a subfolder thereof, either via FTP or a filebrowser. The image captions shown by Foldergallery_XH are retrieved from the filename or, if available, the Exif ImageDescription tag stored in the image file.
To present all images in the image folder on a page, insert the following plugin call:
{{{foldergallery}}}
To present only the images of a subfolder (and all subfolders of that
folder), use somethink like the following (replace
SUBFOLDERNAME with the actual name of the subfolder):
{{{foldergallery 'SUBFOLDERNAME'}}}
Limitations
Currently, only a single gallery can be shown on each page.
While Foldergallery_XH is supposed to work with all image formats suitable for the Web, only JPEG images support thumbnails and Exif metadata captions.
License
Fotogallery_XH is licensed under GPLv3.
© 2017 Christoph M. Becker
Credits
This plugin is inspired by the Fast Gallery Drupal module.
Fotogallery_XH uses Colorbox by Jack Moore. Thanks for releasing this great Lightbox clone under MIT license.
The plugin logo is designed by Everaldo Coelho. Many thanks for publishing this icon under GPL.
The folder icon has been taken from Wikimedia Commons. Many thanks for making this icon available under CC BY-SA 2.5.
Many thanks to the community at the CMSimple_XH forum for tips, suggestions and testing. Particularly, I like to thank frase and lck for testing and feedback on an early development preview.
And last but not least many thanks to Peter Harteg, the father of CMSimple, and all developers of CMSimple_XH without whom this amazing CMS wouldn't exist.