Questionnaire cgi-bin program for simple questionnaires.
========================================================

Copyright (C) 1997-1998 Dave Beckett.

This program is free software; you can redistribute it and/or modify
it under the same terms as Perl itself.


INTRODUCTION

The cgi-program questionnaire.pl can be used to create simple closed
(fixed answer) and open (text box) questionnaires, with checking for
required answers and submission by email.


REQUIREMENTS

Perl 5 (at least version 5.004).


CONFIGURATION INSTRUCTIONS

The first step is to configure the program.  At the top of
questionnaire.pl are four variables that should be edited to sensible
values:

# Configuration file containing the list of questionnaires
$::configuration_file= '/usr/l/csweb/config/questionnaire.conf';

# Questionnaire usage log file
$::log_file  = '/usr/l/csweb/httpd/logs/questionnaire.log';

# Results directory
$::results_dir  = '/usr/l/csweb/httpd/logs/qresults';

# Email address of administrator
$::administrator_email = 'cs-webmaster@ukc.ac.uk';


The configuration file must be readable by the user who runs the web
server; the usage log file and the results directory must be writable
by that user.


The next step is to read the documentation which can either be done
once the cgi-bin script is installed, by using the cgi-bin URL with
no parameters or a stand-alone document can be created by typing:

	% make

and then use your favourite browser to look at docs.html

	% lynx docs.html

This document describes how to create a questionnaire and the main
configuration file.  Examples of thse are available as
examples/djb1.quest and examples/questionnaire.conf respectively.


INSTALLATION

Copy questionnaire.pl to the cgi-bin directory, create the
configuration file and the questionnaires and then try it out.  The
condiguration and documentation is always available if the cgi-script
is called without any parameters.


Dave Beckett
http://www.cs.ukc.ac.uk/people/staff/djb1/

$Id: README,v 1.2 1998/06/08 13:35:35 djb1 Exp $
