SpecialUnblock.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\Block\Block;
use MediaWiki\Block\BlockTarget;
use MediaWiki\Block\BlockTargetFactory;
use MediaWiki\Block\BlockTargetWithUserPage;
use MediaWiki\Block\DatabaseBlock;
use MediaWiki\Block\DatabaseBlockStore;
use MediaWiki\Block\UnblockUserFactory;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\Logging\LogEventsList;
use MediaWiki\MainConfigNames;
use MediaWiki\Request\WebRequest;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\Title\Title;
use MediaWiki\Title\TitleValue;
use MediaWiki\User\UserNamePrefixSearch;
use MediaWiki\User\UserNameUtils;
use MediaWiki\Watchlist\WatchlistManager;
 
class SpecialUnblock extends SpecialPage {
 
    protected $target;
 
    protected $block;
 
    public function __construct(
        private readonly UnblockUserFactory $unblockUserFactory,
        private readonly BlockTargetFactory $blockTargetFactory,
        private readonly DatabaseBlockStore $blockStore,
        private readonly UserNameUtils $userNameUtils,
        private readonly UserNamePrefixSearch $userNamePrefixSearch,
        private readonly WatchlistManager $watchlistManager,
    ) {
        parent::__construct( 'Unblock', 'block' );
    }
 
    public function doesWrites() {
        return true;
    }
 
    public function execute( $par ) {
        $this->checkPermissions();
        $this->checkReadOnly();
 
        $this->target = $this->getTargetFromRequest( $par, $this->getRequest() );
 
        // T382539
        if ( $this->getConfig()->get( MainConfigNames::UseCodexSpecialBlock )
            || $this->getRequest()->getBool( 'usecodex' )
        ) {
            // If target is null, redirect to Special:Block
            if ( $this->target === null ) {
                // Use 301 (Moved Permanently) as this is a deprecation
                $this->getOutput()->redirect(
                    SpecialPage::getTitleFor( 'Block' )->getFullURL( 'redirected=1' ),
                    '301'
                );
                return;
            }
        }
 
        $this->block = $this->blockStore->newFromTarget( $this->target );
        if ( $this->target instanceof BlockTargetWithUserPage ) {
            // Set the 'relevant user' in the skin, so it displays links like Contributions,
            // User logs, UserRights, etc.
            $this->getSkin()->setRelevantUser( $this->target->getUserIdentity() );
        }
 
        $this->setHeaders();
        $this->outputHeader();
        $this->addHelpLink( 'Help:Blocking users' );
 
        $out = $this->getOutput();
        $out->setPageTitleMsg( $this->msg( 'unblock-target' ) );
        $out->addModules( [ 'mediawiki.userSuggest', 'mediawiki.special.block' ] );
 
        $form = HTMLForm::factory( 'ooui', $this->getFields(), $this->getContext() )
            ->setWrapperLegendMsg( 'unblock-target' )
            ->setSubmitCallback( function ( array $data, HTMLForm $form ) {
                if ( $this->target instanceof BlockTargetWithUserPage && $data['Watch'] ) {
                    $this->watchlistManager->addWatchIgnoringRights(
                        $form->getUser(),
                        Title::newFromPageReference( $this->target->getUserPage() )
                    );
                }
                $status = $this->unblockUserFactory->newUnblockUser(
                    $this->target,
                    $form->getContext()->getAuthority(),
                    $data['Reason'],
                    $data['Tags'] ?? []
                )->unblock();
 
                if ( $status->hasMessage( 'ipb_cant_unblock_multiple_blocks' ) ) {
                    // Add additional message sending users to [[Special:Block/Username]]
                    $status->error( 'unblock-error-multiblocks', $this->target->toString() );
                }
                return $status;
            } )
            ->setSubmitTextMsg( 'ipusubmit' )
            ->addPreHtml( $this->msg( 'unblockiptext' )->parseAsBlock() );
 
        if ( $this->target ) {
            $userPage = $this->target->getLogPage();
            $targetName = (string)$this->target;
            // Get relevant extracts from the block and suppression logs, if possible
            $logExtract = '';
            LogEventsList::showLogExtract(
                $logExtract,
                'block',
                $userPage,
                '',
                [
                    'lim' => 10,
                    'msgKey' => [
                        'unblocklog-showlog',
                        $targetName,
                    ],
                    'showIfEmpty' => false
                ]
            );
            if ( $logExtract !== '' ) {
                $form->addPostHtml( $logExtract );
            }
 
            // Add suppression block entries if allowed
            if ( $this->getAuthority()->isAllowed( 'suppressionlog' ) ) {
                $logExtract = '';
                LogEventsList::showLogExtract(
                    $logExtract,
                    'suppress',
                    $userPage,
                    '',
                    [
                        'lim' => 10,
                        'conds' => [ 'log_action' => [ 'block', 'reblock', 'unblock' ] ],
                        'msgKey' => [
                            'unblocklog-showsuppresslog',
                            $targetName,
                        ],
                        'showIfEmpty' => false
                    ]
                );
                if ( $logExtract !== '' ) {
                    $form->addPostHtml( $logExtract );
                }
            }
        }
 
        if ( $form->show() ) {
            $msgsByType = [
                Block::TYPE_IP => 'unblocked-ip',
                Block::TYPE_USER => 'unblocked',
                Block::TYPE_RANGE => 'unblocked-range',
                Block::TYPE_AUTO => 'unblocked-id'
            ];
            $out->addWikiMsg(
                $msgsByType[$this->target->getType()],
                wfEscapeWikiText( (string)$this->target )
            );
        }
    }
 
    private function getTargetFromRequest( ?string $par, WebRequest $request ) {
        $possibleTargets = [
            $request->getVal( 'wpTarget', null ),
            $par,
            $request->getVal( 'ip', null ),
            // B/C @since 1.18
            $request->getVal( 'wpBlockAddress', null ),
        ];
        foreach ( $possibleTargets as $possibleTarget ) {
            $target = $this->blockTargetFactory->newFromString( $possibleTarget );
            // If type is not null then target is valid
            if ( $target ) {
                break;
            }
        }
        return $target;
    }
 
    protected function getFields(): array {
        $fields = [
            'Target' => [
                'type' => 'text',
                'label-message' => 'unblock-target-label',
                'autofocus' => true,
                'size' => '45',
                'required' => true,
                'cssclass' => 'mw-autocomplete-user', // used by mediawiki.userSuggest
            ],
            'Name' => [
                'type' => 'info',
                'label-message' => 'unblock-target-label',
            ],
            'Reason' => [
                'type' => 'text',
                'label-message' => 'ipbreason',
            ]
        ];
 
        if ( $this->block instanceof Block ) {
            $type = $this->block->getType();
            $targetName = $this->block->getTargetName();
 
            // Autoblocks are logged as "autoblock #123 because the IP was recently used by
            // User:Foo, and we've just got any block, auto or not, that applies to a target
            // the user has specified.  Someone could be fishing to connect IPs to autoblocks,
            // so don't show any distinction between unblocked IPs and autoblocked IPs
            if ( $type == Block::TYPE_AUTO && $this->target->getType() == Block::TYPE_IP ) {
                $fields['Target']['default'] = (string)$this->target;
                unset( $fields['Name'] );
            } else {
                $fields['Target']['default'] = $targetName;
                $fields['Target']['type'] = 'hidden';
                switch ( $type ) {
                    case Block::TYPE_IP:
                        $fields['Name']['default'] = $this->getLinkRenderer()->makeKnownLink(
                            $this->getSpecialPageFactory()->getTitleForAlias( 'Contributions/' . $targetName ),
                            $targetName
                        );
                        $fields['Name']['raw'] = true;
                        break;
                    case Block::TYPE_USER:
                        $fields['Name']['default'] = $this->getLinkRenderer()->makeLink(
                            new TitleValue( NS_USER, $targetName ),
                            $targetName
                        );
                        $fields['Name']['raw'] = true;
                        break;
 
                    case Block::TYPE_RANGE:
                        $fields['Name']['default'] = $targetName;
                        break;
 
                    case Block::TYPE_AUTO:
                        // Don't expose the real target of the autoblock
                        $fields['Name']['default'] = $this->block->getRedactedName();
                        $fields['Name']['raw'] = true;
                        $fields['Target']['default'] = $this->block->getRedactedTarget()->toString();
                        break;
                }
                // Target is hidden, so the reason is the first element
                $fields['Target']['autofocus'] = false;
                $fields['Reason']['autofocus'] = true;
            }
        } else {
            $fields['Target']['default'] = $this->target;
            unset( $fields['Name'] );
        }
        // Watchlist their user page? (Only if user is logged in)
        if ( $this->getUser()->isRegistered() ) {
            $fields['Watch'] = [
                'type' => 'check',
                'label-message' => 'ipbwatchuser',
            ];
        }
 
        return $fields;
    }
 
    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( SpecialUnblock::class, 'SpecialUnblock' );