2020-03-03 22:50:34 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace MediaWiki\Hook;
|
|
|
|
|
|
2020-03-16 23:31:05 +00:00
|
|
|
use Parser;
|
|
|
|
|
use PPFrame;
|
|
|
|
|
|
2020-03-03 22:50:34 +00:00
|
|
|
/**
|
2020-09-26 13:18:43 +00:00
|
|
|
* This is a hook handler interface, see docs/Hooks.md.
|
|
|
|
|
* Use the hook name "ParserGetVariableValueSwitch" to register handlers implementing this interface.
|
|
|
|
|
*
|
2020-07-13 09:05:49 +00:00
|
|
|
* @stable to implement
|
2020-03-03 22:50:34 +00:00
|
|
|
* @ingroup Hooks
|
|
|
|
|
*/
|
|
|
|
|
interface ParserGetVariableValueSwitchHook {
|
|
|
|
|
/**
|
2020-03-16 23:31:05 +00:00
|
|
|
* This hook is called when the parser needs the value of a
|
|
|
|
|
* custom magic word.
|
2020-03-03 22:50:34 +00:00
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
*
|
2020-03-16 23:31:05 +00:00
|
|
|
* @param Parser $parser
|
|
|
|
|
* @param array &$variableCache Array to cache the value; when you return
|
2020-03-03 22:50:34 +00:00
|
|
|
* $variableCache[$magicWordId] should be the same as $ret
|
2020-03-16 23:31:05 +00:00
|
|
|
* @param string $magicWordId Index of the magic word (hook should not mutate it!)
|
|
|
|
|
* @param string &$ret Value of the magic word (the hook should set it)
|
|
|
|
|
* @param PPFrame $frame PPFrame object to use for expanding any template variables
|
2020-03-03 22:50:34 +00:00
|
|
|
* @return bool|void True or no return value to continue or false to abort
|
|
|
|
|
*/
|
|
|
|
|
public function onParserGetVariableValueSwitch( $parser, &$variableCache,
|
|
|
|
|
$magicWordId, &$ret, $frame
|
|
|
|
|
);
|
|
|
|
|
}
|