
/**
 * Coppermine Photo Gallery
 * Coppermine version: 1.5.xx
 *
 * iScroll ver 2.1
 *
 * Based on mod. by rphMedia  http://forum.coppermine-gallery.net/index.php?action=profile;u=9702
 * Plugin Written by Joe Carver - http://gallery.josephcarver.com/natural/ - http://i-imagine.net/artists/
 * 16 June 2010
*/


	========
	
	This plugin will add an image scroller to the main (home) page of a Coppermine Gallery.
	
	It is based on the work by  rphMedia and uses a SWF (flash) script to create the 
	scrolling display. Configuration options are for the number of thumbs to display,
	the META album/thumb set (lastup, toprated, most viewed and random), the size 
	of the iscroll window on the page and the selection of 17 small or 5 large thumbnails.
	Adapted to cpg 1.5xx from my cpg1.4.xx plugin version.
	
	========
	To install:
	
	1) Download the zip file to your computer
	
	2) Log in as admin and go to the Plugin Manager page
	
	3) Browse - Upload - Install to install the iscroll plugin. 
	Check your home page or Album list page for the new display.
	
	4) You can now see "ISCROLL CONFIGURATION" in the plugin extra field.
	Open that link to set your options. You will see the page refresh after you submit
	your changes. 
	
	NSTALLATION NOTES: The plugin relies on correct settings in Admin->	Config.
	->General Settings/URL of your coppermine gallery folder. 
	(example: http://mysite.tld/my_coppermine_folder/).
	
	Online Stats (Who's Online) and Slider plugins can be used with iScroll. Set the 
	order in Plugin manager so the order is:
	Online Stats
	Slider
	iScroll
	
	========
	
	To run this plugin with both www and http prefixes for your domain.

	Create a file named crossdomain.xml , copy and paste the following. 
	Add your domain where shown.
	
	<?xml version="1.0"?><!-- crossdomain.xml -->
	<cross-domain-policy>
	<allow-access-from domain="*.your-domain.com" />
	<allow-access-from domain="*www.your-domain.com" />
	</cross-domain-policy>

	Save (no extra spaces or lines at the end) and upload the file to your 
	gallery root directory. (Do not save the extra <-- -->)

	The same formats also apply to subdomains in crossdomain.xml.
	The same formats can also apply to galleries in folders.
	ex. "......your-domain.com/coppermine" />
		
	========
	
	To uninstall:

	1) Use Plugin Manager to uninstall
	
	========
	Credits:	
	
	1) rphMedia - for doing a lot of hard work creating the mod. and swf files
	
	2) The dev. team for snips from SEF URLs
	
	3) Timos Welt and his Slider Plugin for snips and inspiration
	
	4) Nibbler for Online Stats code snips, Joachim Muller and Andre for direction
	

	========	
	
		To Do:
	
		- Future consideration of more meta albums to use (last by, etc.) and full compatibility
		with Enlargeit! plugin.
	
	========
	end