--------------------------------------------------------------------------------
IMPORTANT                    READ BEFORE INSTALLING                    IMPORTANT
--------------------------------------------------------------------------------
Contact List requires PHP 4.1.0 or later to run on your server.  (Please note I
said PHP, not phpBB.  They are two different things.)

Contact List is a BETA modification.  This means that it is not complete - there
are features I have not yet added or fully developed.  It also means that there
may be bugs in the code.  While I do test Contact List before releasing it, I
cannot recreate every environment that may cause a problem or error.  You may
encounter unexpected effects when installing or using Contact List.  If you do,
I would appreciate it if you would give me as much information as possible about
the problem so that I can try to correct it in future releases.

Contact List is tested on MySQL 3 databases only.  It has not been, and will not
be, tested on other types of databases (largely because I don't have them).  I
have provided *.sql files for other types of databases.  However, since I have
no way of testing those files, I do not know if they work.  If you are familiar
with table creation, table alteration, and insertion queries for your type of
database, you should look the sql files over for mistakes before trying to
install.

If you need support or have questions during the installation process, please
check the Mini FAQ section of the readme.txt file.  Many of the more common
questions have already been answered there.
--------------------------------------------------------------------------------
                            PRE-INSTALL INSTRUCTIONS
--------------------------------------------------------------------------------

Before continuing with the installation of this hack, you should complete this
checklist:
[ ] Do you have a previously installed version of this hack on your forum?
      - If you intend to upgrade from an older version to this version, then you
        should use the upgrade instructions in upgrade.txt instead of the
        instructions below, unless otherwise noted in that file.
      - If you intend to downgrade from a higher level version, uninstall that
        version first.
[ ] Are you installing this hack on a phpBB package that has been modified, has
    non-subSilver templates installed, or is a different version than the one
    official supported?
      - You may have some trouble with some of the installation instructions,
        especially if code you are told to FIND has	already been changed.  Try
        searching for partial lines using key words or characters.
[ ] Are you installing this hack on a phpBB port, such as the one for PHP Nuke?
      - The installation instructions are written for use with an unmodified
        version of the original phpBB, which can be obtained from www.phpbb.com.
        They may or may not work with ports of phpBB.  As the author of this
        hack, I may not be able to provide support for it when installed on a
        phpBB port.

--------------------------------------------------------------------------------
                           INSTALLATION INSTRUCTIONS
--------------------------------------------------------------------------------

To install this hack on a phpBB forum, follow these steps.

1) If you have not done so already, unpack ZIP file you have downloaded.  This
   will create new directories and files as described the readme.txt file.

   But, you've probably already done this step since you're reading this file,
   right?

2) This hack adds some new files to your forum.  At this point, you should
   upload the files in hack_files.  Maintain the directory structure in
   hack_files, while considering it equivalent to the phpBB root directory.
   That means that files in hack_files/admin/ should be place in your forum's
   admin/ directory, and so on.  If directories found in hack_files do not exist
   on your forum, create matching directories on your forum as needed.

   Special Notes on this Step:
     - The upload procedure is the same as the COPY command mentioned in
       file_edits.txt and is duplicated here due to the number of people that
       never understand the COPY command.  You only need to copy/upload once.
     - If you do not have the subSilver template installed, then you do not need
       to copy any hack_files/templates/subSilver files to a subSilver directory
       on your forum.
     - If you have non-subSilver templates installed, do be sure to copy the
       hack_files/templates/subSilver files to the directories of all templates.

3) The files in the hack_install directory are used to modify your forum's
   database as needed to use this hack.  In order to use these files, you will
   need to go to your forum and log in using an Administrator account.  Do not
   allow the session for this log in to expire until installation of the hack
   is completed.

   It is also recommended that you make a full backup of your forum's database,
   or at least any database tables that will be affected by this hack, for easy
   recovery if there is a problem later.


   Upload the hack_install directory, and all files in it, to your forum's
   root directory.  For detailed instructions, see the similar procedure in Step
   2.  Run the installer file by using your web browser to go to the
   hack_install/install.php file that is now on your web site.  This will walk
   you through several steps in which the installer will try to add database
   changes.  Make a note of any error messages, as they may mean you need to do
   some manual database changes yourself later.

   When finished, be sure to delete the hack_install directory and all files
   inside it from your server.  Leaving these files in place presents a possible
   security risk.  Bad mojo!

   Special Note on this Step:
     - If the installer tells you that you need to be log in again and
       attempting to do so results in an error message, you may have to restore
       your backups of any files mentioned in the error message in order to log
       in.  You can always upload the edited versions of those files again
       later.

4) In this step, you will prepare to edit your previously existing forum files.
   All of the instructions for doing this are listed in the file_edits.txt file.
   Open this file in your favorite text editor, such as Notepad, Wordpad,
   PHPEdit, or EditPlus.  If you use Dreamweaver for this step, be CERTAIN that
   you have activated the "Code" mode of that program, or you will have problems
   later.

   Check the file for an Author's Notes section near the top for any special
   instructions that you may need to follow.  If there are none, or no Author's
   Notes at all, look near the top for a section labeled "Files To Edit."  This
   is a list of the files you'll be editing.  Obvious, huh?  Before you do
   anything else, make certain you have two local copies of each of these files.
   One copy is for editing and the other is for a backup of the unchanged file.
   If there is a problem later, you can restore the backup file(s) as needed.  
   If you don't have two local copies, make them.  When you don't have *any*
   local copies, download a copy from your web site via FTP, SSH, or another
   file transfer method.

   Special Note on this Step:
     - The local copy of the file(s) you're editing should NOT be the actual
       files being used on your site.  An exact copy of them, yes, but not the
       real thing.  Changes should not be appear on your site as you edit the
       files.
     - If you have already installed Prillian 0.7.1, some of the changes in
       file_edits.txt are unnecessary.  Please use the prillian_file_edits.txt
       file instead of file_edits.txt.

5) If there was a "premodded" directory created during Step 1 and the
   version.txt file in that directory contains the version number of your phpBB
   installation, do this step.  If not, skip to the next step.

   Determine if you have previously made any changes to each of the files in
   the Files To Edit list.  When using a pre-hacked or ported phpBB package,
   that counts as having changed all files for the purpose of this step.  If
   you have not edited some of the listed files, then you can find the matching
   file in the premodded directory and replace your local editing file with the
   premodded file.  This allows you to skip editing the file in the next step.

6) If there are any files in the "Files to Edit" list that you did not replace
   in Step 5, then you now need to edit your local copy of each file in said
   list.  The instructions for editing these files are store in file_edits.txt.
   If you do not understand the format used, check the Mini FAQ in readme.txt.

   Finish this step up by uploading the edited version of the files to your web
   site.

   Special Note on this Step:
     - If you have non-subSilver templates installed, remember that you need to
       adapt the subSilver file instructions for editing those templates.  The
       features of this hack will not be available on other templates until they
       are edited appropriately.

7) That's it, you're officially done.

8) This is an optional step.
   If the hack has an .hl file in the docs/ directory, you may be able to use
   that.  If you don't know how to use it or what an .hl file is, check the
   Mini FAQ in readme.txt.