You are here: Home > Gallery Collection > Image Album


Image Album

Image Album is a part of CMSimple Gallery Collection plugins family. It shows a gallery of images located in a userdefined gallery folder. Please visit pages:

for description of Image Album properties common to the entire series.

Label: Citröen

CMSimple plugin: Gallery Collection Image Album
© simpleSolutions

Specific Image Album options
  • pagination with user defined number of images per page and user-defined position of navigation bar (over / under the album, or both)
  • jQuery UI effects onload, onmouseover and onmouseout
  • more then one albums on the same page (pagination must be turned off)
  • Selectable table or floating css formating of albums.
  • integration with CMSimple Mobile plugin. Image Album images are resized to fit the display of mobile devices.
    • On mobile devices all Image Album classes are appended “_mobile” to class name (requires CMSimple Mobile plugin), ie the default class "imgalbum" is renamed to "imgalbum_mobile". This option allows you to customize a different appearance of Image Album on mobile devices.

The effects shown on this page are only a little part of what is possible. You can choose many effects from jQuery UI collection or none.

Table of Content

  1. License support and purchase
  2. Installation
  3. Configuration
  4. Compatibility
  5. History
  6. Known problems
  7. Future development
  8. Acknowledgement
  9. Disclaimer

1. License support and purchase

#license# #rl_license#
Remove Link License:





2. Installation

Image Album requires PHP 5.x (preferably PHP 7.x) CMSimple_XH version 1.7 and higher.

Download and uncompres the file imgAlbum_XH.zip
Upload the entire imgalbum directory to  your "plugins" directory.

To create and view a gallery folder enter 

{ {{imgalbum( "path_to_gallery_folder );}}} (without space between "{ {{")

somewhere on your page. 

Save your page and finish editing by switching to "view mode" and plugin will create all necessary folders. Use plugins administrations interface or ftp to upload images. The plugin creates itself necessary thumbnails and watermarks according to settings in plugin configuration file.

Image Album css classes

Image Album creates a default class imgalbum as plugin container You can override the default class by passing a second parameter to plugin call:

{ {{imgalbum( "path_to_gallery_folder", 'userclass_name' );}}}

In this case you have to define your own class(-es) in stylesheet.css file. 

 If CMSimple Mobile plugin is installed and a mobile device is detected.then Image Album append "_mobile" to any class, ie the default class is named imgalbum_mobile and a user defined class is named userclass_name_mobile.

Redefining configuration

NB! Configuration can't be changed in CMSimple XH ver. 1.7 and higher. If you need this option you have to modify the source code.

Plugin configuration can be redefined by call to a function imgalbum_config(configuration_string, value) before a call to the plugin e.g.:

{ {{imgalbum_config( 'thumb_sort_order', alpharandom');}}}
{ {{imgalbum_config( 'thumb_effect_onload', 'effect( "highlight", {color: "#444444"}, 2000 )');}}}
{ {{imgalbum("path_to_gallery_folder"); }}}

 An empty effect string desactivates an effect defined in plugin configuration e.g:

{ {{PLUGIN: imgalbum_config( 'thumb_effect_onload', '');}}} 

3. Configuration and Administration interface

Please read online help supplied with configuration and administration interface. Jump to "Common Administration Interface" to read more about thumbnail, waternmariks and image editing.

4. Compatibility

Required PHP 5 with enabled GD Graphic Library. CMSimple_XH version 1.6 and above. Image Album will probably run correctly with earlier versions of CMSimple_XH and CMSimple with installed plugin jquery.

5. History

version 1.4.0

  • php 7 ready
  • rewrited to CMSimple XH version 1.7
  • bug fixes

version 1.3.0

  • added integration with CMSimple Mobile plugin. Images are resized by CMSimple Mobileto match mobile scree size. On mobile devices, with installed simplesolutions plugin cmsimplemobile, the class parameter (both the defualt (ie imgalbum) and passed to the imgalbum function) is appended the suffix "_mobile".
  • New lightbox Image Lightbox is used as default on mobile devices
  • Added config variable to show or not show description with thumbs, If extrainfo_under_thumbs = false then description is only visble in lightbox

version 1.2.1

  • compatibility with CMSimple_XH ver 1.7

6. Known Problems

To avoid conflicts with some other plugins using jQuery UI, it is recommended to change the configuration of the jQuery plugin to autoload of both jQuery and jQueryUI.

Watermarks: text watermarks does not support utf-8. Watermarks from images are not visible.

7. Future development

8. Acknowledgement

Ajax Image Editor is written by Peter Frueh
Thumbnail and Watermark Class is written by Emilio Rodriguez (crop functionality by simpleSolutions)
Lightbox is written by Lokesh Dhakar
prettyPhoto is written by No-margin-for-errors
pagination class is written by Majid Ramzani  
german translation by b&s creations

9. Disclaimer

This CMSimple plugin is distributed in the hope that it will be useful - without any warranty; without even the implied warranty of fitnes for a particualr purpose.

 Below: a second Image Album on the same page.

Beautiful landscape
Langeland, Denmark
Big image size 1,8 GB
Title with dk letters: æøå
First line UTF-8 test: ÆØÅ
Label: Watermark:red text
Koldinghus, Denmark
Internal link
Harbor, Skiathos Greece
Not cropped thumb
Allinge Jazz Festival
External link to Allinge Jazz website
No tooltip (title) just one text line
Big Image size 1,3 GB

CMSimple plugin: Gallery Collection Image Album
© simpleSolutions

© simpleSolutions, 2012-2018.

This page is powered by
CMSimple plugin: Tooltip and Modalbox © simpleSolutions



All plugins on this site are validated according to CMSimple_XH standard 





Newsbox Rotator demo


Hold the cursor over Newsbox Rotator area to pause rotation.Move the mouse outside area to continue rotation.

In CMSimple XH not published news are not visible in News Rotator. 



Newsbox Rotator demo

Newsbox Rotator Test 1

Newsbox_1 test test test


test1 test2 test3 test4 test5 test6 test7 test8 test9 

Newsbox Rotator demo

CMSimple plugin: Newsbox Rotator
© simpleSolutions
dow Meeting weekly event

Last update:

Powered by CMSimple | Template by simpleSolutions

(X)html | css | Login