'''''the questionnaire webapp for realists with deadlines'''''

== Django Questionnaire app ==

The Django Questionnaire app allows you to easily set up a working
questionnaire, complete with email-invitations and CSV export functionality.
This app allows you to spread your questions over multiple pages (categories),
and currently supports 4 types of answers.

Django Questionnaire is licensed under the BSD license, and is Free/Open Source Software.

Django Questionnaire is a cleaned-up/slimmed-down version of a framework Aperte
has developed for various clients. If you want a dedicated, hosted version of
Django Questionnaire, or if you want a version tailored to your needs, feel
free to contact Aperte: http://www.aperte-it.com/contact

If you simply want to set up your own web survey or questionnaire, give Pervidet a try on http://www.pervidet.com

Pervidet was developed by Aperte using Django Questionnaire, and is completely free to use.

== Screenshots ==

Check out a few screenshots of the default template & admin: QuestionnaireScreenshots

== Demo install ==

You can freely try out this app!

 * User login: http://djangoquest-demo.aperte-it.com
 * Admin login: http://djangoquest-demo.aperte-it.com/admin (username: admin, password: test)

Please note that the demo install is refreshed every hour and is to be used
for demonstration purposes only. Email-invitations sent via the admin aren't
delivered in order to avoid abuse.

== Install ==

If you don't know what Django is, see http://www.djangoproject.com. 
You won't be able to install Django Questionnaire without Django!

The project is distributed as a Django project directory, with the 
actual questionnaire app in the questionnaire directory and media/template
directories for the initial views.

 * Make sure you have Django 1.0 or newer installed.
 * Unpack a source tarball (see QuestionnaireDownloads), or checkout this project (''svn co svn://alextreme.org/djangoquest ./djangoquest'')

 * Modify the ''settings.py'' for your situation, at a minimum:
   * Add your name/emailaddress to the ADMIN tuple (the first ADMIN is used for sending the invitations)
   * Change the WORKING_DIRECTORY to the location of your project directory
   * Change the QUESTIONNAIRE_URL to the domain where you want to host this project (this URL is sent to your users in order to login)
   * Change the SECRET_KEY variable to something else (any random string will do)

 * Either run ''python manage.py runserver'' in the project directory, or follow the Django instructions for setting up the directory for your webserver.

== Further details ==

 * Run ''python manage.py createsuperuser'' to create a new administrator account. 

An initial SQLite database is included to bring you up to speed. If you want to
use it under a webserver, make sure the webserver user (www-data in Debian) 
owns the database.

Django Questionnaire is licenced under the BSD license (the same that Django
uses). Feel free to do with it as you want, see LICENSE for the details.