######################################################################
# WEBQUIZ  version 1.08  2 May 2003                                  #
# Author:  Zhuhan Jiang                                              #
# Address: School of Computing and IT, University of Western Sydney  #
# E-mail:  z.jiang@uws.edu.au                                        #
#                                                                    #
# Freeware under GNU copyright convention.                           #
######################################################################


The WEBQUIZ suite of PERL programs aims to privide teaching instructors with
the essential web tools that suffice for resource access control, student 
uploads, and online timed quizzes. It is self-contained, configurable, and
portable to different platforms. The WEBQUIZ suite provides the following
functionalities

 * access control of multiple web sites
 * online registration of user password for quiz and for upload
 * online quiz in the form of multiple choices and short answers
 * uploading local files or files from another web site
 * authentication and proxy scheme supported for file transfering
 * upload receipts and receipt authentication
 * quiz automatically timed, uniquely allowed
 * 3 tiers of rights: normal users, privileged, administrators
 * administration can be done either via web or simple text editing
 * runnable on UNIX or WINDOWS 2000


This WEBQUIZ suite contains a collection of 6 main files

 * register.pl  - let permitted user pick a password
 * submit.pl    - let registered user upload local or web files
 * webquiz.pl   - let registered user run each permitted quiz once
 * _config.rc   - configuration file to be included in all 3 above programs;
                  _config.unix is another such sample file for unix
 * faq.htm      - user manual in the form of frequently asked questions
 * README.txt   - this file
 
Other files are either supporting files or automatically generated files.
The name of these files typically depend on the configuration in _config.rc.
As an example of a sample unit "IWSD" (Interactive Web Site Development),
we typically expect the following additional files:

 * IWSD_namelist.txt     - list of allowed (enrolled) user IDs
 * IWSD_password.txt     - user selected passwords
 * IWSD_htpassword.txt   - usable by APACHE web server to control web access
 * IWSD_htgroup.txt      - usable by APACHE web server to control web access
 * IWSD_rawpassword.txt  - usable for other purposes such as user creation
                           (default doesn't produce this for security reasons)
 
Suppose in configuration file _config.rc we map the quiz files to the
subdirectory "IWSDquiz", then in THAT subdirectories we could expect the
following type of files:

 * IWSD_access.txt  - controls what quiz session are available and when
 * IWSD_logfile.txt - logs all activities related to quiz
 * quiz.0           - a typical quiz file with session id "0"
 * quiz.XXX         - a quiz file named session id "XXX"
 * solution.0       - automatically generated solution for quiz.0
 * state_12345678.0 - carry current quiz result (state) for user
                      "12345678" with session "0"


Passwords need to be specified in the configuration for web tasks of
administrative nature. There is just 1 password that corresponds the
administrator, the person of highest privileges. There are 0 or multiple
passwords that can be created in the configuration file for the privileged
tutors who have web privileges lower than the administrator but higher
than the normal users. Tick the "administrator" box and supply the
corresponding password if you are doing the adminstrative tasks via the web.
The default password for the administrator is "administrator", and the
default password for the privileged tutor (named "privileged") is "privileged".
Make sure you CHANGE THESE PASSWORDS at some stage.

For a quick installation with WINDOWS 2000 with IIS, unzip the package into
c:\Inetpub\wwwroot\webquiz\, enable PERL script execution for that subdirectory,
and change the web "Directory Security" for the directory to "Basic
Authentication". Then start with http://localhost/webquiz/index.htm.