Extension: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".

Admin Links provides a hook and an API for other extensions to be able to add their own links and sections to the page.

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

MediaWiki already provides a "Special:SpecialPages" page, which lists the special pages for all the extensions installed on the wiki, which may lead you to wonder what the need is for the additional "AdminLinks" page. However, there are a number of important differences that make "AdminLinks" useful:

• "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.

You can also download the code directly via Git from the MediaWiki source code repository. From a command line, you can call the following:

gitclonehttps://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/

• Download and move the extracted AdminLinks folder to your extensions/ directory.
  Developers and code contributors should install the extension from Git instead, using:

  cdextensions/
  gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/AdminLinks
  

• Add the following code at the bottom of your LocalSettings.php file:

  wfLoadExtension( 'AdminLinks' );
  

• Configure as required.
• Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

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.7.1.

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
  • 0.6.3 (2024年08月27日) - Ignore, instead of displaying error for, nonexistent special pages; added "data-row-name" CSS attribute for each row
• 0.7 (2025年04月11日) - Support removed for MW < 1.41; handling improved for MW 1.44+
  • 0.7.1 (2025年09月25日) - Handling further improved for MW 1.44+; added icon for Admin Links link in user actions dropdown

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.

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

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

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:

gitdiff>descriptivename.patch

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

• Stable extensions
• Special page extensions
• Hook extensions
• API extensions
• GPL licensed extensions
• Extensions in Wikimedia version control
• Extensions which add rights
• SkinTemplateNavigation::Universal extensions
• All extensions
• Extensions included in Canasta
• Extensions included in Miraheze
• Extensions included in MyWikis
• Extensions included in Open CSP
• Extensions included in ProWiki
• Extensions included in semantic::core
• Extensions included in WikiForge

• Extensions without an image
• Extensions with master compatibility policy
• Extensions with manual MediaWiki version