Documentation
ABOUT
pollsFactory is a plugin for the open-source web publishing software called Dotclear.
Create polls with multiple queries (choices lists, options boxes, text fields) and add them to entries, pages, widgets or templates.
A user guide with screenshots is available in French: guide d'utilisation.
REQUIREMENTS
- Dotclear 2.39
- PHP 8.1+
- Dotclear admin permissions to configure plugin
- Dotclear usage,contentadmin permissions to manage polls
NOTICE
This plugin uses the shared table post_option (also used by
other plugins like postWidgetText). This table is not removed when the
plugin is uninstalled.
Polls created with old versions of pollsFactory (1.x) are kept and their settings are migrated on update.
USAGE
First install pollsFactory, manualy from a zip package or from Dotclear plugins repository. (See Dotclear's documentation to know how do this)
Enable plugin and set main options from plugin configuration page.
When enabled you have a menu in main sidebar menu called Polls manager under "Plugins" group, follow it to manage polls:
- Create a poll with a title and a description,
- Add queries from tab Queries of the poll,
- Add choices to queries of type choices list or options box,
- Open or close votes, see results and select text responses to display on public side.
Each poll has its own public page (URL survey/...).
When you edit an entry or a page you have a new sidebar option called Polls to link polls to this entry.
Polls can also be displayed with widgets Polls: list, Polls: polls of an entry and Polls: selected polls, or with template tags:
{{tpl:PollForm}}: display current poll in poll page template (attributes title and description can be set to 1 to show them){{tpl:PollsOfEntry}}: display polls of current entry
Voters are identified by a cookie, their IP address or both. IP addresses are not stored, only a hash of them.
LINKS
CONTRIBUTORS
- Jean-Christian Denis (author)
- Claude (AI assistant by Anthropic)
You are welcome to contribute to this code.