zkGallery by www.zarpateka.net v.1.2.0

zkGallery is a PHP-Ajax web images gallery.

All javascript is written with mootools release 1.11.

Tested in Firefox 3 Beta 5, Firefox 2.x, IE 7 and IE 6.

» Features

Auto thumbnails

Image Resize

Auto Play

Tooltips with image descriptions

Configurable colors

xml images file generator (autoconfig.php - Beta)

» Installation

Download the source code from sourceforge.

Copy all the content of the zip file to a directory of your web server configured with PHP 5.

You will need the XSL and GD modules enabled in your PHP configuration.

» Gallery Configuration

Upload your images to the 'img' directory.

Modify the 'xml/zkgallery.xml' file changing the images paths.

	<!-- one image by thumbnail -->
	<imgs>
		<thumbnail>
			<path>filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>
		</thumbnail>
		<image>
			<path>filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>	
		</image>		
	</imgs>
	<imgs>
		<thumbnail>
			<path>path_to_image/filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>
		</thumbnail>
		<image>
			<path>path_to_image/filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>	
		</image>		
	</imgs>


	or 

	<!-- several images in one thumbnail -->
	<imgs>
		<thumbnail>
			<path>filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>
		</thumbnail>
		<image>
			<path>filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>	
		</image>		
		<image>
			<path>filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>	
		</image>
	</imgs>

	and
	
	<!-- auto thumbnail -->
	<imgs>
		<thumbnail>
			<path auto="true" />
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>
		</thumbnail>
		<image>
			<path>filename</path>
			<title>image_title</title>
			<desc>image description bla bla bla ...</desc>	
		</image>		
	</imgs>


			

You can configure the other features in the 'xml/config.xml' file.

<Params>	
	<!-- Images parent folder -->
	<folder>img</folder>
	
	<!-- Number of images per page -->
	<numimgs>7</numimgs>
	
	<!-- Image resize -->
	<imgResize>True</imgResize> <!-- Global resize flag -->
	<imgHeight>402</imgHeight> <!-- Global resize height -->
	
	<!-- Auto thumbnails -->
	<thumbHeight>55</thumbHeight>
	
	<!-- Gallery styles - #9bc823 - Optionals -->
	<arrowBgcolor>#9bc823</arrowBgcolor>	
	<specialColor>#9bc823</specialColor>	
	<bgColor>#f5f5f5</bgColor>	
	<h1BgColor>#454545</h1BgColor>	
	<h1Color>#f5f5f5</h1Color>	
	<h1BorderColor>#999999</h1BorderColor>	
	
</Params>

			

» Gallery Layout

You can change the layout and styles of the gallery modifying the 'xsl/index.xsl' file (XHTML syntax!) and the CSS files.

Don't modify the other XSL files if you are not really sure what are you doing!

» License

zkGallery is distributed under the terms of the GNU General Public License (GPL).

» Special Thanks

Thanks to sourceforge, mootools... and to all people than share their knowledge of web development.

» Credits

zkGallery has been developed by zarpa37(at)gmail(dot)com. It has been my first open-source contribution and I hope than more projects will be released!

Please, don't forget to visit www.zarpateka.net