1	<?php
2
3	namespace MediaWiki\Output\Hook;
4
5	use MediaWiki\Output\OutputPage;
6	use MediaWiki\Page\ProperPageIdentity;
7
8	/**
9	* This is a hook handler interface, see docs/Hooks.md.
10	* Use the hook name "OutputPageRenderCategoryLink" to register handlers implementing this interface.
11	*
12	* @stable to implement
13	* @ingroup Hooks
14	*/
15	interface OutputPageRenderCategoryLinkHook {
16	/**
17	* This hook is called when a category link is rendered.
18	*
19	* @since 1.43
20	*
21	* @param OutputPage $outputPage
22	* @param ProperPageIdentity $categoryTitle Category title
23	* @param string $text HTML escaped category name
24	* @param ?string &$link HTML of rendered category link which can be replaced by a different HTML
25	* @return void This hook must not abort, it must return no value
26	*/
27	public function onOutputPageRenderCategoryLink(
28	OutputPage $outputPage,
29	ProperPageIdentity $categoryTitle,
30	string $text,
31	?string &$link
32	): void;
33	}