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 ファイルのそれらの部分にコメントを記述できます. 例:

形式のバージョン 1 では、 の節内で   も許可されていましたが、バージョン 2 ではこれは推奨されておらず、サポートされていません. 構成変数の  フィールドを代わりに使用すべきです.

これは短いメモやコメントにのみ使用すべきです.



関連項目

 * Manual:Developing extensions#Setup の旧バージョン (2015年5月以前) および において、拡張機能情報を PHP コードおよび変数で宣言する古い方法について説明しています
 * Extension registration wall of superpowers! — どの拡張機能がまだ変換されていないかの要約情報.
 * — 拡張機能および外装を Git で使用するように変換するための追跡チケット.