/**************************************************
  Coppermine 1.5.x Plugin - collageplus
  *************************************************
  Copyright (c) 2013 Mykee (www.acegem.hu)
  *************************************************
  This plugin based on CollagePlus gallery script.
  More parameters, license visit developer's website: http://collageplus.edlea.com/
  ************************************************
  This Coppermine plugin include next jQuery addons too, for license and plus settings, please visit these websites:
  - TipTip - Copyright (c) 2010 Drew Wilson - http://code.drewwilson.com/entry/tiptip-jquery-plugin
  - LightBox 0.5 (modded by Mykee to 0.51) - Copyright (c) 2007 Leandro Vieira Pinho - http://leandrovieira.com/projects/jquery/lightbox/
  ************************************************
  $HeadURL: https://coppermine.svn.sourceforge.net/svnroot/coppermine/branches/cpg1.5.x/plugins/collageplus/readme.txt $
  $Revision: 6994 $
  $LastChangedBy: mykee $
  $Date: 2013-09-03 21:05:10 +0100 (Tue, 03 Sep 2013) $
  **************************************************/


What it does:
-------------
Displays a JavaScript collageplus on album list page with Lightbox and Adipoli effects.
This plugin has been created for cpg1.5.x.

=========================================================================

How to install:
---------------
* Unzip
* Upload folder 'collageplus' into Coppermine's plugins folder
* Go to plugin manager page and install it

How to enable:
--------------
* To enable this plugin, you'll have to add "collageplus" to "the content of the main page" in coppermine's config in the section "Album list view". The setting should look like "breadcrumb/catlist/alblist/collageplus" or similar. For details, review the documentation that comes with coppermine (inside the docs folder) in the section "The gallery configuration page" > "Album list view" > "The content of the main page".

=========================================================================

Plugin settings (Use the additional Settings link under 'collageplus' section in Plugin Manager menu):
-----------------
* Select an album - Select default album for collageplus
* Filter for photos by orientation - Select picture type for show
* Show header - Show album header on top of gallery
* Show category filter - Show category filter on top of gallery
* Use Lightbox feature - When user click on a photo, show picture in a lightbox. If this turn off, then link goes to picture main site
* Use Adipoli feature - Picture effects from Adipoli. Enable or disable this feature. Check Adipoli website for effects
* Adipoli Start Effect - Select start effect
* Adipoli Hover Effect - Select hover effect
* Use thumbnails - Use thumbnail or full sized pictures. Default is yes, recommended when use lot of pictures
* Picture maximum width - Show when "Use thumbnails" options is off. Setup maximum picture width for full sized photos
* Number of pics - Default pieces of photos. Minimum 10, maximum 50 (full sized) or 100 (thumbnail sized) pictures for show
* Picture margins - Setup picture margins in collageplus container
* Div container width - Empty or number for container size. If empty, then container is 100%. Percent not enabled, just fixed size
* Menu UL Class - If use category filter, then can use custom class for categories (use like a menu)  


How to add to your page:
-----------------
Go to your gallery Settings, and select Album list view. To "The content of the main page" section add "collageplus" parameter.

Parameters to Album list view:
-----------------
* collageplus,1 - Top rated pictures, number of items from collageplus configuration
* collageplus,2 - Most viewed pictures, number of items from collageplus configuration
* collageplus,3 - Last additions pictures, number of items from collageplus configuration
* collageplus,(4-9) - Random pictures, number of items from collageplus configuration (like: collageplus,6)
* collageplus,(10-) - Selected category from collageplus configuration, number of items from parameter number (like: collageplus,36)
* collageplus - Selected category and number of items from collageplus configuration


Additional information:
-----------------
collageplus gallery not show next items:
- no thumbnail for item (like video)
- no enable a photo by admin
- user galleries

If you an developer, then can add more effects, parameters or updates for scripts, see JQuery script developers sites.
For any custom CSS settings use plugins/collageplus/css/main.css file.

=========================================================================

Browser Compatibility:
----------------------
The JavaScript collageplus is tested and works perfectly in these browsers:
- IE 8 and higher
- Firefox 3.x and higher (Win)
- Opera 9.x and higher (Win)
- Chrome (all version) (Win)
It probably works fine in many other browsers, too. Check compatibility list on collageplus site.

=========================================================================

Credits:
--------
This plugin is written by Mykee and based on the "collageplus" by David DeSandro (http://collageplus.metafizzy.co/).
Read collageplus license for using this plugin here: http://collageplus.metafizzy.co/docs/license.html
Many thanks for these authors for plugins, visit these sites for addon settings:
- TipTip - Copyright © 2010 Drew Wilson - http://code.drewwilson.com/entry/tiptip-jquery-plugin
- LightBox 0.5 (modded by Mykee to 0.51) - Copyright © 2007 Leandro Vieira Pinho - http://leandrovieira.com/projects/jquery/lightbox/
- Adipoli 2.0 - Copyright © 2013 CUBE3X - http://cube3x.com/adipoli-jquery-image-hover-plugin/
Don't try to contact the plugin author for support - post on the board publicly instead.

=========================================================================

Change log:
-----------

v1.2 (2014/09/27):
-----------------
- restriction mode added to sql query
- add language support to lightbox caption
- jQuery updated to 1.11.1 version, added jquery-migrate 1.2.1 version

v1.1 (2014/07/11):
-----------------
- small code optimization

v1.0 (2013/08/10)
-----------------
- code started