/**************************************************
  Coppermine 1.5.x Plugin - photocols
  *************************************************
  Copyright (c) 2014 Mykee (www.acegem.hu)
  *************************************************
  This plugin based on photocols script.
  More parameters, license visit developer's website: https://github.com/2CodersTeam/jquery.photocols
  ************************************************
  $HeadURL: https://coppermine.svn.sourceforge.net/svnroot/coppermine/branches/cpg1.5.x/plugins/photocols/readme.txt $
  $Revision: 6994 $
  $LastChangedBy: mykee $
  $Date: 2014-07-11 14:05:10 +0100 (Fri, 11 July 2014) $
  **************************************************/


What it does:
-------------
Displays Photocols on album list page.
This plugin has been created for cpg1.5.x.

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

How to install:
---------------
* Unzip
* Upload folder 'photocols' 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 "photocols" 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/photocols" 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 'photocols' section in Plugin Manager menu):
-----------------
* Load HTML5 compatible script for old IE - Load HTML5 compatible code if not used yet (Default: disabled)
* Load JQuery - Add JQuery to head (Default: disabled)
* Show header - Show album header on top of gallery (Default: no)
* Div container class - Use custom class for container (Default: photocolswrapper)
* Select an album - Select default album for photocols (Default: Random files)
* Filter for photos by orientation - Select picture type for show (Default: Mixed)
* Use thumbnails or big size  - Select size type (Default: Thumbnail)
* Number of pics - Default numbers of photos. Minimum 10, maximum 50 (Default: 20). Note: if 'Pictures of column' smaller than 3, than picture numbers show automatically by height and width of container!
* Background color - use color code, color name or transparent too (Default: #000)
* Photocols width - Container width, use px or percent or auto (Default: auto)
* Photocols height - Container height, use only px! (Default: 600)
* Column width - Colum width, only px! (Default: 200)
* Picture height - Picture height in column, only px! (Default: 300)
* Gap of pictures - Gap between pictures, only px! (Default: 5)
* Overlay color - Color of overlay, use color codes (Default: #000)
* Overlay opacity - Opacity of overlay, 0: transparent, 1.0: opaque, use decimal numbers (Default: 0.3)
* Title size - Set size of pictures titles, use px (Default: 16)
* Captiopn size - Set size of pictures captions/subtitles, use px (Default: 12)
* Stop on hover - When mouse hover, column stopped (Default: yes)
* Pictures per column - Add manually row numbers. Note: if this parameter 3 or lower, then pictures number will calculated (automatic mode). Use 4 or higher to manually mode! (Default: 0)
* Too long caption cut here - If you have too long captures, set this number for word-cut (Default: 250) 
 


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 "photocols" parameter.

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

IMPORTANT!
This photocols version a modified of 1.0.1/1.0.2 version: I added to script a 'rows' options. This item by default is a calculated number by script. If you set to 4 or higher number, this will overwrite calculated number (manual mode). If 3 or little, row number will calculate again (automatic mode).   

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

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

Browser Compatibility:
----------------------
The JavaScript photocols 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 photocols site.

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

Credits:
--------
This plugin is written by Mykee and based on the "photocols" by 2Coders Studio (http://2coders.com).
Don't try to contact the plugin author for support - post on the board publicly instead.

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

Change log:
-----------
v1.2 (2014/09/27):
-----------------
- fixed restriction mode in sql query

v1.1 (2014/08/31):
-----------------
- add group policies parameter (thanks for wilk and André)

v1.0 (2014/07/11)
-----------------
- code started