SpecialTrackingCategories.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Category\TrackingCategories;
use MediaWiki\Html\Html;
use MediaWiki\Page\LinkBatchFactory;
use MediaWiki\SpecialPage\SpecialPage;
 
class SpecialTrackingCategories extends SpecialPage {
 
    public function __construct(
        private readonly LinkBatchFactory $linkBatchFactory,
        private readonly TrackingCategories $trackingCategories
    ) {
        parent::__construct( 'TrackingCategories' );
    }
 
    public function execute( $par ) {
        $this->setHeaders();
        $this->outputHeader();
        $this->addHelpLink( 'Help:Tracking categories' );
        $this->getOutput()->getMetadata()->setPreventClickjacking( false );
        $this->getOutput()->addModuleStyles( [
            'jquery.tablesorter.styles',
            'mediawiki.pager.styles'
        ] );
        $this->getOutput()->addModules( 'jquery.tablesorter' );
        $this->getOutput()->addHTML(
            Html::openElement( 'table', [ 'class' => [ 'mw-datatable', 'sortable' ],
                'id' => 'mw-trackingcategories-table' ] ) . "\n" .
            '<thead><tr>' .
            Html::element( 'th', [], $this->msg( 'trackingcategories-msg' )->text() ) .
            Html::element( 'th', [], $this->msg( 'trackingcategories-name' )->text() ) .
            Html::element( 'th', [], $this->msg( 'trackingcategories-desc' )->text() ) .
            '</tr></thead>'
        );
 
        $categoryList = $this->trackingCategories->getTrackingCategories();
 
        $batch = $this->linkBatchFactory->newLinkBatch()->setCaller( __METHOD__ );
        foreach ( $categoryList as $data ) {
            $batch->addObj( $data['msg'] );
            foreach ( $data['cats'] as $catTitle ) {
                $batch->addObj( $catTitle );
            }
        }
        $batch->execute();
 
        $this->getHookRunner()->onSpecialTrackingCategories__preprocess( $this, $categoryList );
 
        $linkRenderer = $this->getLinkRenderer();
 
        foreach ( $categoryList as $catMsg => $data ) {
            $allMsgs = [];
            $catDesc = $catMsg . '-desc';
 
            $catMsgTitleText = $linkRenderer->makeLink(
                $data['msg'],
                $catMsg
            );
 
            foreach ( $data['cats'] as $catTitle ) {
                $html = Html::rawElement( 'bdi', [ 'dir' => $this->getContentLanguage()->getDir() ],
                    $linkRenderer->makeLink(
                        $catTitle,
                        $catTitle->getText()
                    ) );
 
                $this->getHookRunner()->onSpecialTrackingCategories__generateCatLink(
                    $this, $catTitle, $html );
 
                $allMsgs[] = $html;
            }
 
            # Extra message, when no category was found
            if ( $allMsgs === [] ) {
                $allMsgs[] = $this->msg( 'trackingcategories-disabled' )->parse();
            }
 
            /*
             * Show category description if it exists as a system message
             * as category-name-desc
             */
            $descMsg = $this->msg( $catDesc );
            if ( $descMsg->isBlank() ) {
                $descMsg = $this->msg( 'trackingcategories-nodesc' );
            }
 
            $this->getOutput()->addHTML( Html::rawElement( 'tr', [],
                Html::rawElement( 'td', [ 'class' => 'mw-trackingcategories-name' ],
                    $this->getLanguage()->commaList( array_unique( $allMsgs ) )
                ) .
                Html::rawElement( 'td', [ 'class' => 'mw-trackingcategories-msg' ],
                    $catMsgTitleText
                ) .
                Html::rawElement( 'td', [ 'class' => 'mw-trackingcategories-desc' ],
                    $descMsg->parse()
                )
            ) );
        }
        $this->getOutput()->addHTML( Html::closeElement( 'table' ) );
    }
 
    protected function getGroupName() {
        return 'pages';
    }
}
 
class_alias( SpecialTrackingCategories::class, 'SpecialTrackingCategories' );