SpecialMostLinkedCategories.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Html\Html;
use MediaWiki\Language\ILanguageConverter;
use MediaWiki\Language\LanguageConverterFactory;
use MediaWiki\Linker\Linker;
use MediaWiki\Page\LinkBatchFactory;
use MediaWiki\Skin\Skin;
use MediaWiki\SpecialPage\QueryPage;
use MediaWiki\Title\Title;
use stdClass;
use Wikimedia\HtmlArmor\HtmlArmor;
use Wikimedia\Rdbms\IConnectionProvider;
use Wikimedia\Rdbms\IReadableDatabase;
use Wikimedia\Rdbms\IResultWrapper;
 
class SpecialMostLinkedCategories extends QueryPage {
 
    private readonly ILanguageConverter $languageConverter;
 
    public function __construct(
        IConnectionProvider $dbProvider,
        LinkBatchFactory $linkBatchFactory,
        LanguageConverterFactory $languageConverterFactory,
    ) {
        parent::__construct( 'Mostlinkedcategories' );
        $this->setDatabaseProvider( $dbProvider );
        $this->setLinkBatchFactory( $linkBatchFactory );
        $this->languageConverter = $languageConverterFactory->getLanguageConverter( $this->getContentLanguage() );
    }
 
    public function isSyndicated() {
        return false;
    }
 
    public function getQueryInfo() {
        $dbr = $this->getDatabaseProvider()->getReplicaDatabase();
        return [
            'tables' => [ 'category' ],
            'fields' => [ 'title' => 'cat_title',
                'namespace' => NS_CATEGORY,
                'value' => 'cat_pages' ],
            'conds' => [ $dbr->expr( 'cat_pages', '>', 0 ) ],
        ];
    }
 
    protected function sortDescending() {
        return true;
    }
 
    public function preprocessResults( $db, $res ) {
        $this->executeLBFromResultWrapper( $res );
    }
 
    public function formatResult( $skin, $result ) {
        $nt = Title::makeTitleSafe( NS_CATEGORY, $result->title );
        if ( !$nt ) {
            return Html::element(
                'span',
                [ 'class' => 'mw-invalidtitle' ],
                Linker::getInvalidTitleDescription(
                    $this->getContext(),
                    NS_CATEGORY,
                    $result->title )
            );
        }
 
        $text = $this->languageConverter->convertHtml( $nt->getText() );
 
        $plink = $this->getLinkRenderer()->makeLink( $nt, new HtmlArmor( $text ) );
        $nlinks = $this->msg( 'nmembers' )->numParams( $result->value )->escaped();
 
        return $this->getLanguage()->specialList( $plink, $nlinks );
    }
 
    protected function getGroupName() {
        return 'highuse';
    }
}
class_alias( SpecialMostLinkedCategories::class, 'SpecialMostLinkedCategories' );