[phpesp-dev] respondent interface

[Chad B. <ch...@be...>]

Here is my latest respondent interface.  I've added some features and 
fixed some bugs.  Be sure to read the comments at the top of start.php 
and start.inc.php

Download from:

http://www.beardendesigns.com/phpESP/index.php

Overview:
			
This interface allows respondents to login and be presented with a list 
of surveys to take.  It also allows them to view results of past 
surveys they have submitted. There is a "news" column that can be 
customized to you liking with news.inc.php.

Feature:

I have now added a feature which allows you to get more information 
from your respondents. Since the respondent table in phpESP only stores 
the bare necessities (username, password, first_name, last_name, group) 
I thought it might be nice to be able to store additional info also 
like phone,address,etc.  How to do it?  I could go in and change the 
respondent table to add these fields but this may be a problem when 
trying to merge my code with the official phpESP releases.  Then I hit 
upon the idea of storing this info as survey responses!   Create a 
survey with the info you would like to know about the respondents, 
phone, address, etc. and name it personal_information (this is easily 
changed).  Turn on the feature in the start.inc.php file and voila now 
a user is presented with this survey first before being allowed to 
answer any additional surveys.  In fact, you can have a different 
personal survey for each group just name it 
groupName_personal_information .

Instructions for getting the respondent interface working:

   1. unzip resp_interface.tar.gz into the phpESP dir.
       % cd /your_path_to/phpESP
       % tar xzf resp_interface.tar.gz
           This places the following files:
               phpESP/public/start.php
               phpESP/public/start.inc.php
               phpESP/public/esp_base.inc.php
               phpESP/public/news.inc.php
               phpESP/public/respondent_survey_results.inc.php
               phpESP/public/css/lmc.css
               phpESP/admin/include/lib/espauth-default.respondent.inc

   2. Adjust config variables.
       adjust $esp_base    in public/esp_base.inc.php
       adjust style_sheet  in admin/phpESP.inc.php to 'lmc.css'

   3. Create a respondent account if one doesn't exist already.

   4. Use your browser to display phpESP/public/start.php
       You will be prompted for username and password and then
       the interface should be displayed

   5. There is now support for personal_information surveys which allow 
you
      to add more information to the responents account.  Right now the
      phpESP package only stores username, first_name, last_name, and
      password for an individual user.  By creating a survey called
      [group_name_]personal_information you can add additional info.  
You can
      turn this feature on by adjusting the variable,
      $check_personal_survey.  It is turned OFF by default.  There's more
      info in start.inc.php