Files in the archive:

* index.php        :      Main script file. No need to touch it.
* settings.php     :      Contains configuration stuff. Edit the variables in it to suit your needs.
* fnorder.php      :      Nonsense generator. See below for an explanation.
* index.txt        :      Contains data about your albums (title, description). Look inside for info.
* .htaccess        :      Makes it possible to use nice URLs. Don't edit it.
* shampoo.inc      :      Template file. Edit this if you want to embed the gallery in your website.
* shampoo.css      :      Main stylesheet.
* ie6.css, ie7.css :      Stylesheets to make up for Internet Explorer's inadequacies as a browser.
* js/shampoo.js    :      Main JavaScript file. Contains niceties to "enhance the user experience".
* js/thickbox.js   :      Script to overlay photo over screen instead of going to it. See below for info.
* js/thickbox.css  :      Stylsheet for thickbox.js
* js/loading.gif   :      Loading image for thickbox.js
* img/*            :      Arrows and pointers (used in shampoo.css).
* license.txt      :      License. Please read it (it's not lawyer-speak, except at the bottom).


* Installation *

Extract the archive into a directory on your server and you are good to go. All you have to do is
put some directories containing pictures inside it. To add descriptions and titles for each album,
open index.txt in a text editor and follow the instructions.

* Captions for pictures *

Very simple. Let's say you have an album (directory) called "lemurs" containing pictures from your
holiday in Madagascar. Some of the pictures you want to add captions for are called "lemur1.png" and
"myfavouritelemur.jpg". What you have to do is create a file called "lemurs.txt" (same name as
directory) and put the following in it:

lemur1.png|Who would've thought lemurs could do handstands!
myfavouritelemur.jpg|Really, out of all of them, this one was my favourite.

Hopefully you can discern a pattern from that. Blank lines in the file are ignored.

* thickbox.js *

By default, when you are viewing the list of albums (front page) and you click a thumbnail, the larger
version will appear over the page, which will be greyed out. This is commonly known as a Lightbox on the
internet and was made popular by Lokesh Dhakar. I made this one because all the others out there rely on
JavaScript libraries. If you already use one, then by all means use Lightbox or Thickbox or some other
script out there.

Anyway, if you open up shampoo.js, you will see this on line 18 (or thereabouts):

    if (Shampoo.albumarray && typeof Thickbox !== 'undefined') Thickbox.init();
   
It checks that the page is in album display mode and the Thickbox script was downloaded. Then it executes it.
For more info on how it works, see thickbox.js's comments at the top.

If you want to get rid of this behaviour, simply delete the line.
If you want it to be enabled also for album pages (where lots of thumbnails are displayed) replace it with this:

    if ((Shampoo.albumarray || Shampoo.thumbarray) && typeof Thickbox !== 'undefined') Thickbox.init();