categoryCache = $categoryCache; $this->config = $config; } /** * @param Parser $parser */ public function onParserFirstCallInit( $parser ) { if ( !$this->config->get( 'CategoryTreeAllowTag' ) ) { return; } $parser->setHook( 'categorytree', [ $this, 'parserHook' ] ); $parser->setFunctionHook( 'categorytree', [ $this, 'parserFunction' ] ); } /** * Entry point for the {{#categorytree}} tag parser function. * This is a wrapper around Hooks::parserHook * @param Parser $parser * @param string ...$params * @return array|string */ public function parserFunction( Parser $parser, ...$params ) { // first user-supplied parameter must be category name if ( !$params ) { // no category specified, return nothing return ''; } $cat = array_shift( $params ); // build associative arguments from flat parameter list $argv = []; foreach ( $params as $p ) { if ( preg_match( '/^\s*(\S.*?)\s*=\s*(.*?)\s*$/', $p, $m ) ) { $k = $m[1]; // strip any quotes enclosing the value $v = preg_replace( '/^"\s*(.*?)\s*"$/', '$1', $m[2] ); } else { $k = trim( $p ); $v = true; } $argv[$k] = $v; } if ( $parser->getOutputType() === Parser::OT_PREPROCESS ) { return Html::rawElement( 'categorytree', $argv, $cat ); } else { // now handle just like a tag $html = $this->parserHook( $cat, $argv, $parser ); return [ $html, 'noparse' => true, 'isHTML' => true ]; } } /** * Obtain a category sidebar link based on config * @return bool|string of link */ private function getCategorySidebarBox() { if ( !$this->config->get( 'CategoryTreeSidebarRoot' ) ) { return false; } return $this->parserHook( $this->config->get( 'CategoryTreeSidebarRoot' ), $this->config->get( 'CategoryTreeSidebarOptions' ) ); } /** * Hook implementation for injecting a category tree into the sidebar. * Only does anything if $wgCategoryTreeSidebarRoot is set to a category name. * @param Skin $skin * @param array &$sidebar */ public function onSkinBuildSidebar( $skin, &$sidebar ) { $html = $this->getCategorySidebarBox(); if ( $html ) { $sidebar['categorytree-portlet'] = []; CategoryTree::setHeaders( $skin->getOutput() ); } } /** * Hook implementation for injecting a category tree link into the sidebar. * Only does anything if $wgCategoryTreeSidebarRoot is set to a category name. * @param Skin $skin * @param string $portlet * @param string &$html */ public function onSkinAfterPortlet( $skin, $portlet, &$html ) { if ( $portlet === 'categorytree-portlet' ) { $box = $this->getCategorySidebarBox(); if ( $box ) { $html .= $box; } } } /** * Entry point for the tag parser hook. * This loads CategoryTreeFunctions.php and calls CategoryTree::getTag() * @param string $cat * @param array $argv * @param Parser|null $parser * @param PPFrame|null $frame * @param bool $allowMissing * @return bool|string */ public function parserHook( $cat, array $argv, Parser $parser = null, PPFrame $frame = null, $allowMissing = false ) { if ( $parser ) { # flag for use by Hooks::parserOutput $parser->getOutput()->setExtensionData( self::EXTENSION_DATA_FLAG, true ); } $ct = new CategoryTree( $argv ); $attr = Sanitizer::validateTagAttributes( $argv, 'div' ); $hideroot = isset( $argv['hideroot'] ) ? CategoryTree::decodeBoolean( $argv['hideroot'] ) : null; $onlyroot = isset( $argv['onlyroot'] ) ? CategoryTree::decodeBoolean( $argv['onlyroot'] ) : null; $depthArg = isset( $argv['depth'] ) ? (int)$argv['depth'] : null; $depth = CategoryTree::capDepth( $ct->getOption( 'mode' ), $depthArg ); if ( $onlyroot ) { $depth = 0; } return $ct->getTag( $parser, $cat, $hideroot, $attr, $depth, $allowMissing ); } /** * Hook callback that injects messages and things into the tag, * if needed in the current page. * Does nothing if self::EXTENSION_DATA_FLAG is not set on $parserOutput extension data. * @param OutputPage $outputPage * @param ParserOutput $parserOutput */ public function onOutputPageParserOutput( $outputPage, $parserOutput ): void { if ( $parserOutput->getExtensionData( self::EXTENSION_DATA_FLAG ) ) { CategoryTree::setHeaders( $outputPage ); } } /** * ArticleFromTitle hook, override category page handling * * @param Title $title * @param Article|null &$article Article (object) that will be returned * @param IContextSource $context * @return bool|void True or no return value to continue or false to abort */ public function onArticleFromTitle( $title, &$article, $context ) { if ( $title->getNamespace() === NS_CATEGORY ) { $article = new CategoryTreeCategoryPage( $title ); } } /** * OutputPageMakeCategoryLinks hook, override category links * @param OutputPage $out * @param array $categories * @param array &$links * @return bool */ public function onOutputPageMakeCategoryLinks( $out, $categories, &$links ) { if ( !$this->config->get( 'CategoryTreeHijackPageCategories' ) ) { // Not enabled, don't do anything return true; } $options = $this->config->get( 'CategoryTreePageCategoryOptions' ); foreach ( $categories as $category => $type ) { $links[$type][] = $this->parserHook( $category, $options, null, null, true ); } CategoryTree::setHeaders( $out ); return false; } /** * Get exported data for the "ext.categoryTree" ResourceLoader module. * * @internal For use in extension.json only. * @return array Data to be serialised as data.json */ public static function getDataForJs() { global $wgCategoryTreeCategoryPageOptions; // Look, this is pretty bad but CategoryTree is just whacky, it needs to be rewritten $ct = new CategoryTree( $wgCategoryTreeCategoryPageOptions ); return [ 'defaultCtOptions' => $ct->getOptionsAsJsStructure(), ]; } /** * Hook handler for the SpecialTrackingCategories::preprocess hook * @param SpecialPage $specialPage SpecialTrackingCategories object * @param array $trackingCategories [ 'msg' => LinkTarget, 'cats' => LinkTarget[] ] * @phan-param array $trackingCategories */ public function onSpecialTrackingCategories__preprocess( $specialPage, $trackingCategories ) { $categoryTargets = []; foreach ( $trackingCategories as $data ) { foreach ( $data['cats'] as $catTitle ) { $categoryTargets[] = $catTitle; } } $this->categoryCache->doQuery( $categoryTargets ); } /** * Hook handler for the SpecialTrackingCategories::generateCatLink hook * @param SpecialPage $specialPage SpecialTrackingCategories object * @param LinkTarget $catTitle LinkTarget object of the linked category * @param string &$html Result html */ public function onSpecialTrackingCategories__generateCatLink( $specialPage, $catTitle, &$html ) { $cat = $this->categoryCache->getCategory( $catTitle ); $html .= CategoryTree::createCountString( $specialPage->getContext(), $cat, 0 ); } }