Manual:Hooks/ParserGetVariableValueSwitch

xxx

Details
ParserGetVariableValueSwitch is the hook responsible for assigning a value to custom variables. Whenever the parser sees a string like, it assumes that it represents one of three possible kinds of wiki markup: a template, a variable, or a parser function. If XXX is registered as a variable name, the parser runs the hooks assigned to ParserGetVariableValueSwitch until it finds one that can return a value for the variable.

To register XXX as a variable name, you must associate the string 'XXX' with a magic word id via $magicWords. A magic word id is just an internal identifier that groups together all wiki text names for a variable. To make this particular magic word id act like a variable (rather than a parser function or template), you also must add its associated magic word id to the list of custom variable ids via a MagicWordwgVariableIDs hook.

Usage

 * In MediaWiki 1.35, $magicWordId is no longer passed by reference.

ParserGetVariableValueSwitch is passed the magic word id in. If the hook knows how to assign a value to that particular id, it should assign the value to  and return. Never return  since this will lead to aborting all further calls to this hook.

Because the hook will be passed both ids it knows and those it doesn't, it should check the id before assigning any value to it. This is normally done in a switch statement, as illustrated in the example below: