RevDelList.php

Go to the documentation of this file.

<?php
abstract class RevDelList extends RevisionListBase {
    function __construct( IContextSource $context, Title $title, array $ids ) {
        parent::__construct( $context, $title );
        $this->ids = $ids;
    }

    public static function getRelationType() {
        return null;
    }

    public static function getRestriction() {
        return null;
    }

    public static function getRevdelConstant() {
        return null;
    }

    public static function suggestTarget( $target, array $ids ) {
        return $target;
    }

    public function setVisibility( $params ) {
        $bitPars = $params['value'];
        $comment = $params['comment'];
        $perItemStatus = isset( $params['perItemStatus'] ) ? $params['perItemStatus'] : false;

        $this->res = false;
        $dbw = wfGetDB( DB_MASTER );
        $this->doQuery( $dbw );
        $dbw->begin( __METHOD__ );
        $status = Status::newGood();
        $missing = array_flip( $this->ids );
        $this->clearFileOps();
        $idsForLog = array();
        $authorIds = $authorIPs = array();

        if ( $perItemStatus ) {
            $status->itemStatuses = array();
        }

        // @codingStandardsIgnoreStart Generic.CodeAnalysis.ForLoopWithTestFunctionCall.NotAllowed
        for ( $this->reset(); $this->current(); $this->next() ) {
            // @codingStandardsIgnoreEnd
            $item = $this->current();
            unset( $missing[$item->getId()] );

            if ( $perItemStatus ) {
                $itemStatus = Status::newGood();
                $status->itemStatuses[$item->getId()] = $itemStatus;
            } else {
                $itemStatus = $status;
            }

            $oldBits = $item->getBits();
            // Build the actual new rev_deleted bitfield
            $newBits = RevisionDeleter::extractBitfield( $bitPars, $oldBits );

            if ( $oldBits == $newBits ) {
                $itemStatus->warning( 'revdelete-no-change', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            } elseif ( $oldBits == 0 && $newBits != 0 ) {
                $opType = 'hide';
            } elseif ( $oldBits != 0 && $newBits == 0 ) {
                $opType = 'show';
            } else {
                $opType = 'modify';
            }

            if ( $item->isHideCurrentOp( $newBits ) ) {
                // Cannot hide current version text
                $itemStatus->error( 'revdelete-hide-current', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            }
            if ( !$item->canView() ) {
                // Cannot access this revision
                $msg = ( $opType == 'show' ) ?
                    'revdelete-show-no-access' : 'revdelete-modify-no-access';
                $itemStatus->error( $msg, $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            }
            // Cannot just "hide from Sysops" without hiding any fields
            if ( $newBits == Revision::DELETED_RESTRICTED ) {
                $itemStatus->warning( 'revdelete-only-restricted', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
                continue;
            }

            // Update the revision
            $ok = $item->setBits( $newBits );

            if ( $ok ) {
                $idsForLog[] = $item->getId();
                $status->successCount++;
                if ( $item->getAuthorId() > 0 ) {
                    $authorIds[] = $item->getAuthorId();
                } elseif ( IP::isIPAddress( $item->getAuthorName() ) ) {
                    $authorIPs[] = $item->getAuthorName();
                }
            } else {
                $itemStatus->error( 'revdelete-concurrent-change', $item->formatDate(), $item->formatTime() );
                $status->failCount++;
            }
        }

        // Handle missing revisions
        foreach ( $missing as $id => $unused ) {
            if ( $perItemStatus ) {
                $status->itemStatuses[$id] = Status::newFatal( 'revdelete-modify-missing', $id );
            } else {
                $status->error( 'revdelete-modify-missing', $id );
            }
            $status->failCount++;
        }

        if ( $status->successCount == 0 ) {
            $dbw->rollback( __METHOD__ );
            return $status;
        }

        // Save success count
        $successCount = $status->successCount;

        // Move files, if there are any
        $status->merge( $this->doPreCommitUpdates() );
        if ( !$status->isOK() ) {
            // Fatal error, such as no configured archive directory
            $dbw->rollback( __METHOD__ );
            return $status;
        }

        // Log it
        $this->updateLog( array(
            'title' => $this->title,
            'count' => $successCount,
            'newBits' => $newBits,
            'oldBits' => $oldBits,
            'comment' => $comment,
            'ids' => $idsForLog,
            'authorIds' => $authorIds,
            'authorIPs' => $authorIPs
        ) );
        $dbw->commit( __METHOD__ );

        // Clear caches
        $status->merge( $this->doPostCommitUpdates() );
        return $status;
    }

    function reloadFromMaster() {
        $dbw = wfGetDB( DB_MASTER );
        $this->res = $this->doQuery( $dbw );
    }

    protected function updateLog( $params ) {
        // Get the URL param's corresponding DB field
        $field = RevisionDeleter::getRelationType( $this->getType() );
        if ( !$field ) {
            throw new MWException( "Bad log URL param type!" );
        }
        // Put things hidden from sysops in the oversight log
        if ( ( $params['newBits'] | $params['oldBits'] ) & $this->getSuppressBit() ) {
            $logType = 'suppress';
        } else {
            $logType = 'delete';
        }
        // Add params for effected page and ids
        $logParams = $this->getLogParams( $params );
        // Actually add the deletion log entry
        $log = new LogPage( $logType );
        $logid = $log->addEntry( $this->getLogAction(), $params['title'],
            $params['comment'], $logParams, $this->getUser() );
        // Allow for easy searching of deletion log items for revision/log items
        $log->addRelations( $field, $params['ids'], $logid );
        $log->addRelations( 'target_author_id', $params['authorIds'], $logid );
        $log->addRelations( 'target_author_ip', $params['authorIPs'], $logid );
    }

    public function getLogAction() {
        return 'revision';
    }

    public function getLogParams( $params ) {
        return array(
            $this->getType(),
            implode( ',', $params['ids'] ),
            "ofield={$params['oldBits']}",
            "nfield={$params['newBits']}"
        );
    }

    public function clearFileOps() {
    }

    public function doPreCommitUpdates() {
        return Status::newGood();
    }

    public function doPostCommitUpdates() {
        return Status::newGood();
    }

    abstract public function getSuppressBit();
}