Manual:Extensions/ja

{| style="border: 2px solid #aaa; padding: 1em 2em; margin: 1em 0 2em 0; width:auto; margin:0 auto; float: " |

拡張機能とは
拡張機能とは、MediaWiki の外観や動作をカスタマイズさせるものです.

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

拡張機能をキーワードで検索:
 * style="textalign: center; valign: middle; padding: 0 2em" |


 * }

拡張機能は以下のように使われます:


 * 記事を書くのに使用されるウィキマークアップを拡張します - 例は と  を参照してください.
 * 新しい報告と管理上の機能を追加します - 例は を参照してください.
 * MediaWiki の見た目と使い心地を変更します - 例は Special:AllPages/Skin: および を参照してください.
 * カスタム認証メカニズムを使用してセキュリティを強化します - 例は を参照してください.

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

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

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

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


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


 * 上記の条件文の中で加えられる特別な名前空間を必要とするすべての拡張機能に対して、メンテナンススクリプト は失敗します. そのような拡張機能は、例えば  や  です.



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


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

拡張機能のアンインストール
拡張機能を追加するには、LocalSettings.phpに以下のような行を追加します.


 * 1) この行を削除すれば、拡張機能はアンインストールされます. もし望むならば、"extensions/"フォルダ内にあるその拡張機能のファイルを削除することができます（もしその拡張機能を将来的に使いたくないならば、削除してしまいましょう）.
 * 2) LocalSettings.php内には、削除したいと思っている拡張機能に関連する内容が恐らく他にも何行か書かれてあるはずです. 数行にわたる可能性が最も高く、拡張機能によって特定の利用者に対し、ページへのアクセスを承認する特定の権限が付与されます.  これらの行には「$wgGroupPermissions」変数が含まれ、そこで設定をいくつか行います.  除去した拡張機能によって付与された権限に関しては、これらの行も削除してかまいません.
 * 3) ご利用の拡張機能は、おそらくデータベースに欄を追加したと考えられます. 拡張機能の削除後にアップデータを実行すると、それらはmaintenance/update.phpによって除去されます.

拡張機能の開発
この話題は複雑なため、改めて拡張機能の開発のマニュアルページで扱います.

関連項目

 * Project:拡張機能の依頼
 * - 拡張機能の翻訳に関する情報.
 * Project:拡張機能の依頼
 * - 拡張機能の翻訳に関する情報.
 * Project:拡張機能の依頼
 * - 拡張機能の翻訳に関する情報.
 * Project:拡張機能の依頼
 * - 拡張機能の翻訳に関する情報.
 * - 拡張機能の翻訳に関する情報.