PatrolLog.php

Go to the documentation of this file.

<?php
use MediaWiki\Page\PageReferenceValue;
use MediaWiki\User\UserIdentity;
 
class PatrolLog {
 
    public static function record( $rc, $auto, UserIdentity $user, $tags = null ) {
        // Do not log autopatrol actions: T184485
        if ( $auto ) {
            return false;
        }
 
        if ( !$rc instanceof RecentChange ) {
            $rc = RecentChange::newFromId( $rc );
            if ( !is_object( $rc ) ) {
                return false;
            }
        }
 
        $entry = new ManualLogEntry( 'patrol', 'patrol' );
 
        // B/C: ->getPage() on RC will return a page reference or null, reconcile this in
        //      $entry->setTarget() call so we don't throw.
        $page = $rc->getPage() ?? PageReferenceValue::localReference( NS_SPECIAL, 'Badtitle' );
        $entry->setTarget( $page );
        $entry->setParameters( self::buildParams( $rc ) );
        $entry->setPerformer( $user );
        $entry->addTags( $tags );
        $logid = $entry->insert();
        $entry->publish( $logid, 'udp' );
 
        return true;
    }
 
    private static function buildParams( $change ) {
        return [
            '4::curid' => $change->getAttribute( 'rc_this_oldid' ),
            '5::previd' => $change->getAttribute( 'rc_last_oldid' ),
            '6::auto' => 0
        ];
    }
}