1 PlonePopoll
By Ingeniweb.
Table of contents
1.1 About PlonePopoll
This is a Poll tool for Plone.
1.2 Requirements
- Plone 3.0
1.3 Instalation
Add Products.PlonePopoll in your buildout.cfg eggs list.
Use the portal_quickinstaller of your Plone site.
Contributors and others can add polls.
Managers can add and configure PoPoll portlets using the new Plone 3 portlets managers.
Users of older PlonePopoll versions will notice that the (now useless) configuration panel has disappeared.
1.4 Copyright and license
Copyright (c) 2005-2009 Ingeniweb SAS
This software is subject to the provisions of the GNU General Public License, Version 2.0 (GPL). A copy of the GPL should accompany this distribution. THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE
See the LICENSE file that comes with this product.
1.5 Architecture
A poll can be in one and only one of those states:
- enabled
- disabled
Results can be in one and only one of those states:
- visible
- not visible
Poll can have multiple choice activated, determining how many choice a user can do.
1.6 Note
Within Plone, it's possible to vote for a poll only if it is enabled AND published.
Results are displayed only when the Results Visibility is set to visible.
1.7 Migration
If you migrate from an oooooold PlonePopoll version (1.x) that's not Archetypes based, create an external method in your Plone site:
- Id: migrate_popoll
- Title: (whatever)
- Module: PlonePopoll.Migration
- Function: migrateToArchetypes
Then click the "Test" tab of this external method.
1.8 Downloads
You may find newer stable versions of PlonePopoll and pointers to related informations (tracker, doc, ...) from http://plone.org/products/plonepopoll
1.9 Subversion repository
Stay in tune with the freshest (maybe unstable) versions or participate to the PlonePopoll evolutions:
https://svn.plone.org/svn/collective/PlonePopoll
1.10 API Documentation
http://ingeniweb.sourceforge.net/Products/PlonePopoll/api/PlonePopoll.html
1.11 More information about PlonePopoll
http://ingeniweb.sourceforge.net/Products/PlonePopoll
1.12 Support and feedback
Please read all the documentation that comes with this product before asking for support, unless you might get a RTFM reply ;)
Note that we do not support the SQL storage mode anymore. The SQL storage mode is an old third party contribution that has not been maintained for a long time. If you want it back, volunteers are welcome ;)
Localisation issues - other than french and english - should be reported to the relevant translators (see Credits below).
Report bugs using the tracker (the Tracker link from http://plone.org/products/plonepopoll). Please provide in your bug report:
- Your configuration (Operating system+Zope+Plone+Products/versions).
- The full traceback if available.
- One or more scenario that triggers the bug.
Note that we do not support bug reports on Subversion trunk or branches checkouts, unless
Mail to Ingeniweb support in English or French to ask for specific support.
Donations are welcome for new features requests
1.13 Credits
1.13.1 Developers
- Main developer: Christophe "big" Bosse
- Plone 3 support: Gilles Lenfant
- Plone 4 support: JC Brand
1.13.2 Translations (other than French and English)
- Bulgarian (bg): Plamen Petkov
- Czeck (cs): Radim Novotny
- Danish (da): Sven Burkert
- German (de): Sven Burkert
- Greek (el): Menelaos Maglis
- Esperanto (eo): Jan Ulrich Hasecke
- Spanish (es): Mikel Larreategi
- Basque (eu): Mikel Larreategi, Ales Zabala Alava
- Italian (it): Massimiliano, Andrea Cecchi
- Dutsch (nl): Michael Reitsma
- Polish (pl): Maciej Dziergwa
- Portugese-Brazilian (pt-br): Luis Flavio Rocha
- Russian (ru): Andrey Fedoseev
- Slovenian (sl): Matjaz Jeran
- Swedish (sv): Jens Hjalmarsson
- Catalan (ca): Pilar Marinas
2 CHANGES
2.1 Considered future features
New types of polls may be interesting (Idea from http://www.apwiz.com/flexivote.htm):
- open poll lets you see results before voting
- in a blind vote you must vote first, but can see all details
- In private poll you see results but not how people voted
- In a secret vote only the owner can see results and voting pattern.
2.2 To do
- Test SQL back-end (find volunteers, we don't want to support this in the future).
- Cleanup and spread in appropriate external methods what's in Extensions/Install.py. We install with GenericSetup from now.
- Provide zconfig features to select and configure the votes back-end (see note about SQL back-end above)
- Use a Zope 3 view for the poll to speed up
- Should we keep migrations ? (useless for old AT based Popoll).
- Notify translators about new msgids.
- Why are the entries of the combo in portlet configuration untranslated when the code (browser/popoll.py)