Manual:Extensions/ja

拡張機能は、MediaWiki の外観や動作をカスタマイズできるようにします.


 * ウィキの利用者は、拡張機能を閲覧できます.
 * 管理者であれば MediaWiki 上の拡張機能を管理することができ、インストール、あるいは削除を行うことができます.
 * 開発者は、新しい拡張機能の作成、改善・保守ができます.

拡張機能には、MediaWiki の開発者によって保守されているものもありますが、サードパーティーの開発者によって書かれたものもあります. その結果、拡張機能の多くがバグを有し、相互に互換性があることを保証されているわけではありません. 一部のものはメンテナンスがされていません. したがって、すべての拡張機能が、MediaWikiのすべてのバージョンで動作するわけではありません. どの拡張機能であっても、特に安全ではないというタグが付けられたものについては、自己責任で使用して下さい. コアソフトウェアにパッチを適用する必要がある拡張機能を使う場合、データベースのバックアップをとるようにしてください. これはウィキが壊れてしまうリスクを回避するのに役立ちます.



拡張機能の種類


拡張機能の参照
では、これまで書かれたあらゆる種類の拡張機能を閲覧することができます. これらの拡張機能をインストールしたり、独自に拡張機能を作ったりするための情報については、下記をご覧下さい.



インストールされた拡張機能の確認
MediaWikiに拡張機能をインストールできるのは、サーバのファイルシステム（データベースを含む場合も多い）にアクセスできる管理者に限られますが、誰でも Special:Version ページにアクセスすることで、MediaWikiのインスタンスでどの拡張機能がアクティブになっているかを確認することができます. たとえば、ここにあげている拡張機能は、英語版ウィキペディアでは有効です.

Popular extensions
There are a number of ways of finding popular extensions.

The first set is those that are bundled with MediaWiki (a list that is reviewed regularly, and to which anyone can suggested an addition).

Extensions that are downloaded from MediaWiki.org via the ExtensionDistributor mechanism have some statistics gathered. The top 15 most downloaded extensions are listed at Special:ExtensionDistributor, and applicable extensions have their download count shown in their infobox. Note that these numbers do not account for alternate ways of installing extensions, such as via Git or Composer.

A third option is to look at WikiApiary's counts of wikis that extensions are installed on. This has the advantage of representing actual installations and not just downloads (i.e. it queries the wiki's APIs), but it is also (as of 2023) not completely up to date. It also doesn't count installations on private wikis.



拡張機能のインストール
MediaWiki はインストールが終わった直後に既に拡張機能を受け入れる用意ができています. 拡張機能を追加するために以下のステップに従います:


 * 1) 始める前に
 * いくつかの拡張機能はパッチのインストールが要求されます. それらの多くはunixコマンドの使用によるインストールのために設計された手引きを提供しています. 拡張機能ヘルプページにリスト表示されたこれらのコマンドを入力するためにシェルアクセス(SSH)の権限が要求されることもあります.
 * 1) 拡張機能をダウンロードする. 
 * Extension Distributorは、よく用いられている拡張機能を選び、ダウンロードする手助けをしてくれます.
 * 通常、拡張機能はモジュール パッケージとして配布されます. それらは一般的に   の独自の下位ディレクトリに入ります.   ウィキメディアの Git リポジトリに保存された拡張機能の一覧は git:mediawiki/extensions にあります.  拡張機能の中には、履歴管理をしていないものがあり、使用は推奨されません.
 * 拡張機能のなかにはbundles、、package repositoriesで利用可能なものもあります.
 * 1) 拡張機能をインストール.
 * ファイルの末尾に、以下を追加します:
 * この行はPHPインタプリタに拡張機能ファイルを読み込むことを強制し、その結果MediaWikiにアクセス可能にします.
 * 拡張機能の中には、メンテナンススクリプトと衝突するものもあります. 例えば $_SERVER に直接アクセスする（非推奨）場合です.
 * この場合、メンテナンススクリプトが動作するように、条件文で包むことができます.
 * 上記の条件文の中で加えられる特別な名前空間を必要とするすべての拡張機能に対して、メンテナンススクリプト は失敗します. そのような拡張機能は、例えば  や  です.
 * 上記の条件文の中で加えられる特別な名前空間を必要とするすべての拡張機能に対して、メンテナンススクリプト は失敗します. そのような拡張機能は、例えば  や  です.
 * 上記の条件文の中で加えられる特別な名前空間を必要とするすべての拡張機能に対して、メンテナンススクリプト は失敗します. そのような拡張機能は、例えば  や  です.



拡張機能のアップグレード
拡張機能のなかには、複数のバージョンで動作するものもありますが、MediaWikiの更新ごとにアップデートしなければならないものもあります. 拡張機能を新しいバージョンにアップグレードするためには：


 * 1) 新しいバージョンの拡張機能をダウンロードします.
 * 2)  ディレクトリにある拡張機能のすべてのファイルを、新しいファイルに置き換えます.  LocalSettings.phpにある拡張機能の設定は、削除しないで下さい.
 * 3) 拡張機能が MediaWiki データベースの変更を必要とする場合、メンテナンス スクリプトの を実行する必要があるかもしれません.  ほとんどの拡張機能は、このスクリプトを実行する必要があるかどうかについて言及しています.  (スクリプト実行前にデータのバックアップを取ってください).  もしコマンドラインにアクセスできない場合には、web updaterを使うこともできます.



拡張機能のアンインストール
アンインストールするには、拡張機能の名前が書かれた行を LocalSettings.php から削除してください.


 * 拡張機能の設定に関係する行はすべて削除する必要があります.



関連項目

 * - 拡張機能の翻訳に関する情報.
 * Special:ExtensionDistributor - Includes a list of the 15 most downloaded extensions in Wikimedia version control
 * - 拡張機能の翻訳に関する情報.
 * Special:ExtensionDistributor - Includes a list of the 15 most downloaded extensions in Wikimedia version control
 * Special:ExtensionDistributor - Includes a list of the 15 most downloaded extensions in Wikimedia version control