Extension:PollNY

MediaWiki extensions manual - list

PollNY Release status: stable
Implementation	Special page
Description	Advanced polling system that uses special pages and allows embedding polls to wiki pages
Author(s)	Aaron Wright David Pean Jack Phoenix
Last version	2.0
MediaWiki	1.16+
Database changes	yes
License	GNU General Public License 2.0 or later
Download	Download snapshot (Git master) Git [?]: repo summary • tree • code changes SVN [?]: checkout-url • tree • code changes
Parameters $wgPollDisplay $wgPollScripts $wgCreatePollThresholds
Added rights polladmin
Check usage (experimental) Bugs: list open list all report

PollNY extension defines a new namespace for polls (NS_POLL, the namespace number is 300 by default) and 6 new special pages for poll creation/administration.

Polls can be embedded on normal wiki pages with the <pollembed> tag. Syntax is: <pollembed title="Name of the poll" />.

Special:AdminPoll can be used by users with 'polladmin' rights to view all polls and administer them, Special:CreatePoll is used to create new polls, Special:RandomPoll takes you to a randomly chosen poll, Special:UpdatePoll is like action=edit for polls and Special:ViewPoll can be used by all users to view available polls.
These new special pages (with the exception of Special:UpdatePoll) will show up on Special:SpecialPages in the "Polls" section.

Dependencies

• SocialProfile extension
• New database tables: poll_choice, poll_question and poll_user_vote

Installation

1. Dump the files into $IP/extensions/PollNY
2. Create the three new, required database tables (by re-running the MediaWiki updater script, update.php)
3. Add require_once("$IP/extensions/PollNY/Poll.php"); into the wiki's LocalSettings.php and define the namespace + its talkspace
4. Installation can now be verified through Special:Version

User rights

This extension adds one new user right, polladmin, which allows accessing Special:AdminPoll to administer polls created through Special:CreatePoll. By default sysops have this user right.

User points

• $wgUserStatsPointValues['poll_vote'] — set this to something to give out points for answering existing polls.

Parameters

• $wgPollDisplay['comments'] — whether to display comments on poll pages or not. Defaults to false. Requires Comments extension.
• $wgPollScripts — web-accessible path to this extension's files. If you change this, you also need to edit Poll.js. Defaults to $wgScriptPath . '/extensions/PollNY'.
• $wgCreatePollThresholds — for example 'edits' => 5 if you want to require users to have at least 5 edits before they can create new polls. Defaults to an empty array (no restrictions).