2020-03-03 22:50:34 +00:00
|
|
|
<?php
|
|
|
|
|
|
|
|
|
|
namespace MediaWiki\Content\Hook;
|
|
|
|
|
|
2020-03-16 23:31:05 +00:00
|
|
|
use Content;
|
2023-12-14 19:20:33 +00:00
|
|
|
use MediaWiki\Parser\ParserOutput;
|
2023-03-01 20:33:26 +00:00
|
|
|
use MediaWiki\Title\Title;
|
2020-03-16 23:31:05 +00:00
|
|
|
|
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 "ContentAlterParserOutput" 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 ContentAlterParserOutputHook {
|
|
|
|
|
/**
|
2020-03-16 23:31:05 +00:00
|
|
|
* Use this hook to modify parser output for a given content object. This hook is called by
|
|
|
|
|
* Content::getParserOutput after parsing has finished. Can be used for changes that depend
|
|
|
|
|
* on the result of the parsing but have to be done before LinksUpdate is called (such as
|
|
|
|
|
* adding tracking categories based on the rendered HTML).
|
2020-03-03 22:50:34 +00:00
|
|
|
*
|
|
|
|
|
* @since 1.35
|
|
|
|
|
*
|
2020-03-16 23:31:05 +00:00
|
|
|
* @param Content $content Content to render
|
|
|
|
|
* @param Title $title Title of the page, as context
|
|
|
|
|
* @param ParserOutput $parserOutput ParserOutput to manipulate
|
2020-03-03 22:50:34 +00:00
|
|
|
* @return bool|void True or no return value to continue or false to abort
|
|
|
|
|
*/
|
|
|
|
|
public function onContentAlterParserOutput( $content, $title, $parserOutput );
|
|
|
|
|
}
|