SpecialDeletedContributions.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use HTMLForm;
use LogEventsList;
use MediaWiki\Block\DatabaseBlock;
use MediaWiki\Block\DatabaseBlockStore;
use MediaWiki\Cache\LinkBatchFactory;
use MediaWiki\CommentFormatter\CommentFormatter;
use MediaWiki\Html\FormOptions;
use MediaWiki\MainConfigNames;
use MediaWiki\Pager\DeletedContribsPager;
use MediaWiki\Permissions\PermissionManager;
use MediaWiki\Revision\RevisionFactory;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\Title\NamespaceInfo;
use MediaWiki\User\User;
use MediaWiki\User\UserFactory;
use MediaWiki\User\UserNamePrefixSearch;
use MediaWiki\User\UserNameUtils;
use MediaWiki\User\UserRigorOptions;
use Wikimedia\IPUtils;
use Wikimedia\Rdbms\IConnectionProvider;
 
class SpecialDeletedContributions extends SpecialPage {
    protected $mOpts;
 
    private PermissionManager $permissionManager;
    private IConnectionProvider $dbProvider;
    private RevisionFactory $revisionFactory;
    private NamespaceInfo $namespaceInfo;
    private UserFactory $userFactory;
    private UserNameUtils $userNameUtils;
    private UserNamePrefixSearch $userNamePrefixSearch;
    private CommentFormatter $commentFormatter;
    private LinkBatchFactory $linkBatchFactory;
    private DatabaseBlockStore $blockStore;
 
    public function __construct(
        PermissionManager $permissionManager,
        IConnectionProvider $dbProvider,
        RevisionFactory $revisionFactory,
        NamespaceInfo $namespaceInfo,
        UserFactory $userFactory,
        UserNameUtils $userNameUtils,
        UserNamePrefixSearch $userNamePrefixSearch,
        CommentFormatter $commentFormatter,
        LinkBatchFactory $linkBatchFactory,
        DatabaseBlockStore $blockStore
    ) {
        parent::__construct( 'DeletedContributions', 'deletedhistory' );
        $this->permissionManager = $permissionManager;
        $this->dbProvider = $dbProvider;
        $this->revisionFactory = $revisionFactory;
        $this->namespaceInfo = $namespaceInfo;
        $this->userFactory = $userFactory;
        $this->userNameUtils = $userNameUtils;
        $this->userNamePrefixSearch = $userNamePrefixSearch;
        $this->commentFormatter = $commentFormatter;
        $this->linkBatchFactory = $linkBatchFactory;
        $this->blockStore = $blockStore;
    }
 
    public function execute( $par ) {
        $this->setHeaders();
        $this->outputHeader();
        $this->checkPermissions();
        $out = $this->getOutput();
        $out->addModuleStyles( [
            'mediawiki.interface.helpers.styles',
            'mediawiki.special.changeslist',
        ] );
        $this->addHelpLink( 'Help:User contributions' );
 
        $opts = new FormOptions();
 
        $opts->add( 'target', '' );
        $opts->add( 'namespace', '' );
        $opts->add( 'limit', 20 );
 
        $opts->fetchValuesFromRequest( $this->getRequest() );
        $opts->validateIntBounds( 'limit', 0,
            $this->getConfig()->get( MainConfigNames::QueryPageDefaultLimit ) );
 
        if ( $par !== null ) {
            // Beautify the username
            $par = $this->userNameUtils->getCanonical( $par, UserRigorOptions::RIGOR_NONE );
            $opts->setValue( 'target', (string)$par );
        }
 
        $ns = $opts->getValue( 'namespace' );
        if ( $ns !== null && $ns !== '' ) {
            $opts->setValue( 'namespace', intval( $ns ) );
        }
 
        $this->mOpts = $opts;
 
        $target = trim( $opts->getValue( 'target' ) );
        if ( !strlen( $target ) ) {
            $this->getForm();
 
            return;
        }
 
        $userObj = $this->userFactory->newFromName( $target, UserRigorOptions::RIGOR_NONE );
        if ( !$userObj ) {
            $this->getForm();
 
            return;
        }
        // Only set valid local user as the relevant user (T344886)
        // Uses the same condition as the SpecialContributions class did
        if ( !IPUtils::isValidRange( $target ) &&
            ( $this->userNameUtils->isIP( $target ) || $userObj->isRegistered() )
        ) {
            $this->getSkin()->setRelevantUser( $userObj );
        }
 
        $target = $userObj->getName();
 
        $out->addSubtitle( $this->getSubTitle( $userObj ) );
        $out->setPageTitleMsg( $this->msg( 'deletedcontributions-title' )->plaintextParams( $target ) );
 
        $this->getForm();
 
        $pager = new DeletedContribsPager(
            $this->getContext(),
            $this->getHookContainer(),
            $this->getLinkRenderer(),
            $this->dbProvider,
            $this->revisionFactory,
            $this->commentFormatter,
            $this->linkBatchFactory,
            $target,
            $opts->getValue( 'namespace' )
        );
        if ( !$pager->getNumRows() ) {
            $out->addWikiMsg( 'nocontribs' );
 
            return;
        }
 
        # Show a message about replica DB lag, if applicable
        $lag = $pager->getDatabase()->getSessionLagStatus()['lag'];
        if ( $lag > 0 ) {
            $out->showLagWarning( $lag );
        }
 
        $out->addHTML(
            '<p>' . $pager->getNavigationBar() . '</p>' .
                $pager->getBody() .
                '<p>' . $pager->getNavigationBar() . '</p>' );
 
        # If there were contributions, and it was a valid user or IP, show
        # the appropriate "footer" message - WHOIS tools, etc.
        $message = IPUtils::isIPAddress( $target ) ?
            'sp-contributions-footer-anon' :
            'sp-contributions-footer';
 
        if ( !$this->msg( $message )->isDisabled() ) {
            $out->wrapWikiMsg(
                "<div class='mw-contributions-footer'>\n$1\n</div>",
                [ $message, $target ]
            );
        }
    }
 
    private function getSubTitle( $userObj ) {
        $linkRenderer = $this->getLinkRenderer();
        if ( $userObj->isAnon() ) {
            $user = htmlspecialchars( $userObj->getName() );
        } else {
            $user = $linkRenderer->makeLink( $userObj->getUserPage(), $userObj->getName() );
        }
        $links = '';
        $nt = $userObj->getUserPage();
        $talk = $nt->getTalkPage();
        if ( $talk ) {
            $tools = SpecialContributions::getUserLinks(
                $this,
                $userObj,
                $this->permissionManager,
                $this->getHookRunner()
            );
 
            $contributionsLink = $linkRenderer->makeKnownLink(
                SpecialPage::getTitleFor( 'Contributions', $nt->getDBkey() ),
                $this->msg( 'sp-deletedcontributions-contribs' )->text()
            );
            if ( isset( $tools['deletedcontribs'] ) ) {
                // Swap out the deletedcontribs link for our contribs one
                $tools = wfArrayInsertAfter(
                    $tools, [ 'contribs' => $contributionsLink ], 'deletedcontribs' );
                unset( $tools['deletedcontribs'] );
            } else {
                $tools['contribs'] = $contributionsLink;
            }
 
            $links = $this->getLanguage()->pipeList( $tools );
 
            // Show a note if the user is blocked and display the last block log entry.
            $block = $this->blockStore->newFromTarget( $userObj, $userObj );
            if ( $block !== null && $block->getType() != DatabaseBlock::TYPE_AUTO ) {
                if ( $block->getType() == DatabaseBlock::TYPE_RANGE ) {
                    $nt = $this->namespaceInfo->getCanonicalName( NS_USER )
                        . ':' . $block->getTargetName();
                }
 
                // LogEventsList::showLogExtract() wants the first parameter by ref
                $out = $this->getOutput();
                LogEventsList::showLogExtract(
                    $out,
                    'block',
                    $nt,
                    '',
                    [
                        'lim' => 1,
                        'showIfEmpty' => false,
                        'msgKey' => [
                            'sp-contributions-blocked-notice',
                            $userObj->getName() # Support GENDER in 'sp-contributions-blocked-notice'
                        ],
                        'offset' => '' # don't use $this->getRequest() parameter offset
                    ]
                );
            }
        }
 
        return $this->msg( 'contribsub2' )->rawParams( $user, $links )->params( $userObj->getName() );
    }
 
    private function getForm() {
        $opts = $this->mOpts;
 
        $formDescriptor = [
            'target' => [
                'type' => 'user',
                'name' => 'target',
                'label-message' => 'sp-contributions-username',
                'default' => $opts->getValue( 'target' ),
                'ipallowed' => true,
            ],
 
            'namespace' => [
                'type' => 'namespaceselect',
                'name' => 'namespace',
                'label-message' => 'namespace',
                'all' => '',
            ],
        ];
 
        HTMLForm::factory( 'ooui', $formDescriptor, $this->getContext() )
            ->setWrapperLegendMsg( 'sp-contributions-search' )
            ->setSubmitTextMsg( 'sp-contributions-submit' )
            // prevent setting subpage and 'target' parameter at the same time
            ->setTitle( $this->getPageTitle() )
            ->setMethod( 'get' )
            ->prepareForm()
            ->displayForm( false );
    }
 
    public function prefixSearchSubpages( $search, $limit, $offset ) {
        $search = $this->userNameUtils->getCanonical( $search );
        if ( !$search ) {
            // No prefix suggestion for invalid user
            return [];
        }
        // Autocomplete subpage as user list - public to allow caching
        return $this->userNamePrefixSearch
            ->search( UserNamePrefixSearch::AUDIENCE_PUBLIC, $search, $limit, $offset );
    }
 
    protected function getGroupName() {
        return 'users';
    }
}
 
class_alias( SpecialDeletedContributions::class, 'SpecialDeletedContributions' );