Secret Santa / Polyanna


REQUIREMENTS
------------
This program is two fold: a web-based front end based off of PHP with the
ability to perform the pseudo-random pick-from-the-hat via its backend.

So, you need a working installation of:
o A Webserver, preferably Apache.
o MySQL >= 4.23, preferably the latest.
o PHP >= 4.1, preferably the latest.


INSTALLATION
------------
Simply edit the Makefile, following the instructions within, and type
make install

The installation will put all of the files in the diretory "secret_santa"
in the directory you defined in the Makefile as "TOP_WEB".

From there, point your web browser to the new installation, and click the link
for "Sign Up!"  Follow the prompts, and you are on your way to setting up your
own Secret Santa/Polyanna list on-line.


UPGRADING
---------
After updating the settings within the Makefile, simply type:
make upgrade


USER ACCOUNTS
-------------
Just a note on user accounts.  ONLY the account that is used to create the
"group" will be tagged as an administrative account for that group.  All
additional accounts will be normal user accounts.

What that means is that the one account that starts the group will have a whole
mess of additional options.  That user can "Shuffle The Names", "Add a person"
to the group, "Delete a person" from the group, "Reset a person's password",
and finally add/delete relationships among people.

The normal user will only get the group attendance listing, the name of
the person that has been picked for them, the ability to change their password
(recommended after they first log in), and the currently-disabled ability
to get the 'wish list' of the person that has been picked for them.


ALTERING THE LOOK
-----------------
All of the pages are now in a "templates" directory.  Feel free to alter the
look and feel of the pages as you see fit.  The pages from the distribution
are functional, but generic.