Description:
------------
GiftWeb is an online gift registry system. Items are entered into a wish
list, and other users viewing the wish list can mark them as purchased.
Web sites can easily be linked to if the item can be purchased online.
Users can be members of multiple groups, and can only see the wish lists
of other users that are members of the same groups.



Quick steps to installation:
----------------------------
0. If necessary, change the giftweb-x.y.z directory name to giftweb or other
   choosen name. (I'm including the version # so as not to stomp over a
   previous install.)

1. install postgresql 

2. import the gift.sql file into the database defined in main.inc (default is
   giftweb) by running "psql giftweb < giftweb.sql"

3. run createuser (PostgreSQL too) to add the user who will be accessing 
   the database. I added apache as that's what my web server runs as under 
   RedHat Linux.
   Tell it that the user cannot create databases, and that the user cannot
   add other users. 

4. make sure your web server is setup to serve up .php files properly.
   This could include (but is not limitted to) adding the line: 

    AddType application/x-httpd-php3 .php 

   to your httpd.conf 

5. add a new user through the "Sign Up!" web link

6. add a new group by doing something like:
      echo "insert into groups values('100','groupname','101');" | psql gift
   This creates a new group with GroupID (gid) of 100, named 'groupname',
   and a group admin of UserID (uid) 101, which is the first user created.

You still need to go in and play with the databases to get things working
right now. In particular, there is no way to add new groups, assign group
admins, delete users that are no longer active. This will all change soon 
as the site administrator page gets written. This was the last priority
on my mind when I wrote GiftWeb. (Unfortunately, this may be a little while
in coming. I'm getting married in 26 days!)

If you have any questions, please email me. I will do my best to assist you.

Matthew Jachimstal
matthew@jachimstal.com

29 April 2002

