SpecialRevisionDelete.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Specials;
 
use MediaWiki\CommentStore\CommentStore;
use MediaWiki\Exception\ErrorPageError;
use MediaWiki\Exception\PermissionsError;
use MediaWiki\Exception\UserBlockedError;
use MediaWiki\FileRepo\File\File;
use MediaWiki\FileRepo\RepoGroup;
use MediaWiki\Html\Html;
use MediaWiki\HTMLForm\HTMLForm;
use MediaWiki\Logging\LogEventsList;
use MediaWiki\Logging\LogPage;
use MediaWiki\Permissions\PermissionManager;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\SpecialPage\SpecialPage;
use MediaWiki\SpecialPage\UnlistedSpecialPage;
use MediaWiki\Status\Status;
use MediaWiki\Title\Title;
use RevDelList;
use RevisionDeleter;
 
class SpecialRevisionDelete extends UnlistedSpecialPage {
    protected $wasSaved = false;
 
    private $submitClicked;
 
    private $ids;
 
    private $archiveName;
 
    private $token;
 
    private $targetObj;
 
    private $typeName;
 
    private $checks;
 
    private $typeLabels;
 
    private $revDelList;
 
    private $mIsAllowed;
 
    private $otherReason;
 
    private PermissionManager $permissionManager;
    private RepoGroup $repoGroup;
 
    private const UI_LABELS = [
        'revision' => [
            'check-label' => 'revdelete-hide-text',
            'success' => 'revdelete-success',
            'failure' => 'revdelete-failure',
            'text' => 'revdelete-text-text',
            'selected' => 'revdelete-selected-text',
        ],
        'archive' => [
            'check-label' => 'revdelete-hide-text',
            'success' => 'revdelete-success',
            'failure' => 'revdelete-failure',
            'text' => 'revdelete-text-text',
            'selected' => 'revdelete-selected-text',
        ],
        'oldimage' => [
            'check-label' => 'revdelete-hide-image',
            'success' => 'revdelete-success',
            'failure' => 'revdelete-failure',
            'text' => 'revdelete-text-file',
            'selected' => 'revdelete-selected-file',
        ],
        'filearchive' => [
            'check-label' => 'revdelete-hide-image',
            'success' => 'revdelete-success',
            'failure' => 'revdelete-failure',
            'text' => 'revdelete-text-file',
            'selected' => 'revdelete-selected-file',
        ],
        'logging' => [
            'check-label' => 'revdelete-hide-name',
            'success' => 'logdelete-success',
            'failure' => 'logdelete-failure',
            'text' => 'logdelete-text',
            'selected' => 'logdelete-selected',
        ],
    ];
 
    public function __construct( PermissionManager $permissionManager, RepoGroup $repoGroup ) {
        parent::__construct( 'Revisiondelete' );
 
        $this->permissionManager = $permissionManager;
        $this->repoGroup = $repoGroup;
    }
 
    public function doesWrites() {
        return true;
    }
 
    public function execute( $par ) {
        $this->useTransactionalTimeLimit();
 
        $this->checkPermissions();
        $this->checkReadOnly();
 
        $output = $this->getOutput();
        $user = $this->getUser();
 
        $this->setHeaders();
        $this->outputHeader();
        $request = $this->getRequest();
        $this->submitClicked = $request->wasPosted() && $request->getBool( 'wpSubmit' );
        # Handle our many different possible input types.
        $ids = $request->getVal( 'ids' );
        if ( $ids !== null ) {
            # Allow CSV, for backwards compatibility, or a single ID for show/hide links
            $this->ids = explode( ',', $ids );
        } else {
            # Array input
            $this->ids = array_keys( $request->getArray( 'ids', [] ) );
        }
        // $this->ids = array_map( 'intval', $this->ids );
        $this->ids = array_unique( array_filter( $this->ids ) );
 
        $this->typeName = $request->getVal( 'type' );
        $this->targetObj = Title::newFromText( $request->getText( 'target' ) );
 
        # For reviewing deleted files...
        $this->archiveName = $request->getVal( 'file' );
        $this->token = $request->getVal( 'token' );
        if ( $this->archiveName && $this->targetObj ) {
            $this->tryShowFile( $this->archiveName );
 
            return;
        }
 
        $this->typeName = RevisionDeleter::getCanonicalTypeName( $this->typeName );
 
        # No targets?
        if ( !$this->typeName || count( $this->ids ) == 0 ) {
            throw new ErrorPageError( 'revdelete-nooldid-title', 'revdelete-nooldid-text' );
        }
 
        $restriction = RevisionDeleter::getRestriction( $this->typeName );
 
        if ( !$this->getAuthority()->isAllowedAny( $restriction, 'deletedhistory' ) ) {
            throw new PermissionsError( $restriction );
        }
 
        # Allow the list type to adjust the passed target
        $this->targetObj = RevisionDeleter::suggestTarget(
            $this->typeName,
            $this->targetObj,
            $this->ids
        );
 
        # We need a target page!
        if ( $this->targetObj === null ) {
            $output->addWikiMsg( 'undelete-header' );
 
            return;
        }
 
        // Check blocks
        $checkReplica = !$this->submitClicked;
        if (
            $this->permissionManager->isBlockedFrom(
                $user,
                $this->targetObj,
                $checkReplica
            )
        ) {
            throw new UserBlockedError(
                // @phan-suppress-next-line PhanTypeMismatchArgumentNullable Block is checked and not null
                $user->getBlock(),
                $user,
                $this->getLanguage(),
                $request->getIP()
            );
        }
 
        $this->typeLabels = self::UI_LABELS[$this->typeName];
        $list = $this->getList();
        $list->reset();
        $this->mIsAllowed = $this->permissionManager->userHasRight( $user, $restriction );
        $canViewSuppressedOnly = $this->permissionManager->userHasRight( $user, 'viewsuppressed' ) &&
            !$this->permissionManager->userHasRight( $user, 'suppressrevision' );
        $pageIsSuppressed = $list->areAnySuppressed();
        $this->mIsAllowed = $this->mIsAllowed && !( $canViewSuppressedOnly && $pageIsSuppressed );
 
        $this->otherReason = $request->getVal( 'wpReason', '' );
        # Give a link to the logs/hist for this page
        $this->showConvenienceLinks();
 
        # Initialise checkboxes
        $this->checks = [
            # Messages: revdelete-hide-text, revdelete-hide-image, revdelete-hide-name
            [ $this->typeLabels['check-label'], 'wpHidePrimary',
                RevisionDeleter::getRevdelConstant( $this->typeName )
            ],
            [ 'revdelete-hide-comment', 'wpHideComment', RevisionRecord::DELETED_COMMENT ],
            [ 'revdelete-hide-user', 'wpHideUser', RevisionRecord::DELETED_USER ]
        ];
        if ( $this->permissionManager->userHasRight( $user, 'suppressrevision' ) ) {
            $this->checks[] = [ 'revdelete-hide-restricted',
                'wpHideRestricted', RevisionRecord::DELETED_RESTRICTED ];
        }
 
        # Either submit or create our form
        if ( $this->mIsAllowed && $this->submitClicked ) {
            $this->submit();
        } else {
            $this->showForm();
        }
 
        if ( $this->permissionManager->userHasRight( $user, 'deletedhistory' ) ) {
            # Show relevant lines from the deletion log
            $deleteLogPage = new LogPage( 'delete' );
            $output->addHTML( "<h2>" . $deleteLogPage->getName()->escaped() . "</h2>\n" );
            LogEventsList::showLogExtract(
                $output,
                'delete',
                $this->targetObj,
                '', /* user */
                [ 'lim' => 25, 'conds' => $this->getLogQueryCond(), 'useMaster' => $this->wasSaved ]
            );
        }
        # Show relevant lines from the suppression log
        if ( $this->permissionManager->userHasRight( $user, 'suppressionlog' ) ) {
            $suppressLogPage = new LogPage( 'suppress' );
            $output->addHTML( "<h2>" . $suppressLogPage->getName()->escaped() . "</h2>\n" );
            LogEventsList::showLogExtract(
                $output,
                'suppress',
                $this->targetObj,
                '',
                [ 'lim' => 25, 'conds' => $this->getLogQueryCond(), 'useMaster' => $this->wasSaved ]
            );
        }
    }
 
    protected function showConvenienceLinks() {
        $linkRenderer = $this->getLinkRenderer();
        # Give a link to the logs/hist for this page
        if ( $this->targetObj ) {
            // Also set header tabs to be for the target.
            $this->getSkin()->setRelevantTitle( $this->targetObj );
 
            $links = [];
            $links[] = $linkRenderer->makeKnownLink(
                SpecialPage::getTitleFor( 'Log' ),
                $this->msg( 'viewpagelogs' )->text(),
                [],
                [ 'page' => $this->targetObj->getPrefixedText() ]
            );
            if ( !$this->targetObj->isSpecialPage() ) {
                # Give a link to the page history
                $links[] = $linkRenderer->makeKnownLink(
                    $this->targetObj,
                    $this->msg( 'pagehist' )->text(),
                    [],
                    [ 'action' => 'history' ]
                );
                # Link to deleted edits
                if ( $this->permissionManager->userHasRight( $this->getUser(), 'undelete' ) ) {
                    $undelete = SpecialPage::getTitleFor( 'Undelete' );
                    $links[] = $linkRenderer->makeKnownLink(
                        $undelete,
                        $this->msg( 'deletedhist' )->text(),
                        [],
                        [ 'target' => $this->targetObj->getPrefixedDBkey() ]
                    );
                }
            }
            # Logs themselves don't have histories or archived revisions
            $this->getOutput()->addSubtitle( $this->getLanguage()->pipeList( $links ) );
        }
    }
 
    protected function getLogQueryCond() {
        $conds = [];
        // Revision delete logs for these item
        $conds['log_type'] = [ 'delete', 'suppress' ];
        $conds['log_action'] = $this->getList()->getLogAction();
        $conds['ls_field'] = RevisionDeleter::getRelationType( $this->typeName );
        // Convert IDs to strings, since ls_value is a text field. This avoids
        // a fatal error in PostgreSQL: "operator does not exist: text = integer".
        $conds['ls_value'] = array_map( 'strval', $this->ids );
 
        return $conds;
    }
 
    protected function tryShowFile( $archiveName ) {
        $repo = $this->repoGroup->getLocalRepo();
        $oimage = $repo->newFromArchiveName( $this->targetObj, $archiveName );
        $oimage->load();
        // Check if user is allowed to see this file
        if ( !$oimage->exists() ) {
            $this->getOutput()->addWikiMsg( 'revdelete-no-file' );
 
            return;
        }
        $user = $this->getUser();
        if ( !$oimage->userCan( File::DELETED_FILE, $user ) ) {
            if ( $oimage->isDeleted( File::DELETED_RESTRICTED ) ) {
                throw new PermissionsError( 'suppressrevision' );
            } else {
                throw new PermissionsError( 'deletedtext' );
            }
        }
        if ( !$user->matchEditToken( $this->token, $archiveName ) ) {
            $lang = $this->getLanguage();
            $this->getOutput()->addWikiMsg( 'revdelete-show-file-confirm',
                $this->targetObj->getText(),
                $lang->userDate( $oimage->getTimestamp(), $user ),
                $lang->userTime( $oimage->getTimestamp(), $user ) );
            $this->getOutput()->addHTML(
                Html::rawElement( 'form', [
                    'method' => 'POST',
                    'action' => $this->getPageTitle()->getLocalURL( [
                            'target' => $this->targetObj->getPrefixedDBkey(),
                            'file' => $archiveName,
                            'token' => $user->getEditToken( $archiveName ),
                        ] )
                    ],
                    Html::submitButton( $this->msg( 'revdelete-show-file-submit' )->text() )
                )
            );
 
            return;
        }
        $this->getOutput()->disable();
        # We mustn't allow the output to be CDN cached, otherwise
        # if an admin previews a deleted image, and it's cached, then
        # a user without appropriate permissions can toddle off and
        # nab the image, and CDN will serve it
        $this->getRequest()->response()->header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', 0 ) . ' GMT' );
        $this->getRequest()->response()->header(
            'Cache-Control: no-cache, no-store, max-age=0, must-revalidate'
        );
 
        $key = $oimage->getStorageKey();
        $path = $repo->getZonePath( 'deleted' ) . '/' . $repo->getDeletedHashPath( $key ) . $key;
        $repo->streamFileWithStatus( $path );
    }
 
    protected function getList() {
        if ( $this->revDelList === null ) {
            $this->revDelList = RevisionDeleter::createList(
                $this->typeName, $this->getContext(), $this->targetObj, $this->ids
            );
        }
 
        return $this->revDelList;
    }
 
    protected function showForm() {
        $userAllowed = true;
 
        // Messages: revdelete-selected-text, revdelete-selected-file, logdelete-selected
        $out = $this->getOutput();
        $out->wrapWikiMsg( "<strong>$1</strong>", [ $this->typeLabels['selected'],
            $this->getLanguage()->formatNum( count( $this->ids ) ), $this->targetObj->getPrefixedText() ] );
 
        $this->addHelpLink( 'Help:RevisionDelete' );
        $out->addHTML( "<ul>" );
 
        $numRevisions = 0;
        // Live revisions...
        $list = $this->getList();
        for ( $list->reset(); $list->current(); $list->next() ) {
            $item = $list->current();
 
            if ( !$item->canView() ) {
                if ( !$this->submitClicked ) {
                    throw new PermissionsError( 'suppressrevision' );
                }
                $userAllowed = false;
            }
 
            $numRevisions++;
            $out->addHTML( $item->getHTML() );
        }
 
        if ( !$numRevisions ) {
            throw new ErrorPageError( 'revdelete-nooldid-title', 'revdelete-nooldid-text' );
        }
 
        $out->addHTML( "</ul>" );
        // Explanation text
        $this->addUsageText();
 
        // Normal sysops can always see what they did, but can't always change it
        if ( !$userAllowed ) {
            return;
        }
 
        // Show form if the user can submit
        if ( $this->mIsAllowed ) {
            $suppressAllowed = $this->permissionManager
                ->userHasRight( $this->getUser(), 'suppressrevision' );
            $out->addModules( [ 'mediawiki.misc-authed-ooui' ] );
            $out->addModuleStyles( [ 'mediawiki.special',
                'mediawiki.interface.helpers.styles' ] );
 
            $dropdownReason = $this->msg( 'revdelete-reason-dropdown' )
                ->page( $this->targetObj )->inContentLanguage()->text();
            // Add additional specific reasons for suppress
            if ( $suppressAllowed ) {
                $dropdownReason .= "\n" . $this->msg( 'revdelete-reason-dropdown-suppress' )
                    ->page( $this->targetObj )->inContentLanguage()->text();
            }
 
            $fields = $this->buildCheckBoxes();
 
            $fields[] = [
                'type' => 'select',
                'label' => $this->msg( 'revdelete-log' )->text(),
                'cssclass' => 'wpReasonDropDown',
                'id' => 'wpRevDeleteReasonList',
                'name' => 'wpRevDeleteReasonList',
                'options' => Html::listDropdownOptions(
                    $dropdownReason,
                    [ 'other' => $this->msg( 'revdelete-reasonotherlist' )->text() ]
                ),
                'default' => $this->getRequest()->getText( 'wpRevDeleteReasonList', 'other' )
            ];
 
            $fields[] = [
                'type' => 'text',
                'label' => $this->msg( 'revdelete-otherreason' )->text(),
                'name' => 'wpReason',
                'id' => 'wpReason',
                // 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.
                // "- 155" is to leave room for the 'wpRevDeleteReasonList' value.
                'maxlength' => CommentStore::COMMENT_CHARACTER_LIMIT - 155,
            ];
 
            $fields[] = [
                'type' => 'hidden',
                'name' => 'wpEditToken',
                'default' => $this->getUser()->getEditToken()
            ];
 
            $fields[] = [
                'type' => 'hidden',
                'name' => 'target',
                'default' => $this->targetObj->getPrefixedText()
            ];
 
            $fields[] = [
                'type' => 'hidden',
                'name' => 'type',
                'default' => $this->typeName
            ];
 
            $fields[] = [
                'type' => 'hidden',
                'name' => 'ids',
                'default' => implode( ',', $this->ids )
            ];
 
            $htmlForm = HTMLForm::factory( 'ooui', $fields, $this->getContext() );
            $htmlForm
                ->setSubmitText( $this->msg( 'revdelete-submit', $numRevisions )->text() )
                ->setSubmitName( 'wpSubmit' )
                ->setWrapperLegend( $this->msg( 'revdelete-legend' )->text() )
                ->setAction( $this->getPageTitle()->getLocalURL( [ 'action' => 'submit' ] ) )
                ->loadData();
            // Show link to edit the dropdown reasons
            if ( $this->permissionManager->userHasRight( $this->getUser(), 'editinterface' ) ) {
                $link = '';
                $linkRenderer = $this->getLinkRenderer();
                if ( $suppressAllowed ) {
                    $link .= $linkRenderer->makeKnownLink(
                        $this->msg( 'revdelete-reason-dropdown-suppress' )->inContentLanguage()->getTitle(),
                        $this->msg( 'revdelete-edit-reasonlist-suppress' )->text(),
                        [],
                        [ 'action' => 'edit' ]
                    );
                    $link .= $this->msg( 'pipe-separator' )->escaped();
                }
                $link .= $linkRenderer->makeKnownLink(
                    $this->msg( 'revdelete-reason-dropdown' )->inContentLanguage()->getTitle(),
                    $this->msg( 'revdelete-edit-reasonlist' )->text(),
                    [],
                    [ 'action' => 'edit' ]
                );
                $htmlForm->setPostHtml( Html::rawElement( 'p', [ 'class' => 'mw-revdel-editreasons' ], $link ) );
            }
            $out->addHTML( $htmlForm->getHTML( false ) );
        }
    }
 
    protected function addUsageText() {
        // Messages: revdelete-text-text, revdelete-text-file, logdelete-text
        $this->getOutput()->wrapWikiMsg(
            "<strong>$1</strong>\n$2", $this->typeLabels['text'],
            'revdelete-text-others'
        );
 
        if ( $this->permissionManager->userHasRight( $this->getUser(), 'suppressrevision' ) ) {
            $this->getOutput()->addWikiMsg( 'revdelete-suppress-text' );
        }
 
        if ( $this->mIsAllowed ) {
            $this->getOutput()->addWikiMsg( 'revdelete-confirm' );
        }
    }
 
    protected function buildCheckBoxes() {
        $fields = [];
 
        $type = 'radio';
 
        $list = $this->getList();
 
        // If there is just one item, use checkboxes
        if ( $list->length() == 1 ) {
            $list->reset();
 
            $type = 'check';
        }
 
        foreach ( $this->checks as $item ) {
            // Messages: revdelete-hide-text, revdelete-hide-image, revdelete-hide-name,
            // revdelete-hide-comment, revdelete-hide-user, revdelete-hide-restricted
            [ $message, $name, $bitField ] = $item;
 
            $field = [
                'type' => $type,
                'label-raw' => $this->msg( $message )->escaped(),
                'id' => $name,
                'flatlist' => true,
                'name' => $name,
                'default' => $list->length() == 1 ? $list->current()->getBits() & $bitField : null
            ];
 
            if ( $bitField == RevisionRecord::DELETED_RESTRICTED ) {
                $field['label-raw'] = "<b>" . $field['label-raw'] . "</b>";
                if ( $type === 'radio' ) {
                    $field['options-messages'] = [
                        'revdelete-radio-same' => -1,
                        'revdelete-radio-unset-suppress' => 0,
                        'revdelete-radio-set-suppress' => 1
                    ];
                }
            } elseif ( $type === 'radio' ) {
                $field['options-messages'] = [
                    'revdelete-radio-same' => -1,
                    'revdelete-radio-unset' => 0,
                    'revdelete-radio-set' => 1
                ];
            }
 
            $fields[] = $field;
        }
 
        return $fields;
    }
 
    protected function submit() {
        # Check edit token on submission
        $token = $this->getRequest()->getVal( 'wpEditToken' );
        if ( $this->submitClicked && !$this->getUser()->matchEditToken( $token ) ) {
            $this->getOutput()->addWikiMsg( 'sessionfailure' );
 
            return false;
        }
        $bitParams = $this->extractBitParams();
        // from dropdown
        $listReason = $this->getRequest()->getText( 'wpRevDeleteReasonList', 'other' );
        $comment = $listReason;
        if ( $comment === 'other' ) {
            $comment = $this->otherReason;
        } elseif ( $this->otherReason !== '' ) {
            // Entry from drop down menu + additional comment
            $comment .= $this->msg( 'colon-separator' )->inContentLanguage()->text()
                . $this->otherReason;
        }
        # Can the user set this field?
        if ( $bitParams[RevisionRecord::DELETED_RESTRICTED] == 1
            && !$this->permissionManager->userHasRight( $this->getUser(), 'suppressrevision' )
        ) {
            throw new PermissionsError( 'suppressrevision' );
        }
        # If the save went through, go to success message...
        $status = $this->save( $bitParams, $comment );
        if ( $status->isGood() ) {
            $this->success();
 
            return true;
        } else {
            # ...otherwise, bounce back to form...
            $this->failure( $status );
        }
 
        return false;
    }
 
    protected function success() {
        // Messages: revdelete-success, logdelete-success
        $out = $this->getOutput();
        $out->setPageTitleMsg( $this->msg( 'actioncomplete' ) );
        $out->addHTML(
            Html::successBox(
                $out->msg( $this->typeLabels['success'] )->parse()
            )
        );
        $this->wasSaved = true;
        $this->revDelList->reloadFromPrimary();
        $this->showForm();
    }
 
    protected function failure( $status ) {
        // Messages: revdelete-failure, logdelete-failure
        $out = $this->getOutput();
        $out->setPageTitleMsg( $this->msg( 'actionfailed' ) );
        $out->addModuleStyles( 'mediawiki.codex.messagebox.styles' );
        $out->addHTML(
            Html::errorBox(
                $out->parseAsContent(
                    $status->getWikiText( $this->typeLabels['failure'], false, $this->getLanguage() )
                )
            )
        );
        $this->showForm();
    }
 
    protected function extractBitParams() {
        $bitfield = [];
        foreach ( $this->checks as [ /* message */, $name, $field ] ) {
            $val = $this->getRequest()->getInt( $name, 0 /* unchecked */ );
            if ( $val < -1 || $val > 1 ) {
                $val = -1; // -1 for existing value
            }
            $bitfield[$field] = $val;
        }
        if ( !isset( $bitfield[RevisionRecord::DELETED_RESTRICTED] ) ) {
            $bitfield[RevisionRecord::DELETED_RESTRICTED] = 0;
        }
 
        return $bitfield;
    }
 
    protected function save( array $bitPars, $reason ) {
        return $this->getList()->setVisibility(
            [ 'value' => $bitPars, 'comment' => $reason ]
        );
    }
 
    protected function getGroupName() {
        return 'pagetools';
    }
}
 
class_alias( SpecialRevisionDelete::class, 'SpecialRevisionDelete' );