Manual:Extension registration/Migration/ja



拡張機能開発者向けの移行手順


名前空間ID
MediaWikiのバージョン1.30以降では、拡張機能を読み込む前に  でそれぞれの定数を定義することにより   で定義された名前空間IDをローカルで上書きできます. 例えば、 のファイルで以下の名前空間宣言を行うことを検討してください:

これにより、既定で定数 NS_FOO が値 1212 で定義されることになります. ただし、LocalSettings.php 内で対応する定数を定義することでこれを上書きできます:

これにより、「Foo」名前空間が 1212 ではなく 6688 の ID で登録されます. 名前空間の ID をオーバーライドする際は、すべてのトーク名前空間が奇数の ID を持つ必要があり、トーク名前空間の ID は常に (トークページに紐づく) 対象名前空間の ID に 1 を加えたものでなければならないことを忘れないでください.


 * extension registration wall of sadness (現在は wall of superpowers) も参照してください. 

スクリプト  は、PHP エントリー ポイントから JSON メタデータ ファイルへの移行を支援します. あなたの拡張機能が MediaWiki の古いバージョンをサポートしている場合、それらの古いバージョンのサポートを終了するまで、PHP エントリー ポイント  を保持すべきです.

コマンド ラインの例:

定数や関数を再定義できないというエラーが出た場合、 から拡張機能をアンインストールする必要があるかもしれません. アップグレード プロセス中にウィキを壊さないようにするために、PHP エントリ ポイント ファイル (FooBar.php) を以下のようなものに置き換えるべきです.

外装の場合は以下の通り:



説明文書の保持
通常、PHP エントリー ポイントには有用な設定の説明文書があり、失われてはなりません. 残念ながら、JSON はコメントをサポートしていません. 設定の説明文書を拡張機能のリポジトリ内の  ファイルに移行することをお勧めします. また、Extension:MyExtension のページ内で設定に関する解説をすべきです. ファイルにも一部の説明文書を直接含められます. 拡張機能の登録では、JSON ファイルのトップレベル構造で ' ' から始まるキーを無視するため、JSON ファイルのそれらの部分にコメントを記述できます. 例:

Version 1 of the  format also allowed   in   section, but this is no longer recommended or supported in version 2. field of the config variable should be used instead.

This should only be used for brief notes and comments.