SpecialListRedirects.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Html\Html;
use MediaWiki\Page\LinkBatchFactory;
use MediaWiki\Page\RedirectLookup;
use MediaWiki\Page\WikiPageFactory;
use MediaWiki\Skin\Skin;
use MediaWiki\SpecialPage\QueryPage;
use MediaWiki\Title\Title;
use stdClass;
use Wikimedia\Rdbms\IConnectionProvider;
use Wikimedia\Rdbms\IReadableDatabase;
use Wikimedia\Rdbms\IResultWrapper;
 
class SpecialListRedirects extends QueryPage {
 
    public function __construct(
        private readonly LinkBatchFactory $linkBatchFactory,
        IConnectionProvider $dbProvider,
        private readonly WikiPageFactory $wikiPageFactory,
        private readonly RedirectLookup $redirectLookup,
    ) {
        parent::__construct( 'Listredirects' );
        $this->setDatabaseProvider( $dbProvider );
    }
 
    public function isExpensive() {
        return true;
    }
 
    public function isSyndicated() {
        return false;
    }
 
    protected function sortDescending() {
        return false;
    }
 
    public function getQueryInfo() {
        return [
            'tables' => [ 'page', 'redirect' ],
            'fields' => [ 'namespace' => 'page_namespace',
                'title' => 'page_title',
                'rd_namespace',
                'rd_title',
                'rd_fragment',
                'rd_interwiki',
            ],
            'conds' => [ 'page_is_redirect' => 1 ],
            'join_conds' => [ 'redirect' => [
                'LEFT JOIN', 'rd_from=page_id' ],
            ]
        ];
    }
 
    protected function getOrderFields() {
        return [ 'page_namespace', 'page_title' ];
    }
 
    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 );
            $redirTarget = $this->getRedirectTarget( $row );
            if ( $redirTarget ) {
                $batch->addObj( $redirTarget );
            }
        }
        $batch->execute();
 
        // Back to start for display
        $res->seek( 0 );
    }
 
    protected function getRedirectTarget( stdClass $row ): ?Title {
        if ( isset( $row->rd_title ) ) {
            return Title::makeTitle(
                $row->rd_namespace,
                $row->rd_title,
                $row->rd_fragment,
                $row->rd_interwiki
            );
        } else {
            $title = Title::makeTitle( $row->namespace, $row->title );
            if ( !$title->canExist() ) {
                return null;
            }
 
            return Title::castFromLinkTarget(
                $this->redirectLookup->getRedirectTarget( $title )
            );
        }
    }
 
    public function formatResult( $skin, $result ) {
        $linkRenderer = $this->getLinkRenderer();
        # Make a link to the redirect itself
        $rd_title = Title::makeTitle( $result->namespace, $result->title );
        $rd_link = $linkRenderer->makeLink(
            $rd_title,
            null,
            [],
            [ 'redirect' => 'no' ]
        );
 
        # Find out where the redirect leads
        $target = $this->getRedirectTarget( $result );
        if ( $target ) {
            # Make a link to the destination page
            $lang = $this->getLanguage();
            $arr = $lang->getArrow();
            $rd_link = Html::rawElement( 'bdi', [ 'dir' => $lang->getDir() ], $rd_link );
            $targetLink = $linkRenderer->makeLink( $target, $target->getFullText() );
            $targetLink = Html::rawElement( 'bdi', [ 'dir' => $lang->getDir() ], $targetLink );
 
            return "$rd_link $arr $targetLink";
        } else {
            return "<del>$rd_link</del>";
        }
    }
 
    public function execute( $par ) {
        $this->addHelpLink( 'Help:Redirects' );
        parent::execute( $par );
    }
 
    protected function getGroupName() {
        return 'pages';
    }
}
 
class_alias( SpecialListRedirects::class, 'SpecialListRedirects' );