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

Installing PlonePopoll
----------------------

* Unpack it into your Zope Products Folder
* Start Zope, and inside of your Plone Site, create an External Method:
  * Id: InstallPlonePopoll
  * Title: 
  * Module Name: PlonePopoll.Install
  * Function Name: install

This External Method will install PlonePopoll into your Plone Site.
Just go to the Test Tab of the External Method after you have added
it.

* Now you can add a Plone Poll through the Plone Interface. (Adding a Plone Poll through the ZMI won't work).

Migration
---------

* Restart server.
* Create in your plone site folder (from zmi) an external method
  * Module : PlonePopoll.doMigration
  * Method : doMigration
  * Save and test

Summary
=======

PlonePopoll: a poll tool. You just have to define several possible
answers to a question, enable the poll, and then your users can vote
for one of the answers on the poll.

After having voted, the poll results are shown in a bar chart
displaying the number of votes and percentage per answer along
with the total number of votes.

When the poll is ober, you can disable it, so that only the results
can be consulted.

A user has only one vote, but he can change his mind and vote
differently later on. Voting again only changes the vote of the
user, but does not increasethe total the number of votes.

PlonePopoll has been designed by the Ingeniweb team.

And, of course, it's Open-Source (GPL licence).

To make polls accessible to your users, a poll slot is added to
your right slots upon Installation.

PlonePopoll is a new content type that you can add to your Plone
site at any place. It will work together with the portal_popoll
tool that is added to your Plone site.

The edit form of the PlonePopoll allows you to set a title, a
question and then all answer you want to propose.

You can also enable and disable the poll in the edit form. Once
you enable the poll, it will appear in the right slot. When the
poll should be closed, you can disable it. Adding a new poll will
replace the existing poll in the poll slot.

The view displays the same voting interface as in the slot. You
can use this one if you don't like users to vote in the slot.

The results page shows a view of all results. Results are saved in
the PlonePopoll object.
