From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual
Crystal Clear action run.png

Release status: stable

Implementation Special page
Description Allows for elections, polls and surveys
Author(s) Tim Starlingtalk
MediaWiki 1.20+
Database changes Yes
License GPL v2 or later

Translate the SecurePoll extension if it is available at translatewiki.net

Check usage and version matrix; code metrics


Open tasks · Report a bug

The SecurePoll extension is a special page extension for elections, polls and surveys. It is used for Wikimedia Foundation Board elections and arbitration committee elections, and was used for the Wikimedia license transition vote among other things.



  • Download and place the file(s) in a directory called SecurePoll in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
require_once "$IP/extensions/SecurePoll/SecurePoll.php";
  • Run the update script which will automatically create the necessary database tables that this extension needs.
  • YesY Done - Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

You will also need to assign the new 'securepoll-create-poll' user right to some user group. To assign this right to administrators, add the following to your LocalSettings.php:

$wgGroupPermissions['sysop']['securepoll-create-poll'] = true;


There are two ways to create a new poll: manually create an XML file and import it, or use the poll creation interface at Special:SecurePoll.

To create a poll manually, it is required to:

  1. write an XML file
  2. import it using the import.php command-line interface command

In the test folder you can find four example files:

  • 3way-test.xml
  • approval-test.xml
  • radio-range.xml
  • schulze-test.xml

To import a poll, run the following from the cli folder:

extensions/SecurePoll/cli$ php import.php ../test/3way-test.xml

Now visit Special:SecurePoll and you will see your poll.