SpecialUnwatchedPages.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 SpecialUnwatchedPages extends QueryPage {
 
    private readonly ILanguageConverter $languageConverter;
 
    public function __construct(
        private readonly LinkBatchFactory $linkBatchFactory,
        IConnectionProvider $dbProvider,
        LanguageConverterFactory $languageConverterFactory
    ) {
        parent::__construct( 'Unwatchedpages', 'unwatchedpages' );
        $this->setDatabaseProvider( $dbProvider );
        $this->languageConverter = $languageConverterFactory->getLanguageConverter( $this->getContentLanguage() );
    }
 
    public function isExpensive() {
        return true;
    }
 
    public function isSyndicated() {
        return false;
    }
 
    public function preprocessResults( $db, $res ) {
        if ( !$res->numRows() ) {
            return;
        }
 
        $batch = $this->linkBatchFactory->newLinkBatch()->setCaller( __METHOD__ );
        foreach ( $res as $row ) {
            $batch->add( $row->namespace, $row->title );
        }
        $batch->execute();
 
        $res->seek( 0 );
    }
 
    public function getQueryInfo() {
        $dbr = $this->getDatabaseProvider()->getReplicaDatabase();
        return [
            'tables' => [ 'page', 'watchlist' ],
            'fields' => [
                'namespace' => 'page_namespace',
                'title' => 'page_title',
                'value' => 'page_namespace'
            ],
            'conds' => [
                'wl_title' => null,
                'page_is_redirect' => 0,
                $dbr->expr( 'page_namespace', '!=', NS_MEDIAWIKI ),
            ],
            'join_conds' => [ 'watchlist' => [
                'LEFT JOIN', [ 'wl_title = page_title',
                    'wl_namespace = page_namespace' ] ] ]
        ];
    }
 
    protected function sortDescending() {
        return false;
    }
 
    protected function getOrderFields() {
        return [ 'page_namespace', 'page_title' ];
    }
 
    public function execute( $par ) {
        parent::execute( $par );
        $this->getOutput()->addModules( 'mediawiki.special.unwatchedPages' );
        $this->addHelpLink( 'Help:Watchlist' );
    }
 
    public function formatResult( $skin, $result ) {
        $nt = Title::makeTitleSafe( $result->namespace, $result->title );
        if ( !$nt ) {
            return Html::element( 'span', [ 'class' => 'mw-invalidtitle' ],
                Linker::getInvalidTitleDescription( $this->getContext(), $result->namespace, $result->title ) );
        }
 
        $text = $this->languageConverter->convertHtml( $nt->getPrefixedText() );
 
        $linkRenderer = $this->getLinkRenderer();
 
        $plink = $linkRenderer->makeKnownLink( $nt, new HtmlArmor( $text ) );
        $wlink = $linkRenderer->makeKnownLink(
            $nt,
            $this->msg( 'watch' )->text(),
            [ 'class' => 'mw-watch-link' ],
            [ 'action' => 'watch' ]
        );
 
        return $this->getLanguage()->specialList( $plink, $wlink );
    }
 
    protected function getGroupName() {
        return 'maintenance';
    }
}
 
class_alias( SpecialUnwatchedPages::class, 'SpecialUnwatchedPages' );