Manual:Magic words/ja

タグの拡張機能

パーサー関数

フック

特別ページ

スキン

マジックワード

マジックワードはwikitextで使用されるフレーズです。いくつかの配列で定義されます:

• $magicWords (includes/MagicWord.php)は内部名('MAG_XXX')を含みます。
• $wgVariableIDs (includes/MagicWord.php)は内部名がID(MAG_XXXは定数)を含み、後で内部名が"define()"のために使用されます。
• ローカライズ配列(languages/LanguageXX.php)はユーザによって使用される異なる名前を含みます。

ローカライズ配列キーは内部IDで値は配列で、大文字と小文字の区別とエイリアスフォームを含みます。定義された最初のフォームはプログラムによって使用されます。例えばページを移動させるとき、古い名前は#REDIRECTを含みます。

新しいマジックワードを追加する

いくつかのフックを使用するために新しいマジックワードを定義することが出来ます:

• "MagicWordMagicWords"は内部名('MAG_XXX')を$magicWordsに追加するために使用されます。
• "MagicWordwgVariableIDs"はID(MAG_XXX定数)を$wgVariableIDsに追加するために使用されます。
• "LanguageGetMagic"は異なる名前のマジックワードを追加するために使用されます。ローカライズされた名前と英語の両方を使用します。$langCodeパラメータによって言語コードを取得します;

例です:

$wgHooks['MagicWordMagicWords'][] = 'wfAddCustomMagicWord';
$wgHooks['MagicWordwgVariableIDs'][] = 'wfAddCustomMagicWordID';
$wgHooks['LanguageGetMagic'][] = 'wfAddCustomMagicWordLang';
 
function wfAddCustomMagicWord( &$magicWords ) {
        $magicWords[] = 'MAG_CUSTOM';
        return true;
}
 
function wfAddCustomMagicWordID( &$magicWords ) {
        $magicWords[] = MAG_CUSTOM;
        return true;
}
 
function wfAddCustomMagicWordLang( &$magicWords, $langCode ) {
        switch ( $langCode ) {
                case 'es':
                        $magicWords[MAG_CUSTOM] = array( 0, "#aduanero", "#custom" );
                        break;
                default:
                        $magicWords[MAG_CUSTOM] = array( 0, "#custom" );
        }
        return true;
}

関連項目

• m:Help:Magic words
• Extension:Variables - {{CURRENTUSER}}のような新しい変数を追加するためにParserGetVariableValueSwitchをどのように使用するのか説明しています