File	Date	Author	Commit
fancybox	2010-11-01	Erich Simmons	[396dbf] Changed permissions
README	2010-11-01	Erich Simmons	[774041] Added README
index.php	2010-11-01	Erich Simmons	[77801e] First Iteration

Read Me

LICENSE:
 Dual licensed under the MIT and GPL licenses:
  [ http://www.opensource.org/licenses/mit-license.php ]
  [ http://www.gnu.org/licenses/gpl.html ]

THANKS:
 Thanks to the Fancybox [ http://fancybox.net/ ] group. This is just a wrapper 
 of their visual code into somethin automated. If you're looking for something 
 to do more static albums, check them out.
 
INSTALL:
 Drop the fancybox directory and index.php directory into wherever you want your 
 photo library to be hosted. (Web Dir)  Make sure the webserver has write 
 permissions for this directory, and anything you add to it.
 
 Once you have the files in place, just browse to that directory from your
 favorite web browser. If anything isn't configured right, it'll let you know 
 before you can use the program.
 
 After that, to add / remove images, just upload the pictures / folders into 
 the same folder. Recursive directories are fine. Just make sure that we can 
 write to all the new directories. (This is so we can save the thumbnails we 
 auto generate.) The program will let you know if it isn't done right when 
 you go to the directory.
 
OPTIONS:
 In any directory you can put a file called [ settings.ini ]. All sub-
 directories will inherit those settings (unless another file overrides it 
 later). Put any of these lines in the file you wish, these are the default
 options:
 
thumb_size			= 120							; Default thumb size (already created thumbs will remain the same size)
ignore_dir[]		= ""							; tn and fancybox directories will be ignored by default
slideshow_enabled 	= true							; true / false for slideshow enabled
slideshow_speed		= 5000							; default ms for slidshow advance speed
css_source			= "default"						; can be 'default' or a path to the chosen css file (from / on the server)
title				= "Photo Gallery"				; Used for head title, and h3 title
													; Page footer.
footer				= "<a href='http://sourceforge.net/p/phpfancyalbum'>PHP Fancy Album</a>"			
password			= ""							; Optional password. (Note, this only protects the webpages, links to the images are not password protected!)

 Notes:
 * title you'll want to change to your page title.
 * footer you can change to any copyright, or whatever you want on the bottom
   of pages
 * password is the password to be requested for access to the page. 
 	(See password section below)
 * Slideshow speed is in milli-seconds.
 * Slideshow enable is if the slideshow should be present or not.
 * I wouldn't change thumb size too much without making a new css.
 * ignore_dir[]  shouldn't be needed unless you're putting a directory up that
   you don't want php fancy album to read.


PASSWORDS:
 Yes, there is a basic password protection scheme built in. You can use one 
 password for any directory. The passwords are saved in a session cookie. 
 This way you can have a set, (or multiple sets) of pictures psuedo protected 
 from wandering eyes. Here are some notes:
 * Passwords only protect the generated web page, not the images. As such 
   someone could guess the image file name and see the images, mainly if you 
   use the auto-number on your camera files :).
 * If you use the same password for multiple folders on your site, then once 
   someone has access to one page, they have access to the other.
 * Someone can enter multiple passwords and have them saved to their session. 
   Such that if you have 3 passwords for your site, they could enter all 3.
 * If you don't want to bother someone with entering a password, when you send 
   them the weblink add ?token=password  at the end. (Subing your password 
   obviously). 
   
REQUIRMENTS:
 * PHP 5.1.6 or above (make work on any 5.x, not sure, haven't tested, let me 
   know if you do).
 * GD (it makes the thumbnails)
 * Apache 2.x with mod_rewrite enabled
 * Linux or Mac OS (really any *nix, just don't try it on Windows yet) for the server.
 
CONTACT:
 You can contact me, Erich Simmons, at [ public AT erichsimmons DOT com ].