$Id: INSTALL,v 1.7 2002/10/15 17:40:40 djresonance Exp $

phpTest is a web based testing tool.

An administrator can add any number of questions, tests, users, and groups.
Once a test is created, a user can log in to take the test, and their test results
are recorded and stored in the database for easy viewing. It includes features
designed to prevent cheating such as randomization of questions on tests,
and security logging for unauthorized access to pages.
phpTest is released under the GNU GPL license, so you are free to modify and use
it for both commercial and non-commercial purposes.  If you release
any modifications to the public, you must also release the modified source code.
See the COPYING file for complete details.

It is written and maintained by Brandon Tallent (djresonance@yahoo.com).
The documentation in docbook/html format is located in the docs/ directory.
Please note that the documentation is not complete yet, I'm working on it.
It currently contains detailed installation instructions and an overview
of the system.

As of version 0.6.3, phpTest has an install script that can be used to
set everything up without editing any php files.  In order for the setup
script to work, the include/config.inc.php must be writable by the owner
of the webserver.  With windows, this is not a problem.  With unix,
you might have to chmod 660 or 666 the file so the webserver can write it.
To use this script, open up the http://yourwebsite/phptest/installscript/
and follow the instructions.  If that fails for whatever reason,
(it is not very well tested yet, so please email me if you have problems)
you can still setup phpTest manually by following the steps below:

To install phpTest manually, follow these steps:

1. Navigate to the installscript/ directory

2. Import the phpTest database tables into MySQL by running the following
   command from a shell prompt:

   $ mysql -u username -p password database_name < phptest.sql

   You will need to substitute the username, password, and database_name
   with appropriate values, and the account you use must have insert and add
   privileges.

   If you don't have access to the mysql client from a shell, you can import
   the data with phpMyAdmin (which most web hosts do have).  Just navigate
   to the sql query section and import the phptest.sql file using the file
   upload box.

3. Edit the database variables in include/config.inc.php to match up with your
   configuration.

4. A default administrator account called 'admin' is created with the sql
   dump.  The password for this account is '123456'.

5. Open the phpTest homepage on your web server (index.php) and login as the
   admin user.

6. Change your admin password by click on the "Change Password" link from
   the menu

7. Click on the 'configuration' link in the menu to edit various
   configuration variables for your installation

If you have any trouble getting phpTest working, you can subscribe
to the phpTest users mailing lists at
http://mail.freesoftware.fsf.org/mailman/listinfo/phptest-users
and ask questions there.
