扩展:管理员链接

MediaWiki扩展手册

Admin Links 发行状态： 稳定版
实现	特殊页面 , 函数钩 , API
描述	Defines a special page, "AdminLinks", meant to serve as a "control panel" for administrators; and adds a link to this page to their "user links"
作者	Yaron Koren <yaron57@gmail.com> (Yaron Koren留言)
最新版本	0.6.2 (2023年8月)
兼容性政策	master分支维持向后兼容。
MediaWiki	1.35+
PHP	7.4+
数据库更改	否
Composer	mediawiki/admin-links
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 Git [?]: 下载Git master 浏览存储库 (Phabricator · GitHub) 提交历史 存储库貢獻者 (GitHub) 代码复核 README
示例	The "Admin links" page for Discourse DB
参数 $wgAdminLinksDelimiter
添加权限 adminlinks
使用的函数钩 SkinTemplateNavigation::Universal
提供的函数钩 AdminLinks
前往translatewiki.net翻譯Admin Links扩展
問題	开启的任务 · 报告错误

Admin Links is an extension to MediaWiki that defines a special page, "Special:AdminLinks", that holds links meant to be helpful for wiki administrators; it is meant to serve as a "control panel" for the functions an administrator would typically perform in a wiki. All users can view this page; however, for those with the 'adminlinks' permission (sysops/administrators, by default), a link to the page also shows up in their "Personal URLs", between "Talk" and "Preferences".

管理员链接为其他扩展提供一个钩子和API以便他们添加自己的链接或章节到这个页面。

You can see an example of this page with additional links and sections added by other extensions here.

MediaWiki自带“特殊:特殊页面”这个页面，列出了wiki上安装的所有扩展的特殊页面，这可能会让您想知道为什么还需要这样一个额外的“管理员链接”页面。 但是呢，有数个重要的不同点让“管理员链接”变得有用：

• "SpecialPages" holds links to every special page in the wiki, including many (such as Unused categories) that are not specifically helpful to administrators; "AdminLinks" attempts to link only to the administrator-specific ones
• "AdminLinks" can hold links to pages that are not special pages, such as the "Edit sidebar" page and documentation for various extensions
• Finally, the Admin Links extension puts a link to "AdminLinks" in administrators' personal tools, which makes things more convenient.

代码与下载

You can download the Admin Links code, in .zip format, here.

您也可以直接从MediaWiki源代码库通过Git下载代码。 From a command line, you can call the following:

git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/AdminLinks.git

To view the code online, including version history for each file, go here: phab:diffusion/EADL/browse/master/

安裝

• 下载文件，并将其放置在您extensions/文件夹中的AdminLinks目录内。
  开发者和代码贡献人员应从Git安装扩展，输入：cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/AdminLinks
• 将下列代码放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'AdminLinks' );
  

• Configure as required.
•  完成 – 在您的wiki上导航至Special:Version，以验证已成功安装扩展。

配置

If you want to have the members of groups other than 'sysop' see a link to the AdminLinks page among their navigation links, you can also add lines like the following after it:

$wgGroupPermissions['my-group']['adminlinks'] = true;

By default, links are separated by an interpunct (·) You can change this via the global variable $wgAdminLinksDelimiter; for example, to have links separated by a pipe, add the following:

$wgAdminLinksDelimiter = '|';

作者

Admin Links was written by Yaron Koren, reachable at yaron57@gmail.com.

版本历史

Admin Links is currently at version 0.6.2.

The version history is:

• 0.1 (2009-05-13) - Initial version
• 0.1.1 (2009-06-02) - Support for many languages added
• 0.1.2 (2009-09-09) - Support for many more languages added
• 0.1.3 (2010-07-12) - More links added; some section headers renamed
• 0.1.4 (2011-02-22) - Handling improved for MW 1.16+; link to Special:ListFiles added
• 0.1.5 (2011-10-10) - Handling improved for MW 1.17+; link to Special:Log added
• 0.1.6 (2012-01-06) - Support removed for MW < 1.16
• 0.1.7 (2012-11-12) - Handling improved for MW 1.18+; support removed for MW < 1.18
• 0.1.8 (2013-05-01) - Fix for ALItem::newFromPage()
• 0.2 (2014-05-30) - i18n messages moved into JSON files; grouping added for Special:AdminLinks within Special:SpecialPages
• 0.2.1 (2015-01-20) - Minor code fixes
• 0.2.2 (2015-06-24) - Support for Composer added; handling improved for MW 1.21+
• 0.2.3 (2016-06-07) - Fix for nonexistent special pages; support removed for MW < 1.23
• 0.3 (2018-05-24) - extension.json added
• 0.3.1 (2018-05-31) - Re-added accidentally-removed support for MW < 1.28; dedicated link to Special:CreateAccount added
• 0.4 (2020-01-16) - AdminLinks.php removed; support removed for MW < 1.28; link escaping improved
• 0.4.1 (2020-06-22) - Handling improved for MW 1.32+
• 0.4.2 (2021-06-08) - Handling improved for MW 1.35+
• 0.5 (2022-02-07) - Support removed for MW < 1.32; coding improvements
• 0.6 (2023-01-27) - Support removed for MW < 1.35; $wgAdminLinksDelimiter setting added; coding improvements
• 0.6.1 (2023-03-28) - Fix for display within Chameleon skin
• 0.6.2 (2023-08-21) - Updated hook handling; support removed for PHP 7.3

The Admin Links API

In order for an extension to add links and sections to the AdminLinks page, it must define a new function, and register it with the "AdminLinks" hook. See the AdminLinks hook manual for more info.

Extensions that use Admin Links

A number of extensions and skins add links to the Admin Links page, if installed. See Category:AdminLinks extensions for the current list.

Contributing to the project

Bugs and feature requests

Send any bug reports and requests to Yaron Koren, at yaron57@gmail.com.

Contributing patches to the project

If you found some bug and fixed it, or if you wrote code for a new feature, please create a patch by going to the "AdminLinks" directory, and typing:

git diff > descriptivename.patch

Then send this patch, with a description, to Yaron Koren.