From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manualManual:Extensions
Crystal Clear action run.svg

Release status:Extension status stable

ImplementationTemplate:Extension#type Special page
DescriptionTemplate:Extension#description Allows for elections, polls and surveys
Author(s)Template:Extension#username Tim Starlingtalk
Compatibility policyCompatibility#mediawiki_extensions master
MediaWikiTemplate:Extension#mediawiki 1.25+
Database changesTemplate:Extension#needs-updatephp Yes
LicenseTemplate:Extension#license GNU General Public License 2.0 or later
Hooks usedTemplate:Extension#hook

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

Check usage and version matrix.


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:
    wfLoadExtension( 'SecurePoll' );
  • 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.

To users running MediaWiki 1.24 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension() If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of wfLoadExtension( 'SecurePoll' );, you need to use:

require_once "$IP/extensions/SecurePoll/SecurePoll.php";

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.