/**************************************************
  Coppermine 1.5.x Plugin - Isotope
  *************************************************
  Copyright (c) 2013 Mykee (www.acegem.hu)
  *************************************************
  This plugin based on Isotope gallery script.
  Isotope may be used in commercial projects and applications
  with the one-time purchase of a commercial license. For non-commercial, 
  personal, or open source projects and applications, you may use Isotope 
  under the terms of the MIT License. You may use Isotope for free. If you are 
  paid to do your job, and part of your job is implementing Isotope, 
  a commercial license is required.
  More information here: http://isotope.metafizzy.co/docs/license.html
  ************************************************
  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/
  - Adipoli 2.0 - Copyright (c) 2013 CUBE3X - http://cube3x.com/adipoli-jquery-image-hover-plugin/
  ************************************************
  $HeadURL: https://coppermine.svn.sourceforge.net/svnroot/coppermine/branches/cpg1.5.x/plugins/isotope/readme.txt $
  $Revision: 6994 $
  $LastChangedBy: mykee $
  $Date: 2013-08-10 23:05:10 +0100 (Sat, 10 Aug 2013) $
  **************************************************/


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

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

How to install:
---------------
* Unzip
* Upload folder 'isotope' 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 "isotope" 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/isotope" 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 'isotope' section in Plugin Manager menu):
-----------------
* Select an album - Select default album for isotope
* 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 isotope 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 "isotope" parameter.

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


Additional information:
-----------------
Isotope 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/isotope/css/main.css file.

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

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

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

Credits:
--------
This plugin is written by Mykee and based on the "Isotope" by David DeSandro (http://isotope.metafizzy.co/).
Read Isotope license for using this plugin here: http://isotope.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.0 (2013/08/10)
-----------------
- code started