Extension:Admin Links

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.3 (2024年8月)
互換性の方針	master は後方互換性を維持しています。
MediaWiki	1.35+
PHP	7.4+
データベースの変更	いいえ
ライセンス	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".

Admin Linksは、他の拡張機能が独自のリンクとセクションをページに追加できるようにするためのフックとAPIを提供します。

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

MediaWikiはすでに「特別:特別ページ一覧」を提供しています。このページには、Wikiにインストールされているすべての拡張機能の特別ページが一覧表示されます。これにより、追加の「AdminLinks」ページが必要かどうか疑問に思うかもしれません。 しかし、「AdminLinks」を便利にする重要な違いがいくつかあります。

• "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経由で直接コードをダウンロードすることもできます。 コマンドラインからは、次のように呼び出せます。

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

各ファイルのバージョン履歴を含むコードのオンライン閲覧はこちらから。 phab:diffusion/EADL/browse/master/

インストール

• ダウンロードして、ファイルをextensions/フォルダー内のAdminLinksという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/AdminLinks
• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'AdminLinks' );
  

• 必要に応じて設定します。
•  完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

設定

「sysop」以外のグループのメンバーに、ナビゲーションリンクの中にAdminLinksページへのリンクを表示させたい場合は、その後ろに以下のような行を追加することもできます。

$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.3.

バージョン履歴は

• 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

Admin Links API

拡張機能がAdminLinksページにリンクやセクションを追加するためには、新しい関数を定義し、それを "AdminLinks "フックに登録する必要があります。 See the AdminLinks hook manual for more info.

Admin Linksを使用する拡張機能

多くの拡張機能や外装がインストールされている場合、「管理者用リンク」ページにリンクが追加されます。 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:

git diff > descriptivename.patch

そして、このパッチを説明文と一緒にYaron Korenに送ってください。