JaxPhoto README

Welcome!

Thank you for either visiting a site demo or downloading the source for JaxPhoto.

Important note on using the demo: If you are viewing a demo and are trying to login to the admin section, leave the username and password fields blank and click Submit.

Over the last couple of years I have been using JAlbum to create static photoalbums from pictures taken with my digital camera, but now that I have more than 50 albums to sift through, I have hit the point where it is no longer easy to use JAlbum to maintain them all. So I created this web application to allow me to easily tie albums together. I hope you enjoy using it as much as I do!

Installation Notes

Software Requirements

Webserver that can run PHP (Apache, IIS, etc.)
PHP 4.x or 5.x
No database needed for this app!

Setup

Unzip the archive to your webserver. Give PHP the ability to create files in the JaxPhoto folder (use chmod if necessary).
Open login.php in a text editor and change the values held by $id_username and $id_password.
If you are not interested in example1 and example2, delete both example folders as well as jaxphoto.csv and jaxphoto.xml. These will rebuild once you've entered the admin interface.
Dump whatever photo albums you have into the root of JaxPhoto, Just like example1 and example2. Each photoalbum must be valid - to see what is necessary for validation, see the next section below.

A note about customization: all visual elements in JaxPhoto are CSS driven. Simply edit jax-photo.css found in support/css to change colors + sizes + layouts. Also, all template pictures (like the header and footer) are found in support/pics; just change those to customize the application and make it your own.

Photoalbum Validation

A quick diagram:
    album/
    album/index.html
    album/thumbs
    album/slides

Each photoalbum must have the following characteristics:

All parts of the album must be encapsulated by an album folder
There must be a thumbs directory inside the root of the album
All thumbnails for the album must reside in the thumbs directory
There must be at least one thumbnail in the thumbs directory
There must be a slides directory inside the root of the album
All non-thumbnail pictures for the album must reside in the slides directory
There must be an index.html file in the root of the album

It would be easiest to just download JAlbum and create your album that way, then dump the album inside your JaxPhoto folder.

License

Copyright (c) 2005, Daniel Juliano
All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

* Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.
* The names of contributors to this source code may not be used to endorse or promote products derived from this software without specific prior written permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.