Copyright (c) 2006-2007 Infrae. All rights reserved.
See also LICENSE.txt

================
SilvaPoll README
================

Meta::

  Valid for:  SilvaPoll 0.3+
  Authors:    Guido Wesdorp, Wim Boucquaert, Jasper Op De Coul
  Email:      guido@infrae.com, wim@infrae.com, jasper@infrae.com

SilvaPoll is an extension to have traditional polls inside Silva sites. A
question is asked on which the public can answer, and results are displayed
to those that do. The poll can be an independent page or be embedded in a
Silva Document as a Code Source.

Installation
============

For installation and styling instructions, see INSTALL.txt.

Making a Poll
=============

Creating Silva Poll Questions
-----------------------------
After following the installation instructions you can add a Silva Poll Question
in the SMI. Fill in all required fields and save the question, repeat this step
for all questions. Separate answers by an empty line.

Rendering the Silva Poll
------------------------
You can use the Poll Questions like documents, and send visitors there via a
link in content or navigation.

You can also embed Poll Questions in Silva Document. When editing a document,
click on external sources and add all of your questions (don't forget to hit
the "add external source" button ;-).

- Rendering the poll immediately:
Publish your Silva Poll Questions and/or Silva Document and that's it.

- Rendering time based Silva Poll Questions and their result:
In the SMI go to the publish tab of a Silva Poll Question and fill in dates as
appropriate.

Fill in the options you would like to set:
* question display start time: time when a Silva Poll Question should be
displayed for the public

* question display end time: time when a Silva Poll Question should stop being
displayed for the public

* results display start time: time when the result of Silva Poll Question should
be displayed for the public

* results display end time: time when the result of Silva Poll Question should
stop being displayed for the public

Styling Silva Poll
------------------
Silva Poll looks much better if you reference the included stylesheet. See the 
INSTALL.txt doc for instructions.

Contact information
===================

For questions, bug reports, etc. send email to wim@infrae.com, jasper@infrae.com
