扩展:电邮授权

This extension requires the PluggableAuth extension to be installed first.

MediaWiki擴充功能手冊

Email Authorization 发布状态： 稳定版
实现	用户权限
描述	实现PluggableAuth PluggableAuthUserAuthorization钩子，以使用授权电邮地址列表提供授权。
作者	Cindy Cicalese
最新版本	1.5 (2019-11-14)
兼容性方针	Master maintains backwards compatibility.
MediaWiki	1.27+
PHP	5.5+
数据庫更改	是
许可协议	MIT授權條款
下载	下载扩展 Git [?]: 下载Git主线 浏览存储库 (GitHub) 提交历史 repository contributors (GitHub) 代码复核
参数 $wgEmailAuthorization_RequestFields $wgEmailAuthorization_EnableRequests
添加的权限 emailauthorizationconfig
使用的钩子 PluggableAuthUserAuthorization LoadExtensionSchemaUpdates BeforeCreateEchoEvent
翻譯Email Authorization擴充功能如在translatewiki.net可用
检查使用和版本矩阵。
问题	尚未完成的工作 · 回報錯誤

The Email Authorization extension implements the PluggableAuth PluggableAuthUserAuthorization hook to provide authorization using a list of authorized email addresses. It provides a special page, Special:EmailAuthorizationConfig, for an administrator to use to add and remove email addresses and email domains from the authorization list.

安装

This extension requires PluggableAuth to be installed first.

• 下载文件，并将其放置在您extensions/文件夹中的EmailAuthorization目录内。
• 将下列代码放置在您的LocalSettings.php的底部：

  wfLoadExtension( 'EmailAuthorization' );
  

• 运行更新脚本，它将自动创建此扩展必须依赖的数据库表。
• Configure as required
•  完成 – 在您的wiki上导航至Special:Version，以验证扩展已成功安装。

配置

标记	默认	描述
$wgEmailAuthorization_EnableRequests	false	Indicates whether a special page (Special:EmailAuthorizationRequest) will be available for accounts to be requested. If enabled, that page will contain a form used to request an account. By default, that form will contain a single field: email address. Additional fields can be specified by $wgEmailAuthorization_RequestFields. In addition, if true, a special page (Special:EmailAuthorizationApprove) will be available for users in the bureaucrat group to approve accounts.
$wgEmailAuthorization_RequestFields	[]	An array of additional fields for the request form. The definition of each field is itself an array with the following possible fields: label: the label for the field (string); must be present mandatory: if present and true, this field is mandatory values: a comma separated list of strings that are the possible values of this field; the field will be a drop-down list rows: if present, the number of rows in the text area for this field columns: if present, the number of columns in the text field or text area for this field (default: 50) The last three parameters (values, rows, and columns) are used to decide how to display the field. If values is present, a drop-down list will be displayed, and any values for rows and columns will be ignored. If values is not present but rows is present, a text area of the specified size will be displayed, with columns defaulting to 50 if it is not present. If only columns is present, a text field of the specified width will be displayed. If none are present, a text field of 50 columns will be displayed. Regardless of the contents of this array, an email address field will be present as the first field. For example, $wgEmailAuthorization_RequestFields = [ [ 'label' => 'Organization', 'mandatory' => true ], [ 'label' => 'Extra Information', 'rows' => 4, 'columns' => 60 ], [ 'label' => 'Animals', 'values' => [ 'dog', 'cat' ] ] ]; would display a mandatory text field (Organization) with 50 columns, a text area with 4 rows and 60 columns (Extra Information), and a drop-down list to choose between dog and cat (Animals).

Users who should be able to add and revoke email addresses and email domains on the Special:EmailAuthorizationConfig page must be given the emailauthorizationconfig right. For example:

$wgGroupPermissions['bureaucrat']['emailauthorizationconfig'] = true;

Since this extension relies upon the user's email address to perform authorization, you should prevent the user from editing it with the following configuration:

$wgPluggableAuth_EnableLocalProperties = false;

钩子

The Email Authorization extension supplies the following hooks to other extensions:

• EmailAuthorizationAdd and EmailAuthorizationRevoke take a single parameter: an email address or email domain (i.e. @ followed by the domain).
• EmailAuthorizationRequest takes the following parameters: an email address and a JSON-encoded array of form fields.
• EmailAuthorizationApprove and EmailAuthorizationReject take the following parameters: an email address, a JSON-encoded array of form fields, and the User object of the bureaucrat approving/rejecting the account request.

版本历史

Version 1.5

• Trim and lowercase emails before adding them

Version 1.4

• Added PHPCS and autofix some found sniffs with PHPCBF

Version 1.3

• Added optional account request capability controlled by $wgEmailAuthorization_EnableRequests
  • Special:EmailAuthorizationRequest
  • Special:EmailAuthorizationApprove

Version 1.2

• Change message prefix to prevent collisions with other extensions
• Table formatting
• Renamed Special:ConfigEmailAuthorization to Special:EmailAuthorizationConfig

Version 1.1

• Bug fix: adding email address that already existed threw exception
• Email addresses and domains entered in Special:ConfigEmailAuthorization now are validated
• Added missing rights messages

Version 1.0

• Initial version

参见

• Extension:PluggableAuth