ProtectionForm.php

Go to the documentation of this file.

<?php
use MediaWiki\MediaWikiServices;

class ProtectionForm {
    protected $mRestrictions = [];

    protected $mReason = '';

    protected $mReasonSelection = '';

    protected $mCascade = false;

    protected $mExpiry = [];

    protected $mExpirySelection = [];

    protected $mPermErrors = [];

    protected $mApplicableTypes = [];

    protected $mExistingExpiry = [];

    private $mContext;

    function __construct( Article $article ) {
        // Set instance variables.
        $this->mArticle = $article;
        $this->mTitle = $article->getTitle();
        $this->mApplicableTypes = $this->mTitle->getRestrictionTypes();
        $this->mContext = $article->getContext();

        // Check if the form should be disabled.
        // If it is, the form will be available in read-only to show levels.
        $this->mPermErrors = $this->mTitle->getUserPermissionsErrors(
            'protect',
            $this->mContext->getUser(),
            $this->mContext->getRequest()->wasPosted() ? 'secure' : 'full' // T92357
        );
        if ( wfReadOnly() ) {
            $this->mPermErrors[] = [ 'readonlytext', wfReadOnlyReason() ];
        }
        $this->disabled = $this->mPermErrors != [];
        $this->disabledAttrib = $this->disabled
            ? [ 'disabled' => 'disabled' ]
            : [];

        $this->loadData();
    }

    function loadData() {
        $levels = MWNamespace::getRestrictionLevels(
            $this->mTitle->getNamespace(), $this->mContext->getUser()
        );
        $this->mCascade = $this->mTitle->areRestrictionsCascading();

        $request = $this->mContext->getRequest();
        $this->mReason = $request->getText( 'mwProtect-reason' );
        $this->mReasonSelection = $request->getText( 'wpProtectReasonSelection' );
        $this->mCascade = $request->getBool( 'mwProtect-cascade', $this->mCascade );

        foreach ( $this->mApplicableTypes as $action ) {
            // @todo FIXME: This form currently requires individual selections,
            // but the db allows multiples separated by commas.

            // Pull the actual restriction from the DB
            $this->mRestrictions[$action] = implode( '', $this->mTitle->getRestrictions( $action ) );

            if ( !$this->mRestrictions[$action] ) {
                // No existing expiry
                $existingExpiry = '';
            } else {
                $existingExpiry = $this->mTitle->getRestrictionExpiry( $action );
            }
            $this->mExistingExpiry[$action] = $existingExpiry;

            $requestExpiry = $request->getText( "mwProtect-expiry-$action" );
            $requestExpirySelection = $request->getVal( "wpProtectExpirySelection-$action" );

            if ( $requestExpiry ) {
                // Custom expiry takes precedence
                $this->mExpiry[$action] = $requestExpiry;
                $this->mExpirySelection[$action] = 'othertime';
            } elseif ( $requestExpirySelection ) {
                // Expiry selected from list
                $this->mExpiry[$action] = '';
                $this->mExpirySelection[$action] = $requestExpirySelection;
            } elseif ( $existingExpiry ) {
                // Use existing expiry in its own list item
                $this->mExpiry[$action] = '';
                $this->mExpirySelection[$action] = $existingExpiry;
            } else {
                // Catches 'infinity' - Existing expiry is infinite, use "infinite" in drop-down
                // Final default: infinite
                $this->mExpiry[$action] = '';
                $this->mExpirySelection[$action] = 'infinite';
            }

            $val = $request->getVal( "mwProtect-level-$action" );
            if ( isset( $val ) && in_array( $val, $levels ) ) {
                $this->mRestrictions[$action] = $val;
            }
        }
    }

    function getExpiry( $action ) {
        if ( $this->mExpirySelection[$action] == 'existing' ) {
            return $this->mExistingExpiry[$action];
        } elseif ( $this->mExpirySelection[$action] == 'othertime' ) {
            $value = $this->mExpiry[$action];
        } else {
            $value = $this->mExpirySelection[$action];
        }
        if ( wfIsInfinity( $value ) ) {
            $time = 'infinity';
        } else {
            $unix = strtotime( $value );

            if ( !$unix || $unix === -1 ) {
                return false;
            }

            // @todo FIXME: Non-qualified absolute times are not in users specified timezone
            // and there isn't notice about it in the ui
            $time = wfTimestamp( TS_MW, $unix );
        }
        return $time;
    }

    function execute() {
        if ( MWNamespace::getRestrictionLevels( $this->mTitle->getNamespace() ) === [ '' ] ) {
            throw new ErrorPageError( 'protect-badnamespace-title', 'protect-badnamespace-text' );
        }

        if ( $this->mContext->getRequest()->wasPosted() ) {
            if ( $this->save() ) {
                $q = $this->mArticle->isRedirect() ? 'redirect=no' : '';
                $this->mContext->getOutput()->redirect( $this->mTitle->getFullURL( $q ) );
            }
        } else {
            $this->show();
        }
    }

    function show( $err = null ) {
        $out = $this->mContext->getOutput();
        $out->setRobotPolicy( 'noindex,nofollow' );
        $out->addBacklinkSubtitle( $this->mTitle );

        if ( is_array( $err ) ) {
            $out->wrapWikiMsg( "<div class='error'>\n$1\n</div>\n", $err );
        } elseif ( is_string( $err ) ) {
            $out->addHTML( "<div class='error'>{$err}</div>\n" );
        }

        if ( $this->mTitle->getRestrictionTypes() === [] ) {
            // No restriction types available for the current title
            // this might happen if an extension alters the available types
            $out->setPageTitle( $this->mContext->msg(
                'protect-norestrictiontypes-title',
                $this->mTitle->getPrefixedText()
            ) );
            $out->addWikiTextAsInterface(
                $this->mContext->msg( 'protect-norestrictiontypes-text' )->plain()
            );

            // Show the log in case protection was possible once
            $this->showLogExtract( $out );
            // return as there isn't anything else we can do
            return;
        }

        list( $cascadeSources, /* $restrictions */ ) = $this->mTitle->getCascadeProtectionSources();
        if ( $cascadeSources && count( $cascadeSources ) > 0 ) {
            $titles = '';

            foreach ( $cascadeSources as $title ) {
                $titles .= '* [[:' . $title->getPrefixedText() . "]]\n";
            }

            $out->wrapWikiMsg(
                "<div id=\"mw-protect-cascadeon\">\n$1\n" . $titles . "</div>",
                [ 'protect-cascadeon', count( $cascadeSources ) ]
            );
        }

        # Show an appropriate message if the user isn't allowed or able to change
        # the protection settings at this time
        if ( $this->disabled ) {
            $out->setPageTitle(
                $this->mContext->msg( 'protect-title-notallowed',
                    $this->mTitle->getPrefixedText() )
            );
            $out->addWikiTextAsInterface( $out->formatPermissionsErrorMessage(
                $this->mPermErrors, 'protect'
            ) );
        } else {
            $out->setPageTitle( $this->mContext->msg( 'protect-title', $this->mTitle->getPrefixedText() ) );
            $out->addWikiMsg( 'protect-text',
                wfEscapeWikiText( $this->mTitle->getPrefixedText() ) );
        }

        $out->addHTML( $this->buildForm() );
        $this->showLogExtract( $out );
    }

    function save() {
        # Permission check!
        if ( $this->disabled ) {
            $this->show();
            return false;
        }

        $request = $this->mContext->getRequest();
        $user = $this->mContext->getUser();
        $out = $this->mContext->getOutput();
        $token = $request->getVal( 'wpEditToken' );
        if ( !$user->matchEditToken( $token, [ 'protect', $this->mTitle->getPrefixedDBkey() ] ) ) {
            $this->show( [ 'sessionfailure' ] );
            return false;
        }

        # Create reason string. Use list and/or custom string.
        $reasonstr = $this->mReasonSelection;
        if ( $reasonstr != 'other' && $this->mReason != '' ) {
            // Entry from drop down menu + additional comment
            $reasonstr .= $this->mContext->msg( 'colon-separator' )->text() . $this->mReason;
        } elseif ( $reasonstr == 'other' ) {
            $reasonstr = $this->mReason;
        }
        $expiry = [];
        foreach ( $this->mApplicableTypes as $action ) {
            $expiry[$action] = $this->getExpiry( $action );
            if ( empty( $this->mRestrictions[$action] ) ) {
                continue; // unprotected
            }
            if ( !$expiry[$action] ) {
                $this->show( [ 'protect_expiry_invalid' ] );
                return false;
            }
            if ( $expiry[$action] < wfTimestampNow() ) {
                $this->show( [ 'protect_expiry_old' ] );
                return false;
            }
        }

        $this->mCascade = $request->getBool( 'mwProtect-cascade' );

        $status = $this->mArticle->doUpdateRestrictions(
            $this->mRestrictions,
            $expiry,
            $this->mCascade,
            $reasonstr,
            $user
        );

        if ( !$status->isOK() ) {
            $this->show( $out->parseInlineAsInterface( $status->getWikiText() ) );
            return false;
        }

        $errorMsg = '';
        if ( !Hooks::run( 'ProtectionForm::save', [ $this->mArticle, &$errorMsg, $reasonstr ] ) ) {
            if ( $errorMsg == '' ) {
                $errorMsg = [ 'hookaborted' ];
            }
        }
        if ( $errorMsg != '' ) {
            $this->show( $errorMsg );
            return false;
        }

        WatchAction::doWatchOrUnwatch( $request->getCheck( 'mwProtectWatch' ), $this->mTitle, $user );

        return true;
    }

    function buildForm() {
        $context = $this->mContext;
        $user = $context->getUser();
        $output = $context->getOutput();
        $lang = $context->getLanguage();
        $out = '';
        if ( !$this->disabled ) {
            $output->addModules( 'mediawiki.legacy.protect' );
            $out .= Xml::openElement( 'form', [ 'method' => 'post',
                'action' => $this->mTitle->getLocalURL( 'action=protect' ),
                'id' => 'mw-Protect-Form' ] );
        }

        $out .= Xml::openElement( 'fieldset' ) .
            Xml::element( 'legend', null, $context->msg( 'protect-legend' )->text() ) .
            Xml::openElement( 'table', [ 'id' => 'mwProtectSet' ] ) .
            Xml::openElement( 'tbody' );

        $scExpiryOptions = wfMessage( 'protect-expiry-options' )->inContentLanguage()->text();
        $showProtectOptions = $scExpiryOptions !== '-' && !$this->disabled;

        // Not all languages have V_x <-> N_x relation
        foreach ( $this->mRestrictions as $action => $selected ) {
            // Messages:
            // restriction-edit, restriction-move, restriction-create, restriction-upload
            $msg = $context->msg( 'restriction-' . $action );
            $out .= "<tr><td>" .
            Xml::openElement( 'fieldset' ) .
            Xml::element( 'legend', null, $msg->exists() ? $msg->text() : $action ) .
            Xml::openElement( 'table', [ 'id' => "mw-protect-table-$action" ] ) .
                "<tr><td>" . $this->buildSelector( $action, $selected ) . "</td></tr><tr><td>";

            $mProtectexpiry = Xml::label(
                $context->msg( 'protectexpiry' )->text(),
                "mwProtectExpirySelection-$action"
            );
            $mProtectother = Xml::label(
                $context->msg( 'protect-othertime' )->text(),
                "mwProtect-$action-expires"
            );

            $expiryFormOptions = new XmlSelect(
                "wpProtectExpirySelection-$action",
                "mwProtectExpirySelection-$action",
                $this->mExpirySelection[$action]
            );
            $expiryFormOptions->setAttribute( 'tabindex', '2' );
            if ( $this->disabled ) {
                $expiryFormOptions->setAttribute( 'disabled', 'disabled' );
            }

            if ( $this->mExistingExpiry[$action] ) {
                if ( $this->mExistingExpiry[$action] == 'infinity' ) {
                    $existingExpiryMessage = $context->msg( 'protect-existing-expiry-infinity' );
                } else {
                    $timestamp = $lang->userTimeAndDate( $this->mExistingExpiry[$action], $user );
                    $d = $lang->userDate( $this->mExistingExpiry[$action], $user );
                    $t = $lang->userTime( $this->mExistingExpiry[$action], $user );
                    $existingExpiryMessage = $context->msg(
                        'protect-existing-expiry',
                        $timestamp,
                        $d,
                        $t
                    );
                }
                $expiryFormOptions->addOption( $existingExpiryMessage->text(), 'existing' );
            }

            $expiryFormOptions->addOption(
                $context->msg( 'protect-othertime-op' )->text(),
                'othertime'
            );
            foreach ( explode( ',', $scExpiryOptions ) as $option ) {
                if ( strpos( $option, ":" ) === false ) {
                    $show = $value = $option;
                } else {
                    list( $show, $value ) = explode( ":", $option );
                }
                $expiryFormOptions->addOption( $show, htmlspecialchars( $value ) );
            }
            # Add expiry dropdown
            if ( $showProtectOptions && !$this->disabled ) {
                $out .= "
                    <table><tr>
                        <td class='mw-label'>
                            {$mProtectexpiry}
                        </td>
                        <td class='mw-input'>" .
                            $expiryFormOptions->getHTML() .
                        "</td>
                    </tr></table>";
            }
            # Add custom expiry field
            $attribs = [ 'id' => "mwProtect-$action-expires" ] + $this->disabledAttrib;
            $out .= "<table><tr>
                    <td class='mw-label'>" .
                        $mProtectother .
                    '</td>
                    <td class="mw-input">' .
                        Xml::input( "mwProtect-expiry-$action", 50, $this->mExpiry[$action], $attribs ) .
                    '</td>
                </tr></table>';
            $out .= "</td></tr>" .
            Xml::closeElement( 'table' ) .
            Xml::closeElement( 'fieldset' ) .
            "</td></tr>";
        }
        # Give extensions a chance to add items to the form
        Hooks::run( 'ProtectionForm::buildForm', [ $this->mArticle, &$out ] );

        $out .= Xml::closeElement( 'tbody' ) . Xml::closeElement( 'table' );

        // JavaScript will add another row with a value-chaining checkbox
        if ( $this->mTitle->exists() ) {
            $out .= Xml::openElement( 'table', [ 'id' => 'mw-protect-table2' ] ) .
                Xml::openElement( 'tbody' );
            $out .= '<tr>
                    <td></td>
                    <td class="mw-input">' .
                        Xml::checkLabel(
                            $context->msg( 'protect-cascade' )->text(),
                            'mwProtect-cascade',
                            'mwProtect-cascade',
                            $this->mCascade, $this->disabledAttrib
                        ) .
                    "</td>
                </tr>\n";
            $out .= Xml::closeElement( 'tbody' ) . Xml::closeElement( 'table' );
        }

        # Add manual and custom reason field/selects as well as submit
        if ( !$this->disabled ) {
            $mProtectreasonother = Xml::label(
                $context->msg( 'protectcomment' )->text(),
                'wpProtectReasonSelection'
            );

            $mProtectreason = Xml::label(
                $context->msg( 'protect-otherreason' )->text(),
                'mwProtect-reason'
            );

            $reasonDropDown = Xml::listDropDown( 'wpProtectReasonSelection',
                wfMessage( 'protect-dropdown' )->inContentLanguage()->text(),
                wfMessage( 'protect-otherreason-op' )->inContentLanguage()->text(),
                $this->mReasonSelection,
                'mwProtect-reason', 4 );

            // 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.
            // Subtract arbitrary 75 to leave some space for the autogenerated null edit's summary
            // and other texts chosen by dropdown menus on this page.
            $maxlength = CommentStore::COMMENT_CHARACTER_LIMIT - 75;

            $out .= Xml::openElement( 'table', [ 'id' => 'mw-protect-table3' ] ) .
                Xml::openElement( 'tbody' );
            $out .= "
                <tr>
                    <td class='mw-label'>
                        {$mProtectreasonother}
                    </td>
                    <td class='mw-input'>
                        {$reasonDropDown}
                    </td>
                </tr>
                <tr>
                    <td class='mw-label'>
                        {$mProtectreason}
                    </td>
                    <td class='mw-input'>" .
                        Xml::input( 'mwProtect-reason', 60, $this->mReason, [ 'type' => 'text',
                            'id' => 'mwProtect-reason', 'maxlength' => $maxlength ] ) .
                    "</td>
                </tr>";
            # Disallow watching is user is not logged in
            if ( $user->isLoggedIn() ) {
                $out .= "
                <tr>
                    <td></td>
                    <td class='mw-input'>" .
                        Xml::checkLabel( $context->msg( 'watchthis' )->text(),
                            'mwProtectWatch', 'mwProtectWatch',
                            $user->isWatched( $this->mTitle ) || $user->getOption( 'watchdefault' ) ) .
                    "</td>
                </tr>";
            }
            $out .= "
                <tr>
                    <td></td>
                    <td class='mw-submit'>" .
                        Xml::submitButton(
                            $context->msg( 'confirm' )->text(),
                            [ 'id' => 'mw-Protect-submit' ]
                        ) .
                    "</td>
                </tr>\n";
            $out .= Xml::closeElement( 'tbody' ) . Xml::closeElement( 'table' );
        }
        $out .= Xml::closeElement( 'fieldset' );

        if ( $user->isAllowed( 'editinterface' ) ) {
            $linkRenderer = MediaWikiServices::getInstance()->getLinkRenderer();
            $link = $linkRenderer->makeKnownLink(
                $context->msg( 'protect-dropdown' )->inContentLanguage()->getTitle(),
                $context->msg( 'protect-edit-reasonlist' )->text(),
                [],
                [ 'action' => 'edit' ]
            );
            $out .= '<p class="mw-protect-editreasons">' . $link . '</p>';
        }

        if ( !$this->disabled ) {
            $out .= Html::hidden(
                'wpEditToken',
                $user->getEditToken( [ 'protect', $this->mTitle->getPrefixedDBkey() ] )
            );
            $out .= Xml::closeElement( 'form' );
        }

        return $out;
    }

    function buildSelector( $action, $selected ) {
        // If the form is disabled, display all relevant levels. Otherwise,
        // just show the ones this user can use.
        $levels = MWNamespace::getRestrictionLevels( $this->mTitle->getNamespace(),
            $this->disabled ? null : $this->mContext->getUser()
        );

        $id = 'mwProtect-level-' . $action;

        $select = new XmlSelect( $id, $id, $selected );
        $select->setAttribute( 'size', count( $levels ) );
        if ( $this->disabled ) {
            $select->setAttribute( 'disabled', 'disabled' );
        }

        foreach ( $levels as $key ) {
            $select->addOption( $this->getOptionLabel( $key ), $key );
        }

        return $select->getHTML();
    }

    private function getOptionLabel( $permission ) {
        if ( $permission == '' ) {
            return $this->mContext->msg( 'protect-default' )->text();
        } else {
            // Messages: protect-level-autoconfirmed, protect-level-sysop
            $msg = $this->mContext->msg( "protect-level-{$permission}" );
            if ( $msg->exists() ) {
                return $msg->text();
            }
            return $this->mContext->msg( 'protect-fallback', $permission )->text();
        }
    }

    private function showLogExtract( OutputPage $out ) {
        # Show relevant lines from the protection log:
        $protectLogPage = new LogPage( 'protect' );
        $out->addHTML( Xml::element( 'h2', null, $protectLogPage->getName()->text() ) );
        LogEventsList::showLogExtract( $out, 'protect', $this->mTitle );
        # Let extensions add other relevant log extracts
        Hooks::run( 'ProtectionForm::showLogExtract', [ $this->mArticle, $out ] );
    }
}