LogPage.php

Go to the documentation of this file.

<?php
class LogPage {
    const DELETED_ACTION = 1;
    const DELETED_COMMENT = 2;
    const DELETED_USER = 4;
    const DELETED_RESTRICTED = 8;
 
    // Convenience fields
    const SUPPRESSED_USER = 12;
    const SUPPRESSED_ACTION = 9;
 
    public $updateRecentChanges;
 
    public $sendToUDP;
 
    private $ircActionText;
 
    private $actionText;
 
    private $type;
 
    private $action;
 
    private $comment;
 
    private $params;
 
    private $doer;
 
    private $target;
 
    public function __construct( $type, $rc = true, $udp = 'skipUDP' ) {
        $this->type = $type;
        $this->updateRecentChanges = $rc;
        $this->sendToUDP = ( $udp == 'UDP' );
    }
 
    protected function saveContent() {
        global $wgLogRestrictions;
 
        $dbw = wfGetDB( DB_MASTER );
        $log_id = $dbw->nextSequenceValue( 'logging_log_id_seq' );
 
        // @todo FIXME private/protected/public property?
        $this->timestamp = $now = wfTimestampNow();
        $data = [
            'log_id' => $log_id,
            'log_type' => $this->type,
            'log_action' => $this->action,
            'log_timestamp' => $dbw->timestamp( $now ),
            'log_user' => $this->doer->getId(),
            'log_user_text' => $this->doer->getName(),
            'log_namespace' => $this->target->getNamespace(),
            'log_title' => $this->target->getDBkey(),
            'log_page' => $this->target->getArticleID(),
            'log_comment' => $this->comment,
            'log_params' => $this->params
        ];
        $dbw->insert( 'logging', $data, __METHOD__ );
        $newId = !is_null( $log_id ) ? $log_id : $dbw->insertId();
 
        # And update recentchanges
        if ( $this->updateRecentChanges ) {
            $titleObj = SpecialPage::getTitleFor( 'Log', $this->type );
 
            RecentChange::notifyLog(
                $now, $titleObj, $this->doer, $this->getRcComment(), '',
                $this->type, $this->action, $this->target, $this->comment,
                $this->params, $newId, $this->getRcCommentIRC()
            );
        } elseif ( $this->sendToUDP ) {
            # Don't send private logs to UDP
            if ( isset( $wgLogRestrictions[$this->type] ) && $wgLogRestrictions[$this->type] != '*' ) {
                return $newId;
            }
 
            # Notify external application via UDP.
            # We send this to IRC but do not want to add it the RC table.
            $titleObj = SpecialPage::getTitleFor( 'Log', $this->type );
            $rc = RecentChange::newLogEntry(
                $now, $titleObj, $this->doer, $this->getRcComment(), '',
                $this->type, $this->action, $this->target, $this->comment,
                $this->params, $newId, $this->getRcCommentIRC()
            );
            $rc->notifyRCFeeds();
        }
 
        return $newId;
    }
 
    public function getRcComment() {
        $rcComment = $this->actionText;
 
        if ( $this->comment != '' ) {
            if ( $rcComment == '' ) {
                $rcComment = $this->comment;
            } else {
                $rcComment .= wfMessage( 'colon-separator' )->inContentLanguage()->text() .
                    $this->comment;
            }
        }
 
        return $rcComment;
    }
 
    public function getRcCommentIRC() {
        $rcComment = $this->ircActionText;
 
        if ( $this->comment != '' ) {
            if ( $rcComment == '' ) {
                $rcComment = $this->comment;
            } else {
                $rcComment .= wfMessage( 'colon-separator' )->inContentLanguage()->text() .
                    $this->comment;
            }
        }
 
        return $rcComment;
    }
 
    public function getComment() {
        return $this->comment;
    }
 
    public static function validTypes() {
        global $wgLogTypes;
 
        return $wgLogTypes;
    }
 
    public static function isLogType( $type ) {
        return in_array( $type, LogPage::validTypes() );
    }
 
    public static function actionText( $type, $action, $title = null, $skin = null,
        $params = [], $filterWikilinks = false
    ) {
        global $wgLang, $wgContLang, $wgLogActions;
 
        if ( is_null( $skin ) ) {
            $langObj = $wgContLang;
            $langObjOrNull = null;
        } else {
            $langObj = $wgLang;
            $langObjOrNull = $wgLang;
        }
 
        $key = "$type/$action";
 
        if ( isset( $wgLogActions[$key] ) ) {
            if ( is_null( $title ) ) {
                $rv = wfMessage( $wgLogActions[$key] )->inLanguage( $langObj )->escaped();
            } else {
                $titleLink = self::getTitleLink( $type, $langObjOrNull, $title, $params );
 
                if ( count( $params ) == 0 ) {
                    $rv = wfMessage( $wgLogActions[$key] )->rawParams( $titleLink )
                        ->inLanguage( $langObj )->escaped();
                } else {
                    array_unshift( $params, $titleLink );
 
                    $rv = wfMessage( $wgLogActions[$key] )->rawParams( $params )
                            ->inLanguage( $langObj )->escaped();
                }
            }
        } else {
            global $wgLogActionsHandlers;
 
            if ( isset( $wgLogActionsHandlers[$key] ) ) {
                $args = func_get_args();
                $rv = call_user_func_array( $wgLogActionsHandlers[$key], $args );
            } else {
                wfDebug( "LogPage::actionText - unknown action $key\n" );
                $rv = "$action";
            }
        }
 
        // For the perplexed, this feature was added in r7855 by Erik.
        // The feature was added because we liked adding [[$1]] in our log entries
        // but the log entries are parsed as Wikitext on RecentChanges but as HTML
        // on Special:Log. The hack is essentially that [[$1]] represented a link
        // to the title in question. The first parameter to the HTML version (Special:Log)
        // is that link in HTML form, and so this just gets rid of the ugly [[]].
        // However, this is a horrible hack and it doesn't work like you expect if, say,
        // you want to link to something OTHER than the title of the log entry.
        // The real problem, which Erik was trying to fix (and it sort-of works now) is
        // that the same messages are being treated as both wikitext *and* HTML.
        if ( $filterWikilinks ) {
            $rv = str_replace( '[[', '', $rv );
            $rv = str_replace( ']]', '', $rv );
        }
 
        return $rv;
    }
 
    protected static function getTitleLink( $type, $lang, $title, &$params ) {
        if ( !$lang ) {
            return $title->getPrefixedText();
        }
 
        if ( $title->isSpecialPage() ) {
            list( $name, $par ) = SpecialPageFactory::resolveAlias( $title->getDBkey() );
 
            # Use the language name for log titles, rather than Log/X
            if ( $name == 'Log' ) {
                $logPage = new LogPage( $par );
                $titleLink = Linker::link( $title, $logPage->getName()->escaped() );
                $titleLink = wfMessage( 'parentheses' )
                    ->inLanguage( $lang )
                    ->rawParams( $titleLink )
                    ->escaped();
            } else {
                $titleLink = Linker::link( $title );
            }
        } else {
            $titleLink = Linker::link( $title );
        }
 
        return $titleLink;
    }
 
    public function addEntry( $action, $target, $comment, $params = [], $doer = null ) {
        global $wgContLang;
 
        if ( !is_array( $params ) ) {
            $params = [ $params ];
        }
 
        if ( $comment === null ) {
            $comment = '';
        }
 
        # Trim spaces on user supplied text
        $comment = trim( $comment );
 
        # Truncate for whole multibyte characters.
        $comment = $wgContLang->truncate( $comment, 255 );
 
        $this->action = $action;
        $this->target = $target;
        $this->comment = $comment;
        $this->params = LogPage::makeParamBlob( $params );
 
        if ( $doer === null ) {
            global $wgUser;
            $doer = $wgUser;
        } elseif ( !is_object( $doer ) ) {
            $doer = User::newFromId( $doer );
        }
 
        $this->doer = $doer;
 
        $logEntry = new ManualLogEntry( $this->type, $action );
        $logEntry->setTarget( $target );
        $logEntry->setPerformer( $doer );
        $logEntry->setParameters( $params );
        // All log entries using the LogPage to insert into the logging table
        // are using the old logging system and therefore the legacy flag is
        // needed to say the LogFormatter the parameters have numeric keys
        $logEntry->setLegacy( true );
 
        $formatter = LogFormatter::newFromEntry( $logEntry );
        $context = RequestContext::newExtraneousContext( $target );
        $formatter->setContext( $context );
 
        $this->actionText = $formatter->getPlainActionText();
        $this->ircActionText = $formatter->getIRCActionText();
 
        return $this->saveContent();
    }
 
    public function addRelations( $field, $values, $logid ) {
        if ( !strlen( $field ) || empty( $values ) ) {
            return false; // nothing
        }
 
        $data = [];
 
        foreach ( $values as $value ) {
            $data[] = [
                'ls_field' => $field,
                'ls_value' => $value,
                'ls_log_id' => $logid
            ];
        }
 
        $dbw = wfGetDB( DB_MASTER );
        $dbw->insert( 'log_search', $data, __METHOD__, 'IGNORE' );
 
        return true;
    }
 
    public static function makeParamBlob( $params ) {
        return implode( "\n", $params );
    }
 
    public static function extractParams( $blob ) {
        if ( $blob === '' ) {
            return [];
        } else {
            return explode( "\n", $blob );
        }
    }
 
    public function getName() {
        global $wgLogNames;
 
        // BC
        if ( isset( $wgLogNames[$this->type] ) ) {
            $key = $wgLogNames[$this->type];
        } else {
            $key = 'log-name-' . $this->type;
        }
 
        return wfMessage( $key );
    }
 
    public function getDescription() {
        global $wgLogHeaders;
        // BC
        if ( isset( $wgLogHeaders[$this->type] ) ) {
            $key = $wgLogHeaders[$this->type];
        } else {
            $key = 'log-description-' . $this->type;
        }
 
        return wfMessage( $key );
    }
 
    public function getRestriction() {
        global $wgLogRestrictions;
        if ( isset( $wgLogRestrictions[$this->type] ) ) {
            $restriction = $wgLogRestrictions[$this->type];
        } else {
            // '' always returns true with $user->isAllowed()
            $restriction = '';
        }
 
        return $restriction;
    }
 
    public function isRestricted() {
        $restriction = $this->getRestriction();
 
        return $restriction !== '' && $restriction !== '*';
    }
}