Extension:SecurePoll

**MediaWiki扩展手册**
SecurePoll; 发行状态：稳定版
实现	特殊页面
描述	允许进行选举、投票和调查
作者	Tim Starling留言
最新版本	3.0.0 (持续更新)
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
MediaWiki	1.25+
数据库更改	是
表	securepoll_entity; securepoll_msgs; securepoll_properties; securepoll_elections; securepoll_questions; securepoll_options; securepoll_voters; securepoll_votes; securepoll_strike; securepoll_lists; securepoll_cookie_match
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 ; Git [?]: 下载Git master; 浏览存储库 (Phabricator · GitHub); 提交历史; 存储库貢獻者 (GitHub); 代码复核;
	参数 $wgSecurePollTempDir; $wgSecurePollMostActiveWikisThreshold; $wgSecurePollUseLogging; $wgSecurePollKeepPrivateInfoDays; $wgSecurePollUseNamespace; $wgSecurePollSingleTransferableVoteEnabled; $wgSecurePollGPGCommand; $wgSecurePollCreateWikiGroups; $wgSecurePollGpgSignKey; $wgSecurePollTranslationImportSourceUrl; $wgSecurePollCreateRemoteScriptPath; $wgSecurePollExcludedWikis; $wgSecurePollCreateWikiGroupDir; $wgSecurePollShowErrorDetail;
	添加权限 securepoll-create-poll; securepoll-edit-poll; securepoll-view-voter-pii;
	使用的函数钩 CanonicalNamespaces; LoadExtensionSchemaUpdates; SpecialPage_initList; TitleQuickPermissions; UserLogout;
	提供的函数钩 SecurePoll_JumpUrl; SecurePoll_GetUserParams;
季度下載量	22 (Ranked 114th)
正在使用的公开wiki数	889 (Ranked 269th)
	前往translatewiki.net翻譯SecurePoll扩展
問題	开启的任务 · 报告错误

This page is a translated version of the page Extension:SecurePoll and the translation is 70% complete.

Outdated translations are marked like this.

SecurePoll扩展是一个特殊页面扩展，用于选举、投票和调查。它被用于维基媒体基金会董事会的选举和仲裁委员会的选举，并被用于维基媒体许可证的过渡投票等。

截图

主页面显示投票的清单。
一个带有描述性文字的投票页面。
SecurePoll的管理日志
在SecurePoll上的投票者日志

安裝

下载文件，并将解压后的SecurePoll文件夹移动到extensions/目录中。
开发者和代码贡献人员应从Git安装扩展，输入：cd extensions/ git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/SecurePoll
将下列代码放置在您的LocalSettings.php 的底部：
```
wfLoadExtension( 'SecurePoll' );
```
运行更新脚本，它将自动创建此扩展必须依赖的数据库表。
完成 – 在您的wiki上导航至Special:Version，以验证已成功安装扩展。

In addition, you will need to add some user groups and user rights to your LocalSettings.php file. Here is one way to do it, which gives a new group called electionadmin the power to do everything in SecurePoll (create polls, edit polls, see voter IP addresses):

$wgGroupPermissions['electionadmin']['securepoll-create-poll'] = true;
$wgGroupPermissions['electionadmin']['securepoll-edit-poll'] = true;
$wgGroupPermissions['electionadmin']['securepoll-view-voter-pii'] = true;

Once this group is created, a bureaucrat can add someone to the group using Special:UserRights. Then that person can visit Special:SecurePoll to view polls, create polls, edit polls, tally polls, etc.

Each poll's data is compartmentalized. You can have 100 electionadmins, but if you only add one electionadmin to a particular poll, only that one electionadmin will be able to edit that particular poll or see user IPs. If an electionadmin is removed from a poll, they will lose access to it.

securepoll-view-voter-pii is used for "scrutineering" a poll, which involves looking at a list of voter IPs, user agents, and X-Forwarded-For headers to look for cheating (secret duplicate votes by sockpuppets). Because this involves looking at voter IP addresses and other sensitive, personal, de-anonymizing data, it is a sensitive user right, so only trusted users should be assigned to the electionadmin group.

It is possible to split securepoll-view-voter-pii into a separate group. You can use a config such as the one below to create a group called scrutineer that contains the securepoll-view-voter-pii right, separating it from the electionadmin group:

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

$wgGroupPermissions['scrutineer']['securepoll-create-poll'] = true;
$wgGroupPermissions['scrutineer']['securepoll-edit-poll'] = true;
$wgGroupPermissions['scrutineer']['securepoll-view-voter-pii'] = true;

A user also needs to be added to the poll (and hence have the securepoll-edit-poll right) in order to view PII - securepoll-view-voter-pii by itself has no effect.

用法

创建新投票

有两种方法来创建一个新的投票：手动创建一个XML文件并导入，或者使用Special:SecurePoll的投票创建界面。

手动

要手动创建一个投票，需要：

编写一个XML文件
使用import.php命令行界面命令导入它

在test文件夹中，你可以找到四个示例文件。

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

要导入一个投票，从cli文件夹中运行以下内容。

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

要使用docker导入一个投票，从cli文件夹中运行以下内容：

docker-compose exec mediawiki php extensions/SecurePoll/cli/import.php extensions/SecurePoll/test/radio-range.xml

通过Web界面

拥有securepoll-create-poll权限的用户可以点Special:SecurePoll下面的链接来创建新的投票。

要创建一个新的投票，请填写创建表格中的必填项。请特别关注一下字段：

只有electionadmin组的成员允许增加投票管理员。如果$wgSecurePollUseLogging设置为true，那么不管增加还是移除投票管理员都会留下日志。日志可以在Special:SecurePollLog查看。
要创建一个加密的投票，请选择加密方法。如果你选择GnuPG，会生成一个公钥和一个私钥。在创建表格中输入加密密钥，并将私人密钥保存在线下的某个地方（一旦选举结束，你将需要它来进行统计）。一个详细示例可以在这里找到。

现在访问Special:SecurePoll，你会看到你的投票。

编辑现有投票

要编辑一个投票，你必须是该特定投票的管理员。在Special:SecurePoll，点击编辑你想要的投票。

在选举开始之前，关于选举的任何内容都可以被编辑。选举开始后，有些字段就不能再编辑了。

编辑可以参与投票的人

要编辑谁可以投票，你必须是该投票的管理员。在Special:SecurePoll，点击该投票的投票者资格链接。

翻译一个投票

要翻译一个投票，你必须是该特定投票的管理员。在Special:SecurePoll，在你想翻译的投票处点击翻译链接来翻译。

查看投票者名单

任何人都可以看到投票者的名单，除非在创建投票时禁用了透明功能。

某一投票的管理员可以看到投票者的名单，以及可能有助于识别重复投票者的私人信息（例如IP地址、用户代理信息、共享cookies）。如果$wgSecurePollUseLogging设置为true，任何管理员查看隐私数据都会留下日志。这些日志可以在Special:SecurePollLog查看。

管理员可以删除任何他们认为是重复的投票。

计票

要统计一个投票，你必须是该特定投票的管理员。 Special:SecurePoll，点击计票链接为你想要计票的投票计票。

如果投票之前已经统计过，结果将显示在页面上。如果没有，或者你想重新统计，有一个表格可以开始新的统计。

如果投票是未加密的，点击计票按钮。
如果投票是加密的，你需要输入更多信息。比如，如果你使用GnuPG，输入私钥并点击计票按钮。如果加密投票有很多人投票，可能会花很长时间计票。你可能需要过段时间再回来查看结果。

访问Special:SecurePoll，你就能看到你的投票。

单一可转移票制计票

要启用单一可转移票制（STV）计票，请在LocalSettings.php加入下面的配置值。

$wgSecurePollSingleTransferableVoteEnabled = true;

更多关于单一可转移票制的信息，可以在維基百科找到。

贪心算法实现(source)。

Quota is + .000001. Quota is the minimum value of votes to secure a seat.

1. Compute the quota.
2. Assign votes to candidates by first preferences.
3. Declare as winners all candidates who received at least the quota.
4. Transfer the excess votes from winners to hopefuls.
5. Repeat steps 3 and 4 until no new candidates are elected. (Under some systems, votes could initially be transferred in this step to prior winners or losers. This might affect the outcome.)
If all seats have winners, the process is complete. Otherwise:
6. Eliminate one or more candidates, typically either the lowest candidate or all candidates whose combined votes are less than the vote of the lowest remaining candidate.
7. Transfer the votes of the losers to remaining hopeful candidates.
8. Repeat 3–7 until all seats are full.

The quota we will use (step 1) is the Droop quota (source):

floor( no. votes / (no. seats + 1) ) + 1

The method for transferring votes from elected or eliminated candidates will be the Meek method:

Meek Method

Tallying (JobRunner)

Tallies can be processed via a scheduled job 手册:作业队列 . Make sure to create a scheduled job for this task or execute the task manually.
Tallies can also be processed by executing the tallying script manually:

To execute a tally, run the following from the cli folder located at extensions/SecurePoll/cli:

extensions/SecurePoll/cli/tally.php

To execute a tally using MediaWiki-Docker, run the following from the cli folder located at extensions/SecurePoll/cli:

docker-compose exec mediawiki php extensions/SecurePoll/cli/tally.php

Generating (STV) Test Elections

Test (STV) elections can be generated from the cli folder located at extensions/SecurePoll/cli:
To generate a test election, run the following from the cli folder located at extensions/SecurePoll/cli:

extensions/SecurePoll/cli/generateTestElection.php

Test (STV) elections provide scaffolding from which to tally on

Redirect polls

If you are using SecurePoll in a wikifarm, it is possible to configure it to create a main election on a vote wiki, and then it will also create a redirect poll on a different wiki, with a vote link that points back to the vote wiki.

帮助文档

安全投票

安全投票的所有相关文档可在wikitech:SecurePoll查看。

安全投票的改进

A summary of improvements to SecurePoll can be found at Anti-Harassment Tools/SecurePoll Improvements.

Understanding the STV result

Documentation on STV results can be found at Anti-Harassment Tools/SecurePoll Improvements/Understanding the STV result.

SecurePoll 2014 Redesign

此扩展用于一个或多个维基媒体项目。这可能意味着扩展足够稳定、运作足够良好，可以用在这样的高流量的网站上。请在维基媒体的CommonSettings.php和InitialiseSettings.php配置文件中查找此扩展的名称以查看哪些网站安装了该扩展。特定wiki上的已安装的扩展的完整列表位于Special:Version页面。

此扩展在以下wiki农场/托管网站和/或软件包中提供：

這不是一份權威名單。即使某些wiki农场/托管网站和/或软件包未在这里列出，它们也可能提供此扩展。请检查你的wiki农场/托管网站或软件包以确认提供情况。

SecurePoll 发行状态：稳定版

实现	特殊页面
描述	允许进行选举、投票和调查
作者	Tim Starling^留言
最新版本	3.0.0 (持续更新)
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
MediaWiki	1.25+
数据库更改	是
表	securepoll_entity securepoll_msgs securepoll_properties securepoll_elections securepoll_questions securepoll_options securepoll_voters securepoll_votes securepoll_strike securepoll_lists securepoll_cookie_match
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 Git ^[?]: 下载Git master 浏览存储库 (Phabricator · GitHub) 提交历史存储库貢獻者 (GitHub) 代码复核
参数 $wgSecurePollTempDir $wgSecurePollMostActiveWikisThreshold $wgSecurePollUseLogging $wgSecurePollKeepPrivateInfoDays $wgSecurePollUseNamespace $wgSecurePollSingleTransferableVoteEnabled $wgSecurePollGPGCommand $wgSecurePollCreateWikiGroups $wgSecurePollGpgSignKey $wgSecurePollTranslationImportSourceUrl $wgSecurePollCreateRemoteScriptPath $wgSecurePollExcludedWikis $wgSecurePollCreateWikiGroupDir $wgSecurePollShowErrorDetail
添加权限 securepoll-create-poll securepoll-edit-poll securepoll-view-voter-pii
使用的函数钩 CanonicalNamespaces LoadExtensionSchemaUpdates SpecialPage_initList TitleQuickPermissions UserLogout
提供的函数钩 SecurePoll_JumpUrl SecurePoll_GetUserParams
季度下載量	22 (Ranked 114^th)
正在使用的公开wiki数	889 (Ranked 269^th)
前往translatewiki.net翻譯SecurePoll扩展
問題	开启的任务 · 报告错误