Manual:拡張機能
拡張機能は、MediaWiki の外観や動作をカスタマイズできるようにします。
- ウィキの利用者は、拡張機能を閲覧できます。
- 管理者であれば MediaWiki 上の拡張機能を管理することができ、インストール、あるいは削除を行うことができます。
- 開発者は、新しい拡張機能の作成、改善・保守ができます。
拡張機能には、MediaWiki の開発者によって保守されているものもありますが、サードパーティーの開発者によって書かれたものもあります。 その結果、拡張機能の多くがバグを有し、相互に互換性があることを保証されているわけではありません。 一部のものはメンテナンスがされていません。したがって、すべての拡張機能が、MediaWikiのすべてのバージョンで動作するわけではありません。 どの拡張機能であっても、特に安全ではないというタグが付けられたものについては、自己責任で使用して下さい。 コアソフトウェアにパッチを適用する必要がある拡張機能を使う場合、データベースのバックアップをとるようにしてください。 これはウィキが壊れてしまうリスクを回避するのに役立ちます。
拡張機能の種類
パーサー タグ
パーサー関数
フック
特別ページ
外装
マジックワード
API
ページのコンテンツ モデル
認証
拡張機能の参照
カテゴリ:Extensions by category では、これまで書かれたあらゆる種類の拡張機能を閲覧することができます。 これらの拡張機能をインストールしたり、独自に拡張機能を作ったりするための情報については、下記をご覧下さい。
インストールされた拡張機能の確認
MediaWikiに拡張機能をインストールできるのは、サーバのファイルシステム(データベースを含む場合も多い)にアクセスできる管理者に限られますが、誰でも Special:Version ページにアクセスすることで、MediaWikiのインスタンスでどの拡張機能がアクティブになっているかを確認することができます。 たとえば、ここにあげている拡張機能は、英語版ウィキペディアでは有効です。
拡張機能のインストール
MediaWiki はインストールが終わった直後に既に拡張機能を受け入れる用意ができています。 拡張機能を追加するために以下のステップに従います:
- 始める前に
- いくつかの拡張機能はパッチのインストールが要求されます。それらの多くはunixコマンドの使用によるインストールのために設計された手引きを提供しています。 拡張機能ヘルプページにリスト表示されたこれらのコマンドを入力するためにシェルアクセス(SSH)の権限が要求されることもあります。
- 拡張機能をダウンロードする。
- Extension Distributorは、よく用いられている拡張機能を選び、ダウンロードする手助けをしてくれます。
- 通常、拡張機能はモジュール パッケージとして配布されます。 それらは一般的に
$IP /extensions/
の独自のサブディレクトリに入ります。 ウィキメディアの Git リポジトリに保存された拡張機能の一覧は git:mediawiki/extensions にあります。 拡張機能の中には、履歴管理をしていないものがあり、使用は推奨されません。 - 拡張機能のなかにはbundles、composer 、package repositoriesで利用可能なものもあります。
- 拡張機能をインストール.
LocalSettings.php
ファイルの末尾に、以下を追加します:wfLoadExtension( 'ExtensionName' );
- この行はPHPインタプリタに拡張機能ファイルを読み込むことを強制し、その結果MediaWikiにアクセス可能にします。
- 拡張機能の中には、メンテナンススクリプトと衝突するものもあります。例えば $_SERVER に直接アクセスする(非推奨)場合です。
- この場合、メンテナンススクリプトが動作するように、条件文で包むことができます。
if ( !$wgCommandLineMode ) {
wfLoadExtension ( 'ExtensionName' );
}
- 上記の条件文の中で加えられる特別な名前空間を必要とするすべての拡張機能に対して、メンテナンススクリプト importDump.php は失敗します。そのような拡張機能は、例えば Extension:Semantic MediaWiki や Extension:Page Forms です。
- 拡張機能用に必要な権限が設定されていることを確認してください!
- このインストール手順は、ほとんどの拡張機能にあてはまりますが、異なったインストール手順が必要なものもあります。 詳細は、拡張機能のドキュメントを確認して下さい。
- LocalSettings.php で設定の変数を変更したい場合は、通常は拡張機能のインクルードの後で行う必要があります。 そのようにしない場合、拡張機能内で定義されている既定値があなたの設定を上書きします。
拡張機能のアップグレード
拡張機能のなかには、複数のバージョンで動作するものもありますが、MediaWikiの更新ごとにアップデートしなければならないものもあります。 拡張機能を新しいバージョンにアップグレードするためには:
- 新しいバージョンの拡張機能をダウンロードします。
extension/ExtensionName
ディレクトリにある拡張機能のすべてのファイルを、新しいファイルに置き換えます。 LocalSettings.phpにある拡張機能の設定は、削除しないで下さい。- 拡張機能がMediaWikiデータベースの変更を必要とする場合、メンテナンススクリプトのUpdate.phpを実行する必要があるかもしれません。 ほとんどの拡張機能は、このスクリプトを実行する必要があるかどうかについて言及しています。 (スクリpト実行前にデー他のバックアップを取ってください)。 もしコマンドラインにアクセスできない場合には、web updaterを使うこともできます。
拡張機能のアンインストール
アンインストールするには、拡張機能の名前が書かれた行を LocalSettings.php から削除してください。
wfLoadExtension( 'ExtensionName' );
- 拡張機能の設定に関係する行はすべて削除する必要があります。
- 拡張機能がデータベースに対し何らかの変更を加えていた場合、update.php を実行してそれを元に戻してください。
関連項目
- カテゴリ:拡張機能
- Template:Extension
- Manual:拡張機能の開発
- Manual:拡張機能の翻訳 - 拡張機能の翻訳に関する情報。