Magic words are strings of text that MediaWiki links to specific functions or return values, such as current date and time, page titles, site information, and more. They can be thought of as special commands or variables that allow dynamic content generation and interaction with the MediaWiki software during page rendering.

From a technical standpoint, magic words map a range of wiki text strings to a unique internal identifier (ID), which is then associated with a particular function. This ID directs MediaWiki to execute a corresponding operation or return a specific value. Both variables (which output dynamic values) and parser functions (which perform operations or conditional logic) make use of this mapping technique.

उस ID पर मानचित्रित सभी टेक्स्ट को फ़ंक्शन के लौटाए वैल्यू से बदल दिया जाएगा। टेक्स्ट स्ट्रिंग्स और ID के बीच का मानचित्रण $wgExtensionMessagesFiles की मदद से लोड किए जाने वाले एक फ़ाइल के $magicWords वेरिएबल में रखा जाता है।

डिफ़ॉल्ट जादुई शब्द CoreParserFunctions.php में लागू किए जाते हैं।

जादुई शब्द कैसे काम करते हैं

जब भी मीडियाविकि को दो धनुकोष्ठकों ({{XXX ...}}) के अंदर टेक्स्ट मिलती है, इसे तय करना होगा कि XXX वेरिएबल होगी, पार्सर फ़ंक्शन होगी, या कोई साँचा होगा। ऐसा करने के लिए यह कुछ प्रश्न पूछता है।

1. क्या इसका कोई संबद्ध जादुई शब्द ID है? {{XXX...}} मार्कअप रूप को सुलझाने के पहले चरण पर मीडियाविकि 'XXX' को एक जादुई शब्द ID में बदलने की कोशिश करता है। अनुवाद टेबल को $magicWords से परिभाषित किया जाता है।
   • अगर 'XXX' से कोई जादुई शब्द ID संबद्ध नहीं होता है, 'XXX' को एक साँचा मान लिया जाता है।

   
   

2. क्या यह एक वेरिएबल है? अगर जादुई शब्द ID मिल जाती है, मीडियाविकि जाँचता है कि इसमें कोई पैरामीटर है कि नहीं।
   • अगर कोई पैरामीटर नहीं मिलते, मीडियाविकि जाँचता है कि जादुई शब्द ID को एक वेरिएबल ID के रूप में घोषित किया गया है कि नहीं। इसे जाँचने के लिए यह MagicWord::getVariableIDs() कॉल करके जादुई शब्द सेवाओं की सूची प्राप्त करता है। इस विधि में वेरिएबल ID, वेरिएबल ID-ओं की एक ठोस सूची (Help:Variables देखें) और MagicWordwgVariableIDs हुक से जुड़े सभी फ़ंक्शन्स द्वारा प्रदत्त अनुकूलित वेरिएबल ID-ओं की सूची से प्राप्त किए जाते हैं।
     • अगर जादुई शब्द ID को एक वेरिएबल के रूप में वर्गीकृत किया गया है, वेरिएबल के नाम से संबद्ध वैल्यू प्राप्त करने के लिए मीडियाविकि ParserGetVariableValueSwitch फ़ंक्शन को कॉल करता है।

   
   

3. क्या यह एक पार्सर फ़ंक्शन है? अगर कोई पैरामीटर हैं या फिर जादुई शब्द ID वेरिएबल जादुई शब्द ID-ओं की सूची में मौजूद नहीं है, मीडियाविकि मान लेता है कि जादुई शब्द एक पार्सर फ़ंक्शन या साँचा है। अगर जादुई शब्द ID $wgParser->setFunctionHook($magicWordId, $renderingFunctionName) से घोषित पार्सर फ़ंक्शन्स की सूची में मिल जाती है, इसे एक पार्सर फ़ंक्शन माना जाता है और $renderingFunctionName नामक फ़ंक्शन से रेंडर किया जाता है। वरना इसे साँचा मान लिया जाता है। If the magic word ID is found in the list of declared parser functions, it is treated as a parser function and rendered using the function named $renderingFunctionName. Otherwise, it is presumed to be a template.

जादुई शब्द परिभाषित करना

ताकि जादुई शब्द अपना जादू दिखा सके, हमें दो चीज़ें परिभाषित करनी होंगी:

• विकिटेक्स्ट और जादुई शब्द ID के बीच मानचित्रण
• जादुई शब्द ID और उस जादुई शब्द का विवेचन करने वाले किसी PHP फ़ंक्शन के बीच मानचित्रण।

<?php

$magicWords = [];

$magicWords['en'] = [
	'MAG_CUSTOM' => [ 0, 'custom' ],
];

$magicWords['es'] = [
	'MAG_CUSTOM' => [ 0, 'personalizado' ],
];

"ExtensionMessagesFiles": {
	"ExampleMagic": "Example.i18n.magic.php"
}

$contentLanguage = MediaWiki\MediaWikiServices::getInstance()->getContentLanguage();
$contentLanguage->mMagicExtensions['wikicodeToHtml'] = ['MAG_CUSTOM', 'custom'];

स्वभाव बदलाव (दो अंडरस्कोर वाले जादुई शब्द)

स्वभाव बदलाव जादुई शब्दों के एक विशिष्ट प्रकार हैं। इन्हें उनके दो अंडरस्कोर्स के (न कि दो धनुकोष्ठकों के) उपयोग से पहचाना जा सकता है। उदाहरण: __NOTOC__

ये जादुई शब्द आम तौर पर कोई सामग्री आउटपुट नहीं करते, मगर किसी पृष्ठ का स्वभाव बदलते हैं और/या पृष्ठ पर कोई गुणधर्म सेट करते हैं। इन जादुई शब्दों को MagicWordFactory::mDoubleUnderscoreIDs पर और Help:जादुई शब्द#स्वभाव बदलाव पर सूचीबद्ध किया गया है। ज़्यादातर मानक स्वभाव बदलावों के प्रभावों को Parser::handleDoubleUnderscore() में परिभाषित किया गया है। अगर कोई विशिष्ट प्रभाव परिभाषित नहीं किया जाता है, जादुई शब्द page_props टेबल पर पृष्ठ का एक गुणधर्म जोड़ देगा। इसे जाँचने के लिए यह जाँचा जा सकता है कि $parser->getOutput()->getPageProperty( 'MAGIC_WORD' ) null है या खाली स्ट्रिंग

{
	"name": "MyExt",
	"type": "parserhook",
    "AutoloadNamespaces": {
		"MediaWiki\\Extension\\MyExt\\": "includes/"
	},
	"Hooks": {
		"GetDoubleUnderscoreIDs": "main",
		"ParserAfterParse": "main" 
	},
	"HookHandlers": {
		"main": {
			"class": "MediaWiki\\Extension\\MyExt\\Hooks"
		}
	},
	"ExtensionMessagesFiles": {
		"MyExtMagic": "MyExt.i18n.magic.php"
	},
	"manifest_version": 2
}

<?php
$magicWords = [];
$magicWords['en'] = [
	'MAG_CUSTOM' => [ 0, '__CUSTOM__' ],
];

<?php

namespace MediaWiki\Extension\MyExt;

use MediaWiki\Hook\GetDoubleUnderscoreIDsHook;
use MediaWiki\Hook\ParserAfterParserHook;
use MediaWiki\Parser\Parser;
use MediaWiki\Parser\StripState;

class Hooks implements GetDoubleUnderscoreIDsHook, ParserAfterParseHook {
	/**
	 * @param string[] &$doubleUnderscoreIDs
	 * @return bool|void
	 */
	public function onGetDoubleUnderscoreIDs( &$ids ) {
		$ids[] = 'MAG_CUSTOM';
	}

	/**
	 * @param Parser $parser
	 * @param string &$text
	 * @param StripState $stripState
	 * @return bool|void
	 */
	public function onParserAfterParse( $parser, &$text, $stripState ) {
		if ( $parser->getOutput()->getPageProperty( 'MAG_CUSTOM' ) !== null ) {
			// Do behavior switching here ...
			// e.g. If you wanted to add some JS, you would do $parser->getOutput()->addModules( [ 'moduleName' ] );
		}
	}
}

ये भी देखें

• Help:Magic words - {{PAGENAME}} और {{SERVER}} जैसे वेरिएबलों की सूची
• Manual:MagicWord.php