phpWebSite Gallery Plug-in Files

README file for phpWebSite Gallery Plug-in 1.0
http://www.digi-fx.net
andrew@digi-fx.net

//////////////////
//    Files
//////////////////
1.)  gallery.php
2.)  gallery_config.php
3.)  gallery_functions.php
4.)  gallery_language.php
5.)  gallery_setup.php
6.)  blank.gif
7.)  icon.gif
8.)  readme.txt
9.)  license.txt

//////////////////
// Requirements
//////////////////
- PHP4
- phpWebSite 0.7.6+ (will not work with 0.8.0+)
- mySQL

//////////////////
// Installation
//////////////////
1.) Open "gallery_config.php" in a TEXT-ONLY editor. Notepad or any other editor
will suffice. Do not use an HTML editor or Word. Edit all values where applicable.
If you're in a hurry, simply edit the first two variables, $gal_path and $gal_url
to mirror your directory structure. Then go back at a later time and edit everything
else.

2.) Create a directory named "gallery" under the "plug-ins" folder of your root
phpWebSite directory. Under "gallery", create the directories "images" and "media".
Under "media", create a directory named "thumbnails". The "images" directory is used
to store individual gallery images only, and the "media" directory is used to store
uploaded media only.

The following example, requires a fixed-width font:
phpWebSite root
      |
      plug-ins
             |
             gallery
                   |
                   images
                   media
                       |
                       thumbnails

3.) CHMOD the directories "images", "media", and "thumbnails" 777 or some other
value to allow PHP to upload files to them.

4.) Open "gallery_language.php" to translate the program to another language other
than English if you so desire. I ask that if you translate the program, you send
me a copy of your "gallery_language.php" file so I can include it in future releases.

5.) Upload "gallery.php" and "gallery_setup.php" to the phpWebSite root and all the
other files to the "gallery" directory. Make sure to upload blank.gif and icon.gif
in Binary mode, while everything else in ACSII mode.

6.) Login as the admin. to your web site.

7.) Point your web browser to the setup script e.g.
http://www.domain.com/gallery_setup.php

8.) If all goes well, and the installer says so, delete "gallery_setup.php".

//////////////////
// Script Usage
//////////////////
1.) Login as the admin. to your web site.

2.) Under the plug-ins tab, click on the gallery plug-in or spinning camera.

3.) You should now see the Gallery Admin. screen, noting that all options aren't
visible yet. Add galleries, then albums, and finally media (gif, jpg, or png).

Some terminology:
Gallery - or main category that contains numerous albums; galleries must have
          at least one album
Album - or sub-category that contains media
Media - the heart of your gallery plug-in; the photos

If you'd like to see another media format such as QuickTime movies added in the
future, contact me.

4.) After you've added some media, you might wish to create a link to the gallery
plug-in in your main menu. The link should point to "gallery.php".

5.) Visit "gallery.php" in your web browser to view your neat-looking gallery.

//////////////////
// Notes
//////////////////
- If the last album you create contains no media, you'll get the error "No media
found." Simple solution: delete that album

//////////////////
// Features
//////////////////
- unlimited number of galleries, albums, and media
- media search
- smart page spanning when viewing galleries, albums, and media
- individual gallery images
- password protected galleries
- gallery automatically expires on a certain date
- enable and disable galleries
- extremely easy to customize the look and other options
- easy to use admin. section

//////////////////
//  Change Log
//////////////////
Version 1.0: - Official Release