Survey Builder
==============
Version 1.0 Dec 23, 2005 (c) 2005 David Lippman

Survey Builder is a system designed for designing and implementing web-based
surveys.  It includes a design system, an administration system, and a
presentation system.  

Survey Builder is built as a set of PHP scripts.  JavaScript is used in the
Survey designer, and in the surveys for input validation.  Results are stored
in comma-separate-value (CSV) files.  This system does not use MySQL or any
other database system; it was designed for simplicity of setup.

Survey Builder does use passwords for administrators.  While the system 
prevents any action without a set Session (a cookie in most cases), this does 
not preclude the possibility that the system could be compromised by a 
malicious user.

Quick Start:
1) Move all files from the ZIP into a directory in your webspace.
2) Create a directory for storage of the administrative CSV databases.
   Ideally, this directory should NOT be in your webspace.  Move the files
   admins.csv and Surveys.csv into this directory.
3) Use CHMOD to set the permissions on admins.csv and Surveys.csv to allow the
   webserver process (that executes PHP scripts) to read and write these files.
   If you're not sure how to do this, contact your System Administrator.
4) Create a subdirectory for storing survey results.  Set the permisssions on
   this directory to allow the webserver process to read, write, and execute
   the directory.
5) Edit the file config.php in the webspace directory.  Change the pathnames
   to match the directories you just created.
6) Hop online and access admin.php.  The default admin is username: admin,
   password: admin. 
7) Modify the sample survey, if you'd like, to see what the Survey designer looks
   like.  When you're done, delete the survey.
8) Create a user account for yourself with Master rights.
9) Logout as admin and back in as yourself.  Delete the user "admin"


The colors and some layout features of the surveys are specified in the survey.css
Cascading Style Sheets file.  You can modify these to your liking, but remember
that the same style is used for all surveys.


This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or (at
your option) any later version.

This program is distributed in the hope that it will be useful, 
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License (at http://www.gnu.org/copyleft/gpl.html) 
for more details.
