# Member Directory README File
# Version 3.0
# README
# By Mike Calabrese
# http://www.mikecalabrese.com
# 12-15-2003

# This program is available for free on an AS-IS basis.  I am not
# responsible for consequential damages, loss of income or whatever
# else that may happen as a result  of the use of this program.

This program allows one to build and maintain a dynamic web based
membership directory.  The program consists of 12 Perl scripts.  This
README file will explain how to configure these scripts to run on
your website.  This program has been tested successfully in both
UNIX and LINUX environments.

If you downloaded the tarred and compressed version of this program,
the directory structures are already in place.  If you elected to get
the files for this program via the email Perl script, you will have to
set up the directory structure for the program as follows:

mbrdir (directory)
   index.pl
   mbrdir.pl
   mbrdata (directory)
      maxmbrno
      (The mbrno files created by the program go here)
   tools (directory)


If you got the program via the tar.Z download this structure is already
in place for you.  Generally speaking, all directories and files should be
chmodded to 755.

On all of the Perl scripts be sure that your path to Perl is correct and
that the Perl reference is the first line of the script.  You can find
your correct path to Perl by typing which perl at the command line.

With this version the only variable that has to be configured is the path
to the Member Data directory, which is called mbrdata_dir.  Make sure that
this variable is set to the exact UNIX path to this directory in the
following files:


add2.pl
delete2.pl
delete3.pl
edit2.pl
edit3.pl

maxmbrno- This is the file that has the current member number in it.
The default is 0.  You should not change this number unless you want to
change the starting member number.

This is an overall description of how the program works:

The mbrdir.pl script reads from a series of mbrno files and dynamically
displays them on a web page.  The add scripts create a mbrno file and
increase the maxmbrno file by 1.  The edit scripts read a member record
into an HTML form which allows you to edit them.  Then overwrites the
previous file with your changes.  The delete scripts remove a mbrno record
and decrease the maxmbrno file by 1 if it is the last file.  If you delete
a file that is not at the end of the list, there is a gap in the mbrno
sequence.