SpecialBlock.php

Go to the documentation of this file.

<?php
use MediaWiki\Block\BlockActionInfo;
use MediaWiki\Block\BlockPermissionCheckerFactory;
use MediaWiki\Block\BlockUser;
use MediaWiki\Block\BlockUserFactory;
use MediaWiki\Block\BlockUtils;
use MediaWiki\Block\DatabaseBlock;
use MediaWiki\Block\Restriction\ActionRestriction;
use MediaWiki\Block\Restriction\NamespaceRestriction;
use MediaWiki\Block\Restriction\PageRestriction;
use MediaWiki\CommentStore\CommentStore;
use MediaWiki\Html\Html;
use MediaWiki\MainConfigNames;
use MediaWiki\MediaWikiServices;
use MediaWiki\Page\PageReference;
use MediaWiki\Page\PageReferenceValue;
use MediaWiki\Permissions\Authority;
use MediaWiki\Title\Title;
use MediaWiki\User\UserIdentity;
use MediaWiki\User\UserNamePrefixSearch;
use MediaWiki\User\UserNameUtils;
use Wikimedia\IPUtils;
 
class SpecialBlock extends FormSpecialPage {
 
    private $blockUtils;
 
    private $blockPermissionCheckerFactory;
 
    private $blockUserFactory;
 
    private $userNameUtils;
 
    private $userNamePrefixSearch;
 
    private $blockActionInfo;
 
    private $titleFormatter;
 
    protected $target;
 
    protected $type;
 
    protected $previousTarget;
 
    protected $requestedHideUser;
 
    protected $alreadyBlocked;
 
    protected $preErrors = [];
 
    private $namespaceInfo;
 
    public function __construct(
        BlockUtils $blockUtils,
        BlockPermissionCheckerFactory $blockPermissionCheckerFactory,
        BlockUserFactory $blockUserFactory,
        UserNameUtils $userNameUtils,
        UserNamePrefixSearch $userNamePrefixSearch,
        BlockActionInfo $blockActionInfo,
        TitleFormatter $titleFormatter,
        NamespaceInfo $namespaceInfo
    ) {
        parent::__construct( 'Block', 'block' );
 
        $this->blockUtils = $blockUtils;
        $this->blockPermissionCheckerFactory = $blockPermissionCheckerFactory;
        $this->blockUserFactory = $blockUserFactory;
        $this->userNameUtils = $userNameUtils;
        $this->userNamePrefixSearch = $userNamePrefixSearch;
        $this->blockActionInfo = $blockActionInfo;
        $this->titleFormatter = $titleFormatter;
        $this->namespaceInfo = $namespaceInfo;
    }
 
    public function doesWrites() {
        return true;
    }
 
    protected function checkExecutePermissions( User $user ) {
        parent::checkExecutePermissions( $user );
        # T17810: blocked admins should have limited access here
        $status = $this->blockPermissionCheckerFactory
            ->newBlockPermissionChecker( $this->target, $user )
            ->checkBlockPermissions();
        if ( $status !== true ) {
            throw new ErrorPageError( 'badaccess', $status );
        }
    }
 
    public function requiresUnblock() {
        return false;
    }
 
    protected function setParameter( $par ) {
        # Extract variables from the request.  Try not to get into a situation where we
        # need to extract *every* variable from the form just for processing here, but
        # there are legitimate uses for some variables
        $request = $this->getRequest();
        [ $this->target, $this->type ] = self::getTargetAndType( $par, $request );
        if ( $this->target instanceof UserIdentity ) {
            # Set the 'relevant user' in the skin, so it displays links like Contributions,
            # User logs, UserRights, etc.
            $this->getSkin()->setRelevantUser( $this->target );
        }
 
        [ $this->previousTarget, /*...*/ ] = $this->blockUtils
            ->parseBlockTarget( $request->getVal( 'wpPreviousTarget' ) );
        $this->requestedHideUser = $request->getBool( 'wpHideUser' );
    }
 
    protected function alterForm( HTMLForm $form ) {
        $form->setHeaderHtml( '' );
        $form->setSubmitDestructive();
 
        $msg = $this->alreadyBlocked ? 'ipb-change-block' : 'ipbsubmit';
        $form->setSubmitTextMsg( $msg );
 
        $this->addHelpLink( 'Help:Blocking users' );
 
        # Don't need to do anything if the form has been posted
        if ( !$this->getRequest()->wasPosted() && $this->preErrors ) {
            # Mimic error messages normally generated by the form
            $form->addHeaderHtml( (string)new OOUI\FieldLayout(
                new OOUI\Widget( [] ),
                [
                    'align' => 'top',
                    'errors' => array_map( function ( $errMsg ) {
                        // @phan-suppress-next-line PhanParamTooFewUnpack Should infer non-emptiness
                        return new OOUI\HtmlSnippet( $this->msg( ...$errMsg )->parse() );
                    }, $this->preErrors ),
                ]
            ) );
        }
    }
 
    protected function getDisplayFormat() {
        return 'ooui';
    }
 
    protected function getFormFields() {
        $conf = $this->getConfig();
        $blockAllowsUTEdit = $conf->get( MainConfigNames::BlockAllowsUTEdit );
 
        $this->getOutput()->enableOOUI();
 
        $user = $this->getUser();
 
        $suggestedDurations = self::getSuggestedDurations();
 
        $a = [];
 
        $a['Target'] = [
            'type' => 'usersmultiselect',
            'max' => 1,
            'ipallowed' => true,
            'iprange' => true,
            'id' => 'mw-bi-target',
            'size' => '45',
            'autofocus' => true,
            'required' => true,
            'placeholder' => $this->msg( 'block-target-placeholder' )->text(),
            'validation-callback' => function ( $value, $alldata, $form ) {
                $status = $this->blockUtils->validateTarget( $value );
                if ( !$status->isOK() ) {
                    $errors = $status->getErrorsArray();
 
                    return $form->msg( ...$errors[0] );
                }
                return true;
            },
            'section' => 'target',
        ];
 
        $a['EditingRestriction'] = [
            'type' => 'radio',
            'cssclass' => 'mw-block-editing-restriction',
            'default' => 'sitewide',
            'options' => [
                $this->msg( 'ipb-sitewide' )->escaped() .
                    new \OOUI\LabelWidget( [
                        'classes' => [ 'oo-ui-inline-help' ],
                        'label' => new \OOUI\HtmlSnippet( $this->msg( 'ipb-sitewide-help' )->parse() ),
                    ] ) => 'sitewide',
                $this->msg( 'ipb-partial' )->escaped() .
                    new \OOUI\LabelWidget( [
                        'classes' => [ 'oo-ui-inline-help' ],
                        'label' => $this->msg( 'ipb-partial-help' )->text(),
                    ] ) => 'partial',
            ],
            'section' => 'actions',
        ];
 
        $a['PageRestrictions'] = [
            'type' => 'titlesmultiselect',
            'label' => $this->msg( 'ipb-pages-label' )->text(),
            'exists' => true,
            'max' => 10,
            'cssclass' => 'mw-htmlform-checkradio-indent mw-block-partial-restriction',
            'default' => '',
            'showMissing' => false,
            'excludeDynamicNamespaces' => true,
            'input' => [
                'autocomplete' => false
            ],
            'section' => 'actions',
        ];
 
        $a['NamespaceRestrictions'] = [
            'type' => 'namespacesmultiselect',
            'label' => $this->msg( 'ipb-namespaces-label' )->text(),
            'exists' => true,
            'cssclass' => 'mw-htmlform-checkradio-indent mw-block-partial-restriction',
            'default' => '',
            'input' => [
                'autocomplete' => false
            ],
            'section' => 'actions',
        ];
 
        if ( $conf->get( MainConfigNames::EnablePartialActionBlocks ) ) {
            $blockActions = $this->blockActionInfo->getAllBlockActions();
            $a['ActionRestrictions'] = [
                'type' => 'multiselect',
                'cssclass' => 'mw-htmlform-checkradio-indent mw-block-partial-restriction mw-block-action-restriction',
                'options-messages' => array_combine(
                    array_map( static function ( $action ) {
                        return "ipb-action-$action";
                    }, array_keys( $blockActions ) ),
                    $blockActions
                ),
                'section' => 'actions',
            ];
        }
 
        $a['CreateAccount'] = [
            'type' => 'check',
            'cssclass' => 'mw-block-restriction',
            'label-message' => 'ipbcreateaccount',
            'default' => true,
            'section' => 'details',
        ];
 
        if ( $this->blockPermissionCheckerFactory
            ->newBlockPermissionChecker( null, $user )
            ->checkEmailPermissions()
        ) {
            $a['DisableEmail'] = [
                'type' => 'check',
                'cssclass' => 'mw-block-restriction',
                'label-message' => 'ipbemailban',
                'section' => 'details',
            ];
        }
 
        if ( $blockAllowsUTEdit ) {
            $a['DisableUTEdit'] = [
                'type' => 'check',
                'cssclass' => 'mw-block-restriction',
                'label-message' => 'ipb-disableusertalk',
                'default' => false,
                'section' => 'details',
            ];
        }
 
        $defaultExpiry = $this->msg( 'ipb-default-expiry' )->inContentLanguage();
        if ( $this->type === DatabaseBlock::TYPE_RANGE || $this->type === DatabaseBlock::TYPE_IP ) {
            $defaultExpiryIP = $this->msg( 'ipb-default-expiry-ip' )->inContentLanguage();
            if ( !$defaultExpiryIP->isDisabled() ) {
                $defaultExpiry = $defaultExpiryIP;
            }
        }
 
        $a['Expiry'] = [
            'type' => 'expiry',
            'required' => true,
            'options' => $suggestedDurations,
            'default' => $defaultExpiry->text(),
            'section' => 'expiry',
        ];
 
        $a['Reason'] = [
            'type' => 'selectandother',
            // HTML maxlength uses "UTF-16 code units", which means that characters outside BMP
            // (e.g. emojis) count for two each. This limit is overridden in JS to instead count
            // Unicode codepoints.
            'maxlength' => CommentStore::COMMENT_CHARACTER_LIMIT,
            'maxlength-unit' => 'codepoints',
            'options-message' => 'ipbreason-dropdown',
            'section' => 'reason',
        ];
 
        $a['AutoBlock'] = [
            'type' => 'check',
            'label-message' => [
                'ipbenableautoblock',
                Message::durationParam( $conf->get( MainConfigNames::AutoblockExpiry ) )
            ],
            'default' => true,
            'section' => 'options',
        ];
 
        # Allow some users to hide name from block log, blocklist and listusers
        if ( $this->getAuthority()->isAllowed( 'hideuser' ) ) {
            $a['HideUser'] = [
                'type' => 'check',
                'label-message' => 'ipbhidename',
                'cssclass' => 'mw-block-hideuser',
                'section' => 'options',
            ];
        }
 
        # Watchlist their user page? (Only if user is logged in)
        if ( $user->isRegistered() ) {
            $a['Watch'] = [
                'type' => 'check',
                'label-message' => 'ipbwatchuser',
                'section' => 'options',
            ];
        }
 
        $a['HardBlock'] = [
            'type' => 'check',
            'label-message' => 'ipb-hardblock',
            'default' => false,
            'section' => 'options',
        ];
 
        # This is basically a copy of the Target field, but the user can't change it, so we
        # can see if the warnings we maybe showed to the user before still apply
        $a['PreviousTarget'] = [
            'type' => 'hidden',
            'default' => false,
        ];
 
        # We'll turn this into a checkbox if we need to
        $a['Confirm'] = [
            'type' => 'hidden',
            'default' => '',
            'label-message' => 'ipb-confirm',
            'cssclass' => 'mw-block-confirm',
        ];
 
        $this->maybeAlterFormDefaults( $a );
 
        // Allow extensions to add more fields
        $this->getHookRunner()->onSpecialBlockModifyFormFields( $this, $a );
 
        return $a;
    }
 
    protected function maybeAlterFormDefaults( &$fields ) {
        # This will be overwritten by request data
        $fields['Target']['default'] = (string)$this->target;
 
        if ( $this->target ) {
            $status = $this->blockUtils->validateTarget( $this->target );
            if ( !$status->isOK() ) {
                $errors = $status->getErrorsArray();
                $this->preErrors = array_merge( $this->preErrors, $errors );
            }
        }
 
        # This won't be
        $fields['PreviousTarget']['default'] = (string)$this->target;
 
        $block = DatabaseBlock::newFromTarget( $this->target );
 
        // Populate fields if there is a block that is not an autoblock; if it is a range
        // block, only populate the fields if the range is the same as $this->target
        if ( $block instanceof DatabaseBlock && $block->getType() !== DatabaseBlock::TYPE_AUTO
            && ( $this->type != DatabaseBlock::TYPE_RANGE
                || ( $this->target && $block->isBlocking( $this->target ) ) )
        ) {
            $fields['HardBlock']['default'] = $block->isHardblock();
            $fields['CreateAccount']['default'] = $block->isCreateAccountBlocked();
            $fields['AutoBlock']['default'] = $block->isAutoblocking();
 
            if ( isset( $fields['DisableEmail'] ) ) {
                $fields['DisableEmail']['default'] = $block->isEmailBlocked();
            }
 
            if ( isset( $fields['HideUser'] ) ) {
                $fields['HideUser']['default'] = $block->getHideName();
            }
 
            if ( isset( $fields['DisableUTEdit'] ) ) {
                $fields['DisableUTEdit']['default'] = !$block->isUsertalkEditAllowed();
            }
 
            // If the username was hidden (ipb_deleted == 1), don't show the reason
            // unless this user also has rights to hideuser: T37839
            if ( !$block->getHideName() || $this->getAuthority()->isAllowed( 'hideuser' ) ) {
                $fields['Reason']['default'] = $block->getReasonComment()->text;
            } else {
                $fields['Reason']['default'] = '';
            }
 
            if ( $this->getRequest()->wasPosted() ) {
                # Ok, so we got a POST submission asking us to reblock a user.  So show the
                # confirm checkbox; the user will only see it if they haven't previously
                $fields['Confirm']['type'] = 'check';
            } else {
                # We got a target, but it wasn't a POST request, so the user must have gone
                # to a link like [[Special:Block/User]].  We don't need to show the checkbox
                # as long as they go ahead and block *that* user
                $fields['Confirm']['default'] = 1;
            }
 
            if ( $block->getExpiry() == 'infinity' ) {
                $fields['Expiry']['default'] = 'infinite';
            } else {
                $fields['Expiry']['default'] = wfTimestamp( TS_RFC2822, $block->getExpiry() );
            }
 
            if ( !$block->isSitewide() ) {
                $fields['EditingRestriction']['default'] = 'partial';
 
                $pageRestrictions = [];
                $namespaceRestrictions = [];
                foreach ( $block->getRestrictions() as $restriction ) {
                    if ( $restriction instanceof PageRestriction && $restriction->getTitle() ) {
                        $pageRestrictions[] = $restriction->getTitle()->getPrefixedText();
                    } elseif ( $restriction instanceof NamespaceRestriction &&
                        $this->namespaceInfo->exists( $restriction->getValue() )
                    ) {
                        $namespaceRestrictions[] = $restriction->getValue();
                    }
                }
 
                // Sort the restrictions so they are in alphabetical order.
                sort( $pageRestrictions );
                $fields['PageRestrictions']['default'] = implode( "\n", $pageRestrictions );
                sort( $namespaceRestrictions );
                $fields['NamespaceRestrictions']['default'] = implode( "\n", $namespaceRestrictions );
 
                if ( $this->getConfig()->get( MainConfigNames::EnablePartialActionBlocks ) ) {
                    $actionRestrictions = [];
                    foreach ( $block->getRestrictions() as $restriction ) {
                        if ( $restriction instanceof ActionRestriction ) {
                            $actionRestrictions[] = $restriction->getValue();
                        }
                    }
                    $fields['ActionRestrictions']['default'] = $actionRestrictions;
                }
            }
 
            $this->alreadyBlocked = true;
            $this->preErrors[] = [ 'ipb-needreblock', wfEscapeWikiText( $block->getTargetName() ) ];
        }
 
        if ( $this->alreadyBlocked || $this->getRequest()->wasPosted()
            || $this->getRequest()->getCheck( 'wpCreateAccount' )
        ) {
            $this->getOutput()->addJsConfigVars( 'wgCreateAccountDirty', true );
        }
 
        # We always need confirmation to do HideUser
        if ( $this->requestedHideUser ) {
            $fields['Confirm']['type'] = 'check';
            unset( $fields['Confirm']['default'] );
            $this->preErrors[] = [ 'ipb-confirmhideuser', 'ipb-confirmaction' ];
        }
 
        # Or if the user is trying to block themselves
        if ( (string)$this->target === $this->getUser()->getName() ) {
            $fields['Confirm']['type'] = 'check';
            unset( $fields['Confirm']['default'] );
            $this->preErrors[] = [ 'ipb-blockingself', 'ipb-confirmaction' ];
        }
    }
 
    protected function preHtml() {
        $this->getOutput()->addModuleStyles( [ 'mediawiki.special' ] );
        $this->getOutput()->addModules( [ 'mediawiki.special.block' ] );
 
        $blockCIDRLimit = $this->getConfig()->get( MainConfigNames::BlockCIDRLimit );
        $text = $this->msg( 'blockiptext', $blockCIDRLimit['IPv4'], $blockCIDRLimit['IPv6'] )->parse();
 
        $otherBlockMessages = [];
        if ( $this->target !== null ) {
            $targetName = $this->target;
            if ( $this->target instanceof UserIdentity ) {
                $targetName = $this->target->getName();
            }
            # Get other blocks, i.e. from GlobalBlocking or TorBlock extension
            $this->getHookRunner()->onOtherBlockLogLink(
                $otherBlockMessages, $targetName );
 
            if ( count( $otherBlockMessages ) ) {
                $s = Html::rawElement(
                    'h2',
                    [],
                    $this->msg( 'ipb-otherblocks-header', count( $otherBlockMessages ) )->parse()
                ) . "\n";
 
                $list = '';
 
                foreach ( $otherBlockMessages as $link ) {
                    $list .= Html::rawElement( 'li', [], $link ) . "\n";
                }
 
                $s .= Html::rawElement(
                    'ul',
                    [ 'class' => 'mw-blockip-alreadyblocked' ],
                    $list
                ) . "\n";
 
                $text .= $s;
            }
        }
 
        return $text;
    }
 
    protected function postHtml() {
        $links = [];
 
        $this->getOutput()->addModuleStyles( 'mediawiki.special' );
 
        $linkRenderer = $this->getLinkRenderer();
        # Link to the user's contributions, if applicable
        if ( $this->target instanceof UserIdentity ) {
            $contribsPage = SpecialPage::getTitleFor( 'Contributions', $this->target->getName() );
            $links[] = $linkRenderer->makeLink(
                $contribsPage,
                $this->msg( 'ipb-blocklist-contribs', $this->target->getName() )->text()
            );
        }
 
        # Link to unblock the specified user, or to a blank unblock form
        if ( $this->target instanceof UserIdentity ) {
            $message = $this->msg(
                'ipb-unblock-addr',
                wfEscapeWikiText( $this->target->getName() )
            )->parse();
            $list = SpecialPage::getTitleFor( 'Unblock', $this->target->getName() );
        } else {
            $message = $this->msg( 'ipb-unblock' )->parse();
            $list = SpecialPage::getTitleFor( 'Unblock' );
        }
        $links[] = $linkRenderer->makeKnownLink(
            $list,
            new HtmlArmor( $message )
        );
 
        # Link to the block list
        $links[] = $linkRenderer->makeKnownLink(
            SpecialPage::getTitleFor( 'BlockList' ),
            $this->msg( 'ipb-blocklist' )->text()
        );
 
        # Link to edit the block dropdown reasons, if applicable
        if ( $this->getAuthority()->isAllowed( 'editinterface' ) ) {
            $links[] = $linkRenderer->makeKnownLink(
                $this->msg( 'ipbreason-dropdown' )->inContentLanguage()->getTitle(),
                $this->msg( 'ipb-edit-dropdown' )->text(),
                [],
                [ 'action' => 'edit' ]
            );
        }
 
        $text = Html::rawElement(
            'p',
            [ 'class' => 'mw-ipb-conveniencelinks' ],
            $this->getLanguage()->pipeList( $links )
        );
 
        $userPage = self::getTargetUserTitle( $this->target );
        if ( $userPage ) {
            # Get relevant extracts from the block and suppression logs, if possible
            $out = '';
 
            LogEventsList::showLogExtract(
                $out,
                'block',
                $userPage,
                '',
                [
                    'lim' => 10,
                    'msgKey' => [
                        'blocklog-showlog',
                        $this->titleFormatter->getText( $userPage ),
                    ],
                    'showIfEmpty' => false
                ]
            );
            $text .= $out;
 
            # Add suppression block entries if allowed
            if ( $this->getAuthority()->isAllowed( 'suppressionlog' ) ) {
                LogEventsList::showLogExtract(
                    $out,
                    'suppress',
                    $userPage,
                    '',
                    [
                        'lim' => 10,
                        'conds' => [ 'log_action' => [ 'block', 'reblock', 'unblock' ] ],
                        'msgKey' => [
                            'blocklog-showsuppresslog',
                            $this->titleFormatter->getText( $userPage ),
                        ],
                        'showIfEmpty' => false
                    ]
                );
 
                $text .= $out;
            }
        }
 
        return $text;
    }
 
    protected static function getTargetUserTitle( $target ): ?PageReference {
        if ( $target instanceof UserIdentity ) {
            return PageReferenceValue::localReference( NS_USER, $target->getName() );
        }
 
        if ( is_string( $target ) && IPUtils::isIPAddress( $target ) ) {
            return PageReferenceValue::localReference( NS_USER, $target );
        }
 
        return null;
    }
 
    public static function getTargetAndType( ?string $par, WebRequest $request = null ) {
        if ( !$request instanceof WebRequest ) {
            return MediaWikiServices::getInstance()->getBlockUtils()->parseBlockTarget( $par );
        }
 
        $possibleTargets = [
            $request->getVal( 'wpTarget', null ),
            $par,
            $request->getVal( 'ip', null ),
            // B/C @since 1.18
            $request->getVal( 'wpBlockAddress', null ),
        ];
        foreach ( $possibleTargets as $possibleTarget ) {
            $targetAndType = MediaWikiServices::getInstance()
                ->getBlockUtils()
                ->parseBlockTarget( $possibleTarget );
            // If type is not null then target is valid
            if ( $targetAndType[ 1 ] !== null ) {
                break;
            }
        }
        return $targetAndType;
    }
 
    public static function processForm( array $data, IContextSource $context ) {
        $services = MediaWikiServices::getInstance();
        return self::processFormInternal(
            $data,
            $context->getAuthority(),
            $services->getBlockUserFactory(),
            $services->getBlockUtils()
        );
    }
 
    private static function processFormInternal(
        array $data,
        Authority $performer,
        BlockUserFactory $blockUserFactory,
        BlockUtils $blockUtils
    ) {
        // Temporarily access service container until the feature flag is removed: T280532
        $enablePartialActionBlocks = MediaWikiServices::getInstance()
            ->getMainConfig()->get( MainConfigNames::EnablePartialActionBlocks );
 
        $isPartialBlock = isset( $data['EditingRestriction'] ) &&
            $data['EditingRestriction'] === 'partial';
 
        # This might have been a hidden field or a checkbox, so interesting data
        # can come from it
        $data['Confirm'] = !in_array( $data['Confirm'], [ '', '0', null, false ], true );
 
        # If the user has done the form 'properly', they won't even have been given the
        # option to suppress-block unless they have the 'hideuser' permission
        if ( !isset( $data['HideUser'] ) ) {
            $data['HideUser'] = false;
        }
 
        [ $target, $type ] = $blockUtils->parseBlockTarget( $data['Target'] );
        if ( $type == DatabaseBlock::TYPE_USER ) {
            $target = $target->getName();
 
            # Give admins a heads-up before they go and block themselves.  Much messier
            # to do this for IPs, but it's pretty unlikely they'd ever get the 'block'
            # permission anyway, although the code does allow for it.
            # Note: Important to use $target instead of $data['Target']
            # since both $data['PreviousTarget'] and $target are normalized
            # but $data['target'] gets overridden by (non-normalized) request variable
            # from previous request.
            if ( $target === $performer->getUser()->getName() &&
                ( $data['PreviousTarget'] !== $target || !$data['Confirm'] )
            ) {
                return [ 'ipb-blockingself', 'ipb-confirmaction' ];
            }
 
            if ( $data['HideUser'] && !$data['Confirm'] ) {
                return [ 'ipb-confirmhideuser', 'ipb-confirmaction' ];
            }
        } elseif ( $type == DatabaseBlock::TYPE_IP ) {
            $target = $target->getName();
        } elseif ( $type != DatabaseBlock::TYPE_RANGE ) {
            # This should have been caught in the form field validation
            return [ 'badipaddress' ];
        }
 
        // Reason, to be passed to the block object. For default values of reason, see
        // HTMLSelectAndOtherField::getDefault
        $blockReason = $data['Reason'][0] ?? '';
 
        $pageRestrictions = [];
        $namespaceRestrictions = [];
        $actionRestrictions = [];
        if ( $isPartialBlock ) {
            if ( isset( $data['PageRestrictions'] ) && $data['PageRestrictions'] !== '' ) {
                $titles = explode( "\n", $data['PageRestrictions'] );
                foreach ( $titles as $title ) {
                    $pageRestrictions[] = PageRestriction::newFromTitle( $title );
                }
            }
            if ( isset( $data['NamespaceRestrictions'] ) && $data['NamespaceRestrictions'] !== '' ) {
                $namespaceRestrictions = array_map( static function ( $id ) {
                    return new NamespaceRestriction( 0, (int)$id );
                }, explode( "\n", $data['NamespaceRestrictions'] ) );
            }
            if (
                $enablePartialActionBlocks &&
                isset( $data['ActionRestrictions'] ) &&
                $data['ActionRestrictions'] !== ''
            ) {
                $actionRestrictions = array_map( static function ( $id ) {
                    return new ActionRestriction( 0, $id );
                }, $data['ActionRestrictions'] );
            }
        }
        $restrictions = array_merge( $pageRestrictions, $namespaceRestrictions, $actionRestrictions );
 
        if ( !isset( $data['Tags'] ) ) {
            $data['Tags'] = [];
        }
 
        $blockOptions = [
            'isCreateAccountBlocked' => $data['CreateAccount'],
            'isHardBlock' => $data['HardBlock'],
            'isAutoblocking' => $data['AutoBlock'],
            'isHideUser' => $data['HideUser'],
            'isPartial' => $isPartialBlock,
        ];
 
        if ( isset( $data['DisableUTEdit'] ) ) {
            $blockOptions['isUserTalkEditBlocked'] = $data['DisableUTEdit'];
        }
        if ( isset( $data['DisableEmail'] ) ) {
            $blockOptions['isEmailBlocked'] = $data['DisableEmail'];
        }
 
        $blockUser = $blockUserFactory->newBlockUser(
            $target,
            $performer,
            $data['Expiry'],
            $blockReason,
            $blockOptions,
            $restrictions,
            $data['Tags']
        );
 
        # Indicates whether the user is confirming the block and is aware of
        # the conflict (did not change the block target in the meantime)
        $blockNotConfirmed = !$data['Confirm'] || ( array_key_exists( 'PreviousTarget', $data )
            && $data['PreviousTarget'] !== $target );
 
        # Special case for API - T34434
        $reblockNotAllowed = ( array_key_exists( 'Reblock', $data ) && !$data['Reblock'] );
 
        $doReblock = !$blockNotConfirmed && !$reblockNotAllowed;
 
        $status = $blockUser->placeBlock( $doReblock );
        if ( !$status->isOK() ) {
            return $status;
        }
 
        if (
            // Can't watch a rangeblock
            $type != DatabaseBlock::TYPE_RANGE
 
            // Technically a wiki can be configured to allow anonymous users to place blocks,
            // in which case the 'Watch' field isn't included in the form shown, and we should
            // not try to access it.
            && array_key_exists( 'Watch', $data )
            && $data['Watch']
        ) {
            MediaWikiServices::getInstance()->getWatchlistManager()->addWatchIgnoringRights(
                $performer->getUser(),
                Title::makeTitle( NS_USER, $target )
            );
        }
 
        return true;
    }
 
    public static function getSuggestedDurations( Language $lang = null, $includeOther = true ) {
        $msg = $lang === null
            ? wfMessage( 'ipboptions' )->inContentLanguage()->text()
            : wfMessage( 'ipboptions' )->inLanguage( $lang )->text();
 
        if ( $msg == '-' ) {
            return [];
        }
 
        $a = XmlSelect::parseOptionsMessage( $msg );
 
        if ( $a && $includeOther ) {
            // if options exist, add other to the end instead of the beginning (which
            // is what happens by default).
            $a[ wfMessage( 'ipbother' )->text() ] = 'other';
        }
 
        return $a;
    }
 
    public static function parseExpiryInput( $expiry ) {
        return BlockUser::parseExpiryInput( $expiry );
    }
 
    public static function canBlockEmail( UserIdentity $user ) {
        return MediaWikiServices::getInstance()
            ->getBlockPermissionCheckerFactory()
            ->newBlockPermissionChecker( null, User::newFromIdentity( $user ) )
            ->checkEmailPermissions();
    }
 
    public static function checkUnblockSelf( $target, Authority $performer ) {
        wfDeprecated( __METHOD__, '1.36' );
        return MediaWikiServices::getInstance()
            ->getBlockPermissionCheckerFactory()
            ->newBlockPermissionChecker( $target, $performer )
            ->checkBlockPermissions();
    }
 
    public function onSubmit( array $data, HTMLForm $form = null ) {
        return self::processFormInternal(
            $data,
            $this->getAuthority(),
            $this->blockUserFactory,
            $this->blockUtils
        );
    }
 
    public function onSuccess() {
        $out = $this->getOutput();
        $out->setPageTitle( $this->msg( 'blockipsuccesssub' ) );
        $out->addWikiMsg( 'blockipsuccesstext', wfEscapeWikiText( $this->target ) );
    }
 
    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';
    }
}