*******************************************
******      Simple PHP Gallery       ******
*******************************************

Created by: Lee Trilsbach - catboo.com
Copyright: 2010 Lee Trilsbach
Mail: cat@catboo.com


----------------------------------------------------------------
WARNING! - Important information
----------------------------------------------------------------
Do not edit anything other than the following files:

1. index.php
2. default.css
3. config.php

Editing any other files may cause Simple PHP Gallery to stop working.


----------------------------------------------------------------
THE BASICS - The basics to get you up and running
----------------------------------------------------------------

1. CREATING CATEGORIES

	A) Open the folder 'gallery' then open the folder 'categories'.
	B) Create a new folder for each of the categories you would like in your Simple PHP Gallery.

Note: The category name will match your folder name. For example: if you created a folder named 'drawings' and a folder named 'photos' Simple PHP Gallery will automatically generate two categories named drawings and photos for you.

2. ADDING PICTURES

	A) Add your desired pictures to each category folder.
	B) Your images can be named anything you like.
	C) The following image types are supported by Simple PHP Gallery: JPG, PNG and GIF.
	
Note: If you wanted the following images 'apple.jpg' and 'pear.gif' to come under the category 'fruit' you would place those images in a folder named 'fruit' inside the 'categories' folder. Simple PHP Gallery does not rezise your images for you. Please check they are the desired size before uploading them.

3. ADDING DESCRIPTIONS

	A) Descriptions are optional you do not need to create a text file for all of your images.
	B) To add a description to an image you simply save a text file (*.txt) in the same location as the image and give it the same name.
	C) Example: 'myimage.jpg' description file would be called the following: 'myimage.txt'.
	D) Add the text you want in this description to this text file.
	
Note: HTML tags are supported, for example: If you wanted to make the words "This text is bold" bold, you would simply put "<strong>This text is bold</strong>" into the text file.

4. ACCESSING YOUR GALLERY

	A) Upload the folder named 'gallery' and all its contents to your web server.
	A) Simply go to the URL http://www.YOURDOMAIN.com/gallery/


----------------------------------------------------------------
THE EXTRAS - Addition information for more advanced users
----------------------------------------------------------------

If you do not understand anything in this section do not worry. This information isn't needed to use Simple PHP Gallery, it is just extras for those who wish to do further customization.

1. CONFIG FILE

The 'config.php' file contains a number settings that change the way Simple PHP Gallery functions. Each setting is given an overview of what it does and lists each possible option you can use. You do not need to change anything in this file for Simple PHP Gallery to work, it just gives you a few extra options.

2. GALLERY ELEMENTS

Each element of Simple PHP Gallery (e.g. category, image, description, etc) is broken down into a small line of code in index.php. This means you can move each element to anywhere you like on the page.

	A) <?php dispCat(); ?> This displays the current category you are viewing. 
	B) <?php dispImg(); ?> This displays the image.
	C) <?php dispDesc(); ?> This displays the current image's description if one exists.
	D) <?php dispCatNav("|"); ?> This displays the navigation menu for all the categories in your Simple PHP Gallery.
	E) <?php dispPages("|"); ?> This displays the page navigation for each category (e.g. "<prev  1|2|3|4|5|6  next>").
	
You may notice that the code is slightly different for both the page navigation and category navigation elements. They both have the following inside their brackets: "|" this is the symbol used to divide each link, you can change this to anything you like.

	A) <?php dispPages("|"); ?> would output: "<prev  1|2|3|4|5|6  next>"
	B) <?php dispPages("-"); ?> would output: "<prev  1-2-3-4-5-6  next>"
	C) <?php dispPages("*"); ?> would output: "<prev  1*2*3*4*5*6  next>"


----------------------------------------------------------------
CONTACT DETAILS
----------------------------------------------------------------	

If you have any further questions I can be contacted via cat@catboo.com
Thank you for using Simple PHP Gallery. Enjoy!

