Jump to content

Extension:Admin Links

From mediawiki.org
This page is a translated version of the page Extension:Admin Links and the translation is 100% complete.
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 以降
ダウンロード
README
The "Admin links" page for Discourse DB
  • $wgAdminLinksDelimiter
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' );
    
  • 必要に応じて設定します。
  • Yes 完了 – ウィキの「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


拡張機能が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に送ってください。