wiki.techinc.nl/includes/parser/Hook/ParserModifyImageHTML.php
Tim Starling d7cb90dc5e Add a ParserModifyImageHTML hook for PageImages
PageImages is expensively loading and reparsing the lead section during
LinksUpdate because the parser's image link hooks do not give enough
context to tell whether the image is in the lead section.

So, add a hook which allows PageImages to add a marker to image links.
The marker can be associated with the section number in ParserAfterTidy.

Bug: T296895
Bug: T176520
Change-Id: I24528381e8d24ca8d138bceadb9397c83fd31356
2021-12-15 15:33:16 +11:00

30 lines
970 B
PHP

<?php
namespace MediaWiki\Hook;
use File;
use Parser;
/**
* This is a hook handler interface, see docs/Hooks.md.
* Use the hook name "ParserModifyImageHTML" to register handlers implementing this interface.
*
* @stable to implement
* @ingroup Hooks
*/
interface ParserModifyImageHTML {
/**
* This hook is called for each image added to parser output, with its
* associated HTML as returned from Linker::makeImageLink().
*
* @param Parser $parser
* @param File $file
* @param array $params An associative array of options that were used to generate the HTML.
* Like the one sent to onParserMakeImageParams. The 'handler' element contains handler
* options. The 'frame' element contains frame options. In the image gallery case, "frame"
* will be missing.
* @param string &$html The HTML of the image or image wrapper
*/
public function onParserModifyImageHTML( Parser $parser, File $file,
array $params, string &$html ): void;
}