ProtectedPagesPager.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials\Pager;
 
use MediaWiki\CommentFormatter\RowCommentFormatter;
use MediaWiki\CommentStore\CommentStore;
use MediaWiki\Context\IContextSource;
use MediaWiki\Html\Html;
use MediaWiki\Linker\Linker;
use MediaWiki\Linker\LinkRenderer;
use MediaWiki\Logging\LogEventsList;
use MediaWiki\Logging\LogPage;
use MediaWiki\Page\LinkBatchFactory;
use MediaWiki\Pager\TablePager;
use MediaWiki\Title\Title;
use MediaWiki\User\UserIdentityValue;
use UnexpectedValueException;
use Wikimedia\Rdbms\FakeResultWrapper;
use Wikimedia\Rdbms\IConnectionProvider;
 
class ProtectedPagesPager extends TablePager {
 
    private string $type;
    private int $size;
 
    private array $formattedComments = [];
 
    public function __construct(
        IContextSource $context,
        private readonly CommentStore $commentStore,
        private readonly LinkBatchFactory $linkBatchFactory,
        LinkRenderer $linkRenderer,
        IConnectionProvider $dbProvider,
        private readonly RowCommentFormatter $rowCommentFormatter,
        ?string $type,
        private readonly ?string $level,
        private readonly ?int $namespace,
        private readonly ?string $sizetype,
        ?int $size,
        private readonly bool $indefonly,
        private readonly bool $cascadeonly,
        private readonly bool $noredirect,
    ) {
        // Set database before parent constructor to avoid setting it there
        $this->mDb = $dbProvider->getReplicaDatabase();
        parent::__construct( $context, $linkRenderer );
        $this->type = $type ?? 'edit';
        $this->size = $size ?? 0;
    }
 
    public function preprocessResults( $result ) {
        # Do a link batch query
        $lb = $this->linkBatchFactory->newLinkBatch();
        $rowsWithComments = [];
 
        foreach ( $result as $row ) {
            $lb->add( $row->page_namespace, $row->page_title );
            // for old protection rows, user and comment are missing
            if ( $row->actor_name !== null ) {
                $lb->addUser( new UserIdentityValue( $row->actor_user, $row->actor_name ) );
            }
            if ( $row->log_timestamp !== null ) {
                $rowsWithComments[] = $row;
            }
        }
 
        $lb->execute();
 
        // Format the comments
        $this->formattedComments = $this->rowCommentFormatter->formatRows(
            new FakeResultWrapper( $rowsWithComments ),
            'log_comment',
            null,
            null,
            'pr_id'
        );
    }
 
    protected function getFieldNames() {
        static $headers = null;
 
        if ( $headers === null ) {
            $headers = [
                'log_timestamp' => 'protectedpages-timestamp',
                'pr_page' => 'protectedpages-page',
                'pr_expiry' => 'protectedpages-expiry',
                'actor_user' => 'protectedpages-performer',
                'pr_params' => 'protectedpages-params',
                'log_comment' => 'protectedpages-reason',
            ];
            foreach ( $headers as $key => $val ) {
                $headers[$key] = $this->msg( $val )->text();
            }
        }
 
        return $headers;
    }
 
    public function formatValue( $field, $value ) {
        $row = $this->mCurrentRow;
        $linkRenderer = $this->getLinkRenderer();
 
        switch ( $field ) {
            case 'log_timestamp':
                // when timestamp is null, this is a old protection row
                if ( $value === null ) {
                    $formatted = Html::element( 'span',
                        [ 'class' => 'mw-protectedpages-unknown' ],
                        $this->msg( 'protectedpages-unknown-timestamp' )->text()
                    );
                } else {
                    $formatted = htmlspecialchars( $this->getLanguage()->userTimeAndDate(
                        $value, $this->getUser() ) );
                }
                break;
 
            case 'pr_page':
                $title = Title::makeTitleSafe( $row->page_namespace, $row->page_title );
                if ( !$title ) {
                    $formatted = Html::element(
                        'span',
                        [ 'class' => 'mw-invalidtitle' ],
                        Linker::getInvalidTitleDescription(
                            $this->getContext(),
                            $row->page_namespace,
                            $row->page_title
                        )
                    );
                } else {
                    $formatted = $linkRenderer->makeLink( $title );
                }
                $formatted = Html::rawElement( 'bdi', [
                    'dir' => $this->getLanguage()->getDir()
                ], $formatted );
                if ( $row->page_len !== null ) {
                    $formatted .= ' ' . Html::rawElement(
                            'span',
                            [ 'class' => 'mw-protectedpages-length' ],
                            Linker::formatRevisionSize( $row->page_len )
                        );
                }
                break;
 
            case 'pr_expiry':
                $formatted = htmlspecialchars( $this->getLanguage()->formatExpiry(
                    $value, /* User preference timezone */true, 'infinity', $this->getUser() ) );
                $title = Title::makeTitleSafe( $row->page_namespace, $row->page_title );
                if ( $title && $this->getAuthority()->isAllowed( 'protect' ) ) {
                    $changeProtection = $linkRenderer->makeKnownLink(
                        $title,
                        $this->msg( 'protect_change' )->text(),
                        [],
                        [ 'action' => 'unprotect' ]
                    );
                    $formatted .= ' ' . Html::rawElement(
                            'span',
                            [ 'class' => 'mw-protectedpages-actions' ],
                            $this->msg( 'parentheses' )->rawParams( $changeProtection )->escaped()
                        );
                }
                break;
 
            case 'actor_user':
                // when timestamp is null, this is a old protection row
                if ( $row->log_timestamp === null ) {
                    $formatted = Html::element( 'span',
                        [ 'class' => 'mw-protectedpages-unknown' ],
                        $this->msg( 'protectedpages-unknown-performer' )->text()
                    );
                } else {
                    $username = $row->actor_name;
                    if ( LogEventsList::userCanBitfield(
                        $row->log_deleted,
                        LogPage::DELETED_USER,
                        $this->getAuthority()
                    ) ) {
                        $formatted = Linker::userLink( (int)$value, $username )
                            . Linker::userToolLinks( (int)$value, $username );
                    } else {
                        $formatted = $this->msg( 'rev-deleted-user' )->escaped();
                    }
                    if ( LogEventsList::isDeleted( $row, LogPage::DELETED_USER ) ) {
                        $formatted = '<span class="history-deleted">' . $formatted . '</span>';
                    }
                }
                break;
 
            case 'pr_params':
                $params = [];
                // Messages: restriction-level-sysop, restriction-level-autoconfirmed
                $params[] = $this->msg( 'restriction-level-' . $row->pr_level )->escaped();
                if ( $row->pr_cascade ) {
                    $params[] = $this->msg( 'protect-summary-cascade' )->escaped();
                }
                $formatted = $this->getLanguage()->commaList( $params );
                break;
 
            case 'log_comment':
                // when timestamp is null, this is an old protection row
                if ( $row->log_timestamp === null ) {
                    $formatted = Html::element( 'span',
                        [ 'class' => 'mw-protectedpages-unknown' ],
                        $this->msg( 'protectedpages-unknown-reason' )->text()
                    );
                } else {
                    if ( LogEventsList::userCanBitfield(
                        $row->log_deleted,
                        LogPage::DELETED_COMMENT,
                        $this->getAuthority()
                    ) ) {
                        $formatted = $this->formattedComments[$row->pr_id];
                    } else {
                        $formatted = $this->msg( 'rev-deleted-comment' )->escaped();
                    }
                    if ( LogEventsList::isDeleted( $row, LogPage::DELETED_COMMENT ) ) {
                        $formatted = '<span class="history-deleted">' . $formatted . '</span>';
                    }
                }
                break;
 
            default:
                throw new UnexpectedValueException( "Unknown field '$field'" );
        }
 
        return $formatted;
    }
 
    public function getQueryInfo() {
        $dbr = $this->getDatabase();
        $conds = [
            $dbr->expr( 'pr_expiry', '>', $dbr->timestamp() )
                ->or( 'pr_expiry', '=', null ),
            'page_id=pr_page',
            $dbr->expr( 'pr_type', '=', $this->type ),
        ];
 
        if ( $this->sizetype == 'min' ) {
            $conds[] = 'page_len>=' . $this->size;
        } elseif ( $this->sizetype == 'max' ) {
            $conds[] = 'page_len<=' . $this->size;
        }
 
        if ( $this->indefonly ) {
            $conds['pr_expiry'] = [ $dbr->getInfinity(), null ];
        }
        if ( $this->cascadeonly ) {
            $conds['pr_cascade'] = 1;
        }
        if ( $this->noredirect ) {
            $conds['page_is_redirect'] = 0;
        }
 
        if ( $this->level ) {
            $conds[] = $dbr->expr( 'pr_level', '=', $this->level );
        }
        if ( $this->namespace !== null ) {
            $conds[] = $dbr->expr( 'page_namespace', '=', $this->namespace );
        }
 
        $commentQuery = $this->commentStore->getJoin( 'log_comment' );
 
        return [
            'tables' => [
                'page', 'page_restrictions', 'log_search',
                'logparen' => [ 'logging', 'actor' ] + $commentQuery['tables'],
            ],
            'fields' => [
                'pr_id',
                'page_namespace',
                'page_title',
                'page_len',
                'pr_type',
                'pr_level',
                'pr_expiry',
                'pr_cascade',
                'log_timestamp',
                'log_deleted',
                'actor_name',
                'actor_user'
            ] + $commentQuery['fields'],
            'conds' => $conds,
            'join_conds' => [
                'log_search' => [
                    'LEFT JOIN', [
                        'ls_field' => 'pr_id', 'ls_value = ' . $dbr->buildStringCast( 'pr_id' )
                    ]
                ],
                'logparen' => [
                    'LEFT JOIN', [
                        'ls_log_id = log_id'
                    ]
                ],
                'actor' => [
                    'JOIN', [
                        'actor_id=log_actor'
                    ]
                ]
            ] + $commentQuery['joins']
        ];
    }
 
    protected function getTableClass() {
        return parent::getTableClass() . ' mw-protectedpages';
    }
 
    public function getIndexField() {
        return 'pr_id';
    }
 
    public function getDefaultSort() {
        return 'pr_id';
    }
 
    protected function isFieldSortable( $field ) {
        // no index for sorting exists
        return false;
    }
}
 
class_alias( ProtectedPagesPager::class, 'ProtectedPagesPager' );
 
class_alias( ProtectedPagesPager::class, 'MediaWiki\\Pager\\ProtectedPagesPager' );