quizz CGI script by Thomas Linden.
Version 1.1.0



Install
---------------------------------

  1. Edit the Makefile.

  2. Type 'make install' (possibly as root)

     or

  1. Copy the whole stuff into a new directory.

  2. Make sure the apache daemon has write permissions
     to the data/ directory.


  3. Configure the apache daemon. Add "Options ExecCGI"
     to the virtual host or directory block where the
     script resides.

  4. Configure the templates. You may use any html editor.
     Be sure to preserve the special tags (inside []) and
     the <!--perl* comments!



Configuration
---------------------------------

  Change to the config/ directory and edit the file quizz.cfg,
  this is the master configuration file.

  The most important thing to do for you is to add an additional
  config file. You can have many additionaly configs, one for
  each questionaire.


  Edit the questionaire config file, see the example file
  pc.quizz for an example. The name of this file does not
  matter - btw.
  

  The questionaire config file should at least have the following
  stuff configured:

    quiz_name         - the quiz name
    quiz_description  - a description
    key               - a random string, used as directory for
                        data storage

    The <config>..</config> block contains several important
    values which influences the behavior of the script:

       max_best       - how many users should be displayed in the
                        best of list

       you can either use counter_time or counter_points as the
       timeout counter, set the appropriate one to 1.

       use_once may set to 1 to enable cookies. Users are then
       only allowed to use the quiz once.

  The questions are configured in <question N>..</question> blocks
  N is the numer of the question, this must be an integer.

    The following variables must exist:

      time   - max seconds the question takes
      points - max points for max time, e.g. if time is 20 and points 40
               then the user gets 40 points if he needs 0 seconds.
               points must be tilable by time!
      type   - question type. possible values:
                 M (multiple choice)
                 S (single choice)
                 R (regular expression)
      question - the question you want to ask, some string.

     For single and multiple choice questions you have to define
     some <choice N>..</choice> blocks, N may be a letter or a number.
     Inside such a block only one variable is required: answer,
     which is the possible answer the user could choose.

     For the redex type question no such block is required, instead
     just define the variable result as a perl regex.(see below).

     The variable result defines which answers are the correct ones.
     For single choice questions just add the letter or number.
     For multiple choice questions add the letter(s) separated by
     comma.
     For regex questions just add the perl regex on which the answer
     must match.



License
---------------------------------

  Licensed under the terms of the artistic license.



Copyright
---------------------------------

  2003 (c) Thomas Linden <tom@daemon.de>



    