DeleteLogFormatter.php

Go to the documentation of this file.

<?php
namespace MediaWiki\Logging;
 
use MediaWiki\Api\ApiResult;
use MediaWiki\Message\Message;
use MediaWiki\Revision\RevisionRecord;
use MediaWiki\RevisionDelete\RevisionDeleter;
use MediaWiki\SpecialPage\SpecialPage;
 
class DeleteLogFormatter extends LogFormatter {
    private $parsedParametersDeleteLog;
 
    protected function getMessageKey() {
        $key = parent::getMessageKey();
        if ( in_array( $this->entry->getSubtype(), [ 'event', 'revision' ] ) ) {
            if ( count( $this->getMessageParameters() ) < 5 ) {
                // Messages: logentry-delete-event-legacy, logentry-delete-revision-legacy,
                // logentry-suppress-event-legacy, logentry-suppress-revision-legacy
                return "$key-legacy";
            }
        } elseif ( $this->entry->getSubtype() === 'restore' ) {
            $rawParams = $this->entry->getParameters();
            if ( !isset( $rawParams[':assoc:count'] ) ) {
                // Message: logentry-delete-restore-nocount
                return $key . '-nocount';
            }
        }
 
        return $key;
    }
 
    protected function getMessageParameters() {
        if ( $this->parsedParametersDeleteLog !== null ) {
            return $this->parsedParametersDeleteLog;
        }
 
        $params = parent::getMessageParameters();
        $subtype = $this->entry->getSubtype();
        if ( in_array( $subtype, [ 'event', 'revision' ] ) ) {
            // $params[3] here is 'revision' or 'archive' for page revisions, 'oldimage' or
            // 'filearchive' for file versions, or a comma-separated list of log_ids for log
            // entries. $subtype here is 'revision' for page revisions and file
            // versions, or 'event' for log entries.
            if (
                ( $subtype === 'event' && count( $params ) === 6 )
                || (
                    $subtype === 'revision' && isset( $params[3] ) && count( $params ) === 7
                    && in_array( $params[3], [ 'revision', 'archive', 'oldimage', 'filearchive' ] )
                )
            ) {
                // See RevDelList::getLogParams()/RevDelLogList::getLogParams()
                $paramStart = $subtype === 'revision' ? 4 : 3;
 
                $old = $this->parseBitField( $params[$paramStart + 1] );
                $new = $this->parseBitField( $params[$paramStart + 2] );
                [ $hid, $unhid, $extra ] = RevisionDeleter::getChanges( $new, $old );
                $changes = [];
                // messages used: revdelete-content-hid, revdelete-summary-hid, revdelete-uname-hid
                foreach ( $hid as $v ) {
                    $changes[] = $this->msg( "$v-hid" )->plain();
                }
                // messages used: revdelete-content-unhid, revdelete-summary-unhid,
                // revdelete-uname-unhid
                foreach ( $unhid as $v ) {
                    $changes[] = $this->msg( "$v-unhid" )->plain();
                }
                foreach ( $extra as $v ) {
                    $changes[] = $this->msg( $v )->plain();
                }
                $changeText = Message::listParam( $changes );
 
                $newParams = array_slice( $params, 0, 3 );
                $newParams[3] = $changeText;
                $ids = is_array( $params[$paramStart] )
                    ? $params[$paramStart]
                    : explode( ',', $params[$paramStart] );
                $newParams[4] = $this->context->getLanguage()->formatNum( count( $ids ) );
 
                $this->parsedParametersDeleteLog = $newParams;
                return $this->parsedParametersDeleteLog;
            } else {
                $this->parsedParametersDeleteLog = array_slice( $params, 0, 3 );
                return $this->parsedParametersDeleteLog;
            }
        } elseif ( $subtype === 'restore' ) {
            $rawParams = $this->entry->getParameters();
            if ( isset( $rawParams[':assoc:count'] ) ) {
                $countList = [];
                foreach ( $rawParams[':assoc:count'] as $type => $count ) {
                    if ( $count ) {
                        // Messages: restore-count-revisions, restore-count-files
                        $countList[] = $this->context->msg( 'restore-count-' . $type )
                            ->numParams( $count )->plain();
                    }
                }
                $params[3] = Message::listParam( $countList );
            }
        }
 
        $this->parsedParametersDeleteLog = $params;
        return $this->parsedParametersDeleteLog;
    }
 
    protected function parseBitField( string $string ): int {
        // Input is like ofield=2134 or just the number
        if ( strpos( $string, 'field=' ) === 1 ) {
            [ , $field ] = explode( '=', $string );
 
            return (int)$field;
        } else {
            return (int)$string;
        }
    }
 
    public function getActionLinks() {
        $linkRenderer = $this->getLinkRenderer();
        if ( !$this->context->getAuthority()->isAllowed( 'deletedhistory' )
            || $this->entry->isDeleted( LogPage::DELETED_ACTION )
        ) {
            return '';
        }
 
        switch ( $this->entry->getSubtype() ) {
            case 'delete': // Show undelete link
            case 'delete_redir':
            case 'delete_redir2':
                if ( $this->context->getAuthority()->isAllowed( 'undelete' ) ) {
                    $message = 'undeletelink';
                } else {
                    $message = 'undeleteviewlink';
                }
                $revert = $linkRenderer->makeKnownLink(
                    SpecialPage::getTitleFor( 'Undelete' ),
                    $this->msg( $message )->text(),
                    [],
                    [ 'target' => $this->entry->getTarget()->getPrefixedDBkey() ]
                );
 
                return $this->msg( 'parentheses' )->rawParams( $revert )->escaped();
 
            case 'revision': // If an edit was hidden from a page give a review link to the history
                $params = $this->extractParameters();
                if ( !isset( $params[3] ) || !isset( $params[4] ) ) {
                    return '';
                }
 
                // Different revision types use different URL params...
                $key = $params[3];
                // This is a array or CSV of the IDs
                $ids = is_array( $params[4] )
                    ? $params[4]
                    : explode( ',', $params[4] );
 
                $links = [];
 
                // If there's only one item, we can show a diff link
                if ( count( $ids ) == 1 ) {
                    // Live revision diffs...
                    if ( $key == 'oldid' || $key == 'revision' ) {
                        $links[] = $linkRenderer->makeKnownLink(
                            $this->entry->getTarget(),
                            $this->msg( 'diff' )->text(),
                            [],
                            [
                                'diff' => intval( $ids[0] ),
                                'unhide' => 1
                            ]
                        );
                        // Deleted revision diffs...
                    } elseif ( $key == 'artimestamp' || $key == 'archive' ) {
                        $links[] = $linkRenderer->makeKnownLink(
                            SpecialPage::getTitleFor( 'Undelete' ),
                            $this->msg( 'diff' )->text(),
                            [],
                            [
                                'target' => $this->entry->getTarget()->getPrefixedDBkey(),
                                'diff' => 'prev',
                                'timestamp' => $ids[0]
                            ]
                        );
                    }
                }
 
                // View/modify link...
                $links[] = $linkRenderer->makeKnownLink(
                    SpecialPage::getTitleFor( 'Revisiondelete' ),
                    $this->msg( 'revdel-restore' )->text(),
                    [],
                    [
                        'target' => $this->entry->getTarget()->getPrefixedText(),
                        'type' => $key,
                        'ids' => implode( ',', $ids ),
                    ]
                );
 
                return $this->msg( 'parentheses' )->rawParams(
                    $this->context->getLanguage()->pipeList( $links ) )->escaped();
 
            case 'event': // Hidden log items, give review link
                $params = $this->extractParameters();
                if ( !isset( $params[3] ) ) {
                    return '';
                }
                // This is a CSV of the IDs
                $query = $params[3];
                if ( is_array( $query ) ) {
                    $query = implode( ',', $query );
                }
                // Link to each hidden object ID, $params[1] is the url param
                $revert = $linkRenderer->makeKnownLink(
                    SpecialPage::getTitleFor( 'Revisiondelete' ),
                    $this->msg( 'revdel-restore' )->text(),
                    [],
                    [
                        'target' => $this->entry->getTarget()->getPrefixedText(),
                        'type' => 'logging',
                        'ids' => $query
                    ]
                );
 
                return $this->msg( 'parentheses' )->rawParams( $revert )->escaped();
            default:
                return '';
        }
    }
 
    protected function getParametersForApi() {
        $entry = $this->entry;
        $params = [];
 
        $subtype = $this->entry->getSubtype();
        if ( in_array( $subtype, [ 'event', 'revision' ] ) ) {
            $rawParams = $entry->getParameters();
            if ( $subtype === 'event' ) {
                array_unshift( $rawParams, 'logging' );
            }
 
            static $map = [
                '4::type',
                '5::ids',
                '6::ofield',
                '7::nfield',
                '4::ids' => '5::ids',
                '5::ofield' => '6::ofield',
                '6::nfield' => '7::nfield',
            ];
            foreach ( $map as $index => $key ) {
                if ( isset( $rawParams[$index] ) ) {
                    $rawParams[$key] = $rawParams[$index];
                    unset( $rawParams[$index] );
                }
            }
 
            if ( !is_array( $rawParams['5::ids'] ) ) {
                $rawParams['5::ids'] = explode( ',', $rawParams['5::ids'] );
            }
 
            $params = [
                '::type' => $rawParams['4::type'],
                ':array:ids' => $rawParams['5::ids'],
            ];
 
            static $fields = [
                RevisionRecord::DELETED_TEXT => 'content',
                RevisionRecord::DELETED_COMMENT => 'comment',
                RevisionRecord::DELETED_USER => 'user',
                RevisionRecord::DELETED_RESTRICTED => 'restricted',
            ];
 
            if ( isset( $rawParams['6::ofield'] ) ) {
                $old = $this->parseBitField( $rawParams['6::ofield'] );
                $params[':assoc:old'] = [ 'bitmask' => $old ];
                foreach ( $fields as $bit => $key ) {
                    $params[':assoc:old'][$key] = (bool)( $old & $bit );
                }
            }
            if ( isset( $rawParams['7::nfield'] ) ) {
                $new = $this->parseBitField( $rawParams['7::nfield'] );
                $params[':assoc:new'] = [ 'bitmask' => $new ];
                foreach ( $fields as $bit => $key ) {
                    $params[':assoc:new'][$key] = (bool)( $new & $bit );
                }
            }
        } elseif ( $subtype === 'restore' ) {
            $rawParams = $entry->getParameters();
            if ( isset( $rawParams[':assoc:count'] ) ) {
                $params[':assoc:count'] = $rawParams[':assoc:count'];
            }
        }
 
        return $params;
    }
 
    public function formatParametersForApi() {
        $ret = parent::formatParametersForApi();
        if ( isset( $ret['ids'] ) ) {
            ApiResult::setIndexedTagName( $ret['ids'], 'id' );
        }
        return $ret;
    }
}
 
class_alias( DeleteLogFormatter::class, 'DeleteLogFormatter' );