'LinksUpdate' => 'includes/LinksUpdate.php',
'LocalisationCache' => 'includes/LocalisationCache.php',
'LocalisationCache_BulkLoad' => 'includes/LocalisationCache.php',
- 'LogEventsList' => 'includes/LogEventsList.php',
- 'LogPage' => 'includes/LogPage.php',
- 'LogPager' => 'includes/LogEventsList.php',
'MagicWord' => 'includes/MagicWord.php',
'MagicWordArray' => 'includes/MagicWord.php',
'MailAddress' => 'includes/UserMailer.php',
'JSParser' => 'includes/libs/jsminplus.php',
# includes/logging
+ 'LogEventsList' => 'includes/logging/LogEventsList.php',
+ 'LogPage' => 'includes/logging/LogPage.php',
+ 'LogPager' => 'includes/logging/LogEventsList.php',
'DatabaseLogEntry' => 'includes/logging/LogEntry.php',
'DeleteLogFormatter' => 'includes/logging/LogFormatter.php',
'LegacyLogFormatter' => 'includes/logging/LogFormatter.php',
+++ /dev/null
-<?php
-/**
- * Contain classes to list log entries
- *
- * Copyright © 2004 Brion Vibber <brion@pobox.com>, 2008 Aaron Schulz
- * http://www.mediawiki.org/
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- * http://www.gnu.org/copyleft/gpl.html
- *
- * @file
- */
-
-class LogEventsList {
- const NO_ACTION_LINK = 1;
- const NO_EXTRA_USER_LINKS = 2;
-
- /**
- * @var Skin
- */
- private $skin;
-
- /**
- * @var OutputPage
- */
- private $out;
- public $flags;
-
- /**
- * @var Array
- */
- protected $message;
-
- /**
- * @var Array
- */
- protected $mDefaultQuery;
-
- public function __construct( $skin, $out, $flags = 0 ) {
- $this->skin = $skin;
- $this->out = $out;
- $this->flags = $flags;
- $this->preCacheMessages();
- }
-
- /**
- * As we use the same small set of messages in various methods and that
- * they are called often, we call them once and save them in $this->message
- */
- private function preCacheMessages() {
- // Precache various messages
- if( !isset( $this->message ) ) {
- $messages = array( 'revertmerge', 'protect_change', 'unblocklink', 'change-blocklink',
- 'revertmove', 'undeletelink', 'undeleteviewlink', 'revdel-restore', 'hist', 'diff',
- 'pipe-separator', 'revdel-restore-deleted', 'revdel-restore-visible' );
- foreach( $messages as $msg ) {
- $this->message[$msg] = wfMsgExt( $msg, array( 'escapenoentities' ) );
- }
- }
- }
-
- /**
- * Set page title and show header for this log type
- * @param $type Array
- * @deprecated in 1.19
- */
- public function showHeader( $type ) {
- wfDeprecated( __METHOD__, '1.19' );
- // If only one log type is used, then show a special message...
- $headerType = (count($type) == 1) ? $type[0] : '';
- if( LogPage::isLogType( $headerType ) ) {
- $page = new LogPage( $headerType );
- $this->out->setPageTitle( $page->getName()->text() );
- $this->out->addHTML( $page->getDescription()->parseAsBlock() );
- } else {
- $this->out->addHTML( wfMsgExt('alllogstext',array('parseinline')) );
- }
- }
-
- /**
- * Show options for the log list
- *
- * @param $types string or Array
- * @param $user String
- * @param $page String
- * @param $pattern String
- * @param $year Integer: year
- * @param $month Integer: month
- * @param $filter: array
- * @param $tagFilter: array?
- */
- public function showOptions( $types=array(), $user='', $page='', $pattern='', $year='',
- $month = '', $filter = null, $tagFilter='' ) {
- global $wgScript, $wgMiserMode;
-
- $action = $wgScript;
- $title = SpecialPage::getTitleFor( 'Log' );
- $special = $title->getPrefixedDBkey();
-
- // For B/C, we take strings, but make sure they are converted...
- $types = ($types === '') ? array() : (array)$types;
-
- $tagSelector = ChangeTags::buildTagFilterSelector( $tagFilter );
-
- $html = Html::hidden( 'title', $special );
-
- // Basic selectors
- $html .= $this->getTypeMenu( $types ) . "\n";
- $html .= $this->getUserInput( $user ) . "\n";
- $html .= $this->getTitleInput( $page ) . "\n";
- $html .= $this->getExtraInputs( $types ) . "\n";
-
- // Title pattern, if allowed
- if (!$wgMiserMode) {
- $html .= $this->getTitlePattern( $pattern ) . "\n";
- }
-
- // date menu
- $html .= Xml::tags( 'p', null, Xml::dateMenu( $year, $month ) );
-
- // Tag filter
- if ($tagSelector) {
- $html .= Xml::tags( 'p', null, implode( ' ', $tagSelector ) );
- }
-
- // Filter links
- if ($filter) {
- $html .= Xml::tags( 'p', null, $this->getFilterLinks( $filter ) );
- }
-
- // Submit button
- $html .= Xml::submitButton( wfMsg( 'allpagessubmit' ) );
-
- // Fieldset
- $html = Xml::fieldset( wfMsg( 'log' ), $html );
-
- // Form wrapping
- $html = Xml::tags( 'form', array( 'action' => $action, 'method' => 'get' ), $html );
-
- $this->out->addHTML( $html );
- }
-
- /**
- * @param $filter Array
- * @return String: Formatted HTML
- */
- private function getFilterLinks( $filter ) {
- global $wgLang;
- // show/hide links
- $messages = array( wfMsgHtml( 'show' ), wfMsgHtml( 'hide' ) );
- // Option value -> message mapping
- $links = array();
- $hiddens = ''; // keep track for "go" button
- foreach( $filter as $type => $val ) {
- // Should the below assignment be outside the foreach?
- // Then it would have to be copied. Not certain what is more expensive.
- $query = $this->getDefaultQuery();
- $queryKey = "hide_{$type}_log";
-
- $hideVal = 1 - intval($val);
- $query[$queryKey] = $hideVal;
-
- $link = Linker::link(
- $this->getDisplayTitle(),
- $messages[$hideVal],
- array(),
- $query,
- array( 'known', 'noclasses' )
- );
-
- $links[$type] = wfMsgHtml( "log-show-hide-{$type}", $link );
- $hiddens .= Html::hidden( "hide_{$type}_log", $val ) . "\n";
- }
- // Build links
- return '<small>'.$wgLang->pipeList( $links ) . '</small>' . $hiddens;
- }
-
- private function getDefaultQuery() {
- global $wgRequest;
-
- if ( !isset( $this->mDefaultQuery ) ) {
- $this->mDefaultQuery = $wgRequest->getQueryValues();
- unset( $this->mDefaultQuery['title'] );
- unset( $this->mDefaultQuery['dir'] );
- unset( $this->mDefaultQuery['offset'] );
- unset( $this->mDefaultQuery['limit'] );
- unset( $this->mDefaultQuery['order'] );
- unset( $this->mDefaultQuery['month'] );
- unset( $this->mDefaultQuery['year'] );
- }
- return $this->mDefaultQuery;
- }
-
- /**
- * Get the Title object of the page the links should point to.
- * This is NOT the Title of the page the entries should be restricted to.
- *
- * @return Title object
- */
- public function getDisplayTitle() {
- return $this->out->getTitle();
- }
-
- public function getContext() {
- return $this->out->getContext();
- }
-
- /**
- * @param $queryTypes Array
- * @return String: Formatted HTML
- */
- private function getTypeMenu( $queryTypes ) {
- $queryType = count($queryTypes) == 1 ? $queryTypes[0] : '';
- $selector = $this->getTypeSelector();
- $selector->setDefault( $queryType );
- return $selector->getHtml();
- }
-
- /**
- * Returns log page selector.
- * @param $default string The default selection
- * @return XmlSelect
- * @since 1.19
- */
- public function getTypeSelector() {
- global $wgUser;
-
- $typesByName = array(); // Temporary array
- // First pass to load the log names
- foreach( LogPage::validTypes() as $type ) {
- $page = new LogPage( $type );
- $restriction = $page->getRestriction();
- if ( $wgUser->isAllowed( $restriction ) ) {
- $typesByName[$type] = $page->getName()->text();
- }
- }
-
- // Second pass to sort by name
- asort($typesByName);
-
- // Always put "All public logs" on top
- $public = $typesByName[''];
- unset( $typesByName[''] );
- $typesByName = array( '' => $public ) + $typesByName;
-
- $select = new XmlSelect( 'type' );
- foreach( $typesByName as $type => $name ) {
- $select->addOption( $name, $type );
- }
-
- return $select;
- }
-
- /**
- * @param $user String
- * @return String: Formatted HTML
- */
- private function getUserInput( $user ) {
- return '<span style="white-space: nowrap">' .
- Xml::inputLabel( wfMsg( 'specialloguserlabel' ), 'user', 'mw-log-user', 15, $user ) .
- '</span>';
- }
-
- /**
- * @param $title String
- * @return String: Formatted HTML
- */
- private function getTitleInput( $title ) {
- return '<span style="white-space: nowrap">' .
- Xml::inputLabel( wfMsg( 'speciallogtitlelabel' ), 'page', 'mw-log-page', 20, $title ) .
- '</span>';
- }
-
- /**
- * @param $pattern
- * @return string Checkbox
- */
- private function getTitlePattern( $pattern ) {
- return '<span style="white-space: nowrap">' .
- Xml::checkLabel( wfMsg( 'log-title-wildcard' ), 'pattern', 'pattern', $pattern ) .
- '</span>';
- }
-
- /**
- * @param $types
- * @return string
- */
- private function getExtraInputs( $types ) {
- global $wgRequest;
- $offender = $wgRequest->getVal('offender');
- $user = User::newFromName( $offender, false );
- if( !$user || ($user->getId() == 0 && !IP::isIPAddress($offender) ) ) {
- $offender = ''; // Blank field if invalid
- }
- if( count($types) == 1 && $types[0] == 'suppress' ) {
- return Xml::inputLabel( wfMsg('revdelete-offender'), 'offender',
- 'mw-log-offender', 20, $offender );
- }
- return '';
- }
-
- /**
- * @return string
- */
- public function beginLogEventsList() {
- return "<ul>\n";
- }
-
- /**
- * @return string
- */
- public function endLogEventsList() {
- return "</ul>\n";
- }
-
- /**
- * @param $row Row: a single row from the result set
- * @return String: Formatted HTML list item
- */
- public function logLine( $row ) {
- $entry = DatabaseLogEntry::newFromRow( $row );
- $formatter = LogFormatter::newFromEntry( $entry );
- $formatter->setShowUserToolLinks( !( $this->flags & self::NO_EXTRA_USER_LINKS ) );
-
- $action = $formatter->getActionText();
- $comment = $formatter->getComment();
-
- $classes = array( 'mw-logline-' . $entry->getType() );
- $title = $entry->getTarget();
- $time = $this->logTimestamp( $entry );
-
- // Extract extra parameters
- $paramArray = LogPage::extractParams( $row->log_params );
- // Add review/revert links and such...
- $revert = $this->logActionLinks( $row, $title, $paramArray, $comment );
-
- // Some user can hide log items and have review links
- $del = $this->getShowHideLinks( $row );
- if( $del != '' ) $del .= ' ';
-
- // Any tags...
- list( $tagDisplay, $newClasses ) = ChangeTags::formatSummaryRow( $row->ts_tags, 'logevent' );
- $classes = array_merge( $classes, $newClasses );
-
- return Xml::tags( 'li', array( "class" => implode( ' ', $classes ) ),
- $del . "$time $action $comment $revert $tagDisplay" ) . "\n";
- }
-
- private function logTimestamp( LogEntry $entry ) {
- global $wgLang;
- $time = $wgLang->timeanddate( wfTimestamp( TS_MW, $entry->getTimestamp() ), true );
- return htmlspecialchars( $time );
- }
-
- /**
- * @TODO: split up!
- *
- * @param $row
- * @param Title $title
- * @param Array $paramArray
- * @param $comment
- * @return String
- */
- private function logActionLinks( $row, $title, $paramArray, &$comment ) {
- global $wgUser;
- if( ( $this->flags & self::NO_ACTION_LINK ) // we don't want to see the action
- || self::isDeleted( $row, LogPage::DELETED_ACTION ) ) // action is hidden
- {
- return '';
- }
- $revert = '';
- if( self::typeAction( $row, 'move', 'move', 'move' ) && !empty( $paramArray[0] ) ) {
- $destTitle = Title::newFromText( $paramArray[0] );
- if( $destTitle ) {
- $revert = '(' . Linker::link(
- SpecialPage::getTitleFor( 'Movepage' ),
- $this->message['revertmove'],
- array(),
- array(
- 'wpOldTitle' => $destTitle->getPrefixedDBkey(),
- 'wpNewTitle' => $title->getPrefixedDBkey(),
- 'wpReason' => wfMsgForContent( 'revertmove' ),
- 'wpMovetalk' => 0
- ),
- array( 'known', 'noclasses' )
- ) . ')';
- }
- // Show undelete link
- } elseif( self::typeAction( $row, array( 'delete', 'suppress' ), 'delete', 'deletedhistory' ) ) {
- if( !$wgUser->isAllowed( 'undelete' ) ) {
- $viewdeleted = $this->message['undeleteviewlink'];
- } else {
- $viewdeleted = $this->message['undeletelink'];
- }
- $revert = '(' . Linker::link(
- SpecialPage::getTitleFor( 'Undelete' ),
- $viewdeleted,
- array(),
- array( 'target' => $title->getPrefixedDBkey() ),
- array( 'known', 'noclasses' )
- ) . ')';
- // Show unblock/change block link
- } elseif( self::typeAction( $row, array( 'block', 'suppress' ), array( 'block', 'reblock' ), 'block' ) ) {
- $revert = '(' .
- Linker::link(
- SpecialPage::getTitleFor( 'Unblock', $row->log_title ),
- $this->message['unblocklink'],
- array(),
- array(),
- 'known'
- ) .
- $this->message['pipe-separator'] .
- Linker::link(
- SpecialPage::getTitleFor( 'Block', $row->log_title ),
- $this->message['change-blocklink'],
- array(),
- array(),
- 'known'
- ) .
- ')';
- // Show change protection link
- } elseif( self::typeAction( $row, 'protect', array( 'modify', 'protect', 'unprotect' ) ) ) {
- $revert .= ' (' .
- Linker::link( $title,
- $this->message['hist'],
- array(),
- array(
- 'action' => 'history',
- 'offset' => $row->log_timestamp
- )
- );
- if( $wgUser->isAllowed( 'protect' ) ) {
- $revert .= $this->message['pipe-separator'] .
- Linker::link( $title,
- $this->message['protect_change'],
- array(),
- array( 'action' => 'protect' ),
- 'known' );
- }
- $revert .= ')';
- // Show unmerge link
- } elseif( self::typeAction( $row, 'merge', 'merge', 'mergehistory' ) ) {
- $revert = '(' . Linker::link(
- SpecialPage::getTitleFor( 'MergeHistory' ),
- $this->message['revertmerge'],
- array(),
- array(
- 'target' => $paramArray[0],
- 'dest' => $title->getPrefixedDBkey(),
- 'mergepoint' => $paramArray[1]
- ),
- array( 'known', 'noclasses' )
- ) . ')';
- // If an edit was hidden from a page give a review link to the history
- } elseif( self::typeAction( $row, array( 'delete', 'suppress' ), 'revision', 'deletedhistory' ) ) {
- $revert = RevisionDeleter::getLogLinks( $title, $paramArray,
- $this->message );
- // Hidden log items, give review link
- } elseif( self::typeAction( $row, array( 'delete', 'suppress' ), 'event', 'deletedhistory' ) ) {
- if( count($paramArray) >= 1 ) {
- $revdel = SpecialPage::getTitleFor( 'Revisiondelete' );
- // $paramArray[1] is a CSV of the IDs
- $query = $paramArray[0];
- // Link to each hidden object ID, $paramArray[1] is the url param
- $revert = '(' . Linker::link(
- $revdel,
- $this->message['revdel-restore'],
- array(),
- array(
- 'target' => $title->getPrefixedText(),
- 'type' => 'logging',
- 'ids' => $query
- ),
- array( 'known', 'noclasses' )
- ) . ')';
- }
- // Do nothing. The implementation is handled by the hook modifiying the passed-by-ref parameters.
- } else {
- wfRunHooks( 'LogLine', array( $row->log_type, $row->log_action, $title, $paramArray,
- &$comment, &$revert, $row->log_timestamp ) );
- }
- if( $revert != '' ) {
- $revert = '<span class="mw-logevent-actionlink">' . $revert . '</span>';
- }
- return $revert;
- }
-
- /**
- * @param $row Row
- * @return string
- */
- private function getShowHideLinks( $row ) {
- global $wgUser;
- if( ( $this->flags & self::NO_ACTION_LINK ) // we don't want to see the links
- || $row->log_type == 'suppress' ) { // no one can hide items from the suppress log
- return '';
- }
- $del = '';
- // Don't show useless link to people who cannot hide revisions
- if( $wgUser->isAllowed( 'deletedhistory' ) ) {
- if( $row->log_deleted || $wgUser->isAllowed( 'deleterevision' ) ) {
- $canHide = $wgUser->isAllowed( 'deleterevision' );
- // If event was hidden from sysops
- if( !self::userCan( $row, LogPage::DELETED_RESTRICTED ) ) {
- $del = Linker::revDeleteLinkDisabled( $canHide );
- } else {
- $target = SpecialPage::getTitleFor( 'Log', $row->log_type );
- $query = array(
- 'target' => $target->getPrefixedDBkey(),
- 'type' => 'logging',
- 'ids' => $row->log_id,
- );
- $del = Linker::revDeleteLink( $query,
- self::isDeleted( $row, LogPage::DELETED_RESTRICTED ), $canHide );
- }
- }
- }
- return $del;
- }
-
- /**
- * @param $row Row
- * @param $type Mixed: string/array
- * @param $action Mixed: string/array
- * @param $right string
- * @return Boolean
- */
- public static function typeAction( $row, $type, $action, $right='' ) {
- $match = is_array($type) ?
- in_array( $row->log_type, $type ) : $row->log_type == $type;
- if( $match ) {
- $match = is_array( $action ) ?
- in_array( $row->log_action, $action ) : $row->log_action == $action;
- if( $match && $right ) {
- global $wgUser;
- $match = $wgUser->isAllowed( $right );
- }
- }
- return $match;
- }
-
- /**
- * Determine if the current user is allowed to view a particular
- * field of this log row, if it's marked as deleted.
- *
- * @param $row Row
- * @param $field Integer
- * @param $user User object to check, or null to use $wgUser
- * @return Boolean
- */
- public static function userCan( $row, $field, User $user = null ) {
- return self::userCanBitfield( $row->log_deleted, $field, $user );
- }
-
- /**
- * Determine if the current user is allowed to view a particular
- * field of this log row, if it's marked as deleted.
- *
- * @param $bitfield Integer (current field)
- * @param $field Integer
- * @param $user User object to check, or null to use $wgUser
- * @return Boolean
- */
- public static function userCanBitfield( $bitfield, $field, User $user = null ) {
- if( $bitfield & $field ) {
- if ( $bitfield & LogPage::DELETED_RESTRICTED ) {
- $permission = 'suppressrevision';
- } else {
- $permission = 'deletedhistory';
- }
- wfDebug( "Checking for $permission due to $field match on $bitfield\n" );
- if ( $user === null ) {
- global $wgUser;
- $user = $wgUser;
- }
- return $user->isAllowed( $permission );
- } else {
- return true;
- }
- }
-
- /**
- * @param $row Row
- * @param $field Integer: one of DELETED_* bitfield constants
- * @return Boolean
- */
- public static function isDeleted( $row, $field ) {
- return ( $row->log_deleted & $field ) == $field;
- }
-
- /**
- * Show log extract. Either with text and a box (set $msgKey) or without (don't set $msgKey)
- *
- * @param $out OutputPage|String-by-reference
- * @param $types String|Array Log types to show
- * @param $page String|Title The page title to show log entries for
- * @param $user String The user who made the log entries
- * @param $param Associative Array with the following additional options:
- * - lim Integer Limit of items to show, default is 50
- * - conds Array Extra conditions for the query (e.g. "log_action != 'revision'")
- * - showIfEmpty boolean Set to false if you don't want any output in case the loglist is empty
- * if set to true (default), "No matching items in log" is displayed if loglist is empty
- * - msgKey Array If you want a nice box with a message, set this to the key of the message.
- * First element is the message key, additional optional elements are parameters for the key
- * that are processed with wgMsgExt and option 'parse'
- * - offset Set to overwrite offset parameter in $wgRequest
- * set to '' to unset offset
- * - wrap String Wrap the message in html (usually something like "<div ...>$1</div>").
- * - flags Integer display flags (NO_ACTION_LINK,NO_EXTRA_USER_LINKS)
- * @return Integer Number of total log items (not limited by $lim)
- */
- public static function showLogExtract(
- &$out, $types=array(), $page='', $user='', $param = array()
- ) {
- $defaultParameters = array(
- 'lim' => 25,
- 'conds' => array(),
- 'showIfEmpty' => true,
- 'msgKey' => array(''),
- 'wrap' => "$1",
- 'flags' => 0
- );
- # The + operator appends elements of remaining keys from the right
- # handed array to the left handed, whereas duplicated keys are NOT overwritten.
- $param += $defaultParameters;
- # Convert $param array to individual variables
- $lim = $param['lim'];
- $conds = $param['conds'];
- $showIfEmpty = $param['showIfEmpty'];
- $msgKey = $param['msgKey'];
- $wrap = $param['wrap'];
- $flags = $param['flags'];
- if ( !is_array( $msgKey ) ) {
- $msgKey = array( $msgKey );
- }
-
- if ( $out instanceof OutputPage ) {
- $context = $out->getContext();
- } else {
- $context = RequestContext::getMain();
- }
-
- # Insert list of top 50 (or top $lim) items
- $loglist = new LogEventsList( $context->getSkin(), $context->getOutput(), $flags );
- $pager = new LogPager( $loglist, $types, $user, $page, '', $conds );
- if ( isset( $param['offset'] ) ) { # Tell pager to ignore $wgRequest offset
- $pager->setOffset( $param['offset'] );
- }
- if( $lim > 0 ) $pager->mLimit = $lim;
- $logBody = $pager->getBody();
- $s = '';
- if( $logBody ) {
- if ( $msgKey[0] ) {
- $s = '<div class="mw-warning-with-logexcerpt">';
-
- if ( count( $msgKey ) == 1 ) {
- $s .= wfMsgExt( $msgKey[0], array( 'parse' ) );
- } else { // Process additional arguments
- $args = $msgKey;
- array_shift( $args );
- $s .= wfMsgExt( $msgKey[0], array( 'parse' ), $args );
- }
- }
- $s .= $loglist->beginLogEventsList() .
- $logBody .
- $loglist->endLogEventsList();
- } else {
- if ( $showIfEmpty ) {
- $s = Html::rawElement( 'div', array( 'class' => 'mw-warning-logempty' ),
- wfMsgExt( 'logempty', array( 'parseinline' ) ) );
- }
- }
- if( $pager->getNumRows() > $pager->mLimit ) { # Show "Full log" link
- $urlParam = array();
- if ( $page instanceof Title ) {
- $urlParam['page'] = $page->getPrefixedDBkey();
- } elseif ( $page != '' ) {
- $urlParam['page'] = $page;
- }
- if ( $user != '')
- $urlParam['user'] = $user;
- if ( !is_array( $types ) ) # Make it an array, if it isn't
- $types = array( $types );
- # If there is exactly one log type, we can link to Special:Log?type=foo
- if ( count( $types ) == 1 )
- $urlParam['type'] = $types[0];
- $s .= Linker::link(
- SpecialPage::getTitleFor( 'Log' ),
- wfMsgHtml( 'log-fulllog' ),
- array(),
- $urlParam
- );
- }
- if ( $logBody && $msgKey[0] ) {
- $s .= '</div>';
- }
-
- if ( $wrap != '' ) { // Wrap message in html
- $s = str_replace( '$1', $s, $wrap );
- }
-
- /* hook can return false, if we don't want the message to be emitted (Wikia BugId:7093) */
- if ( wfRunHooks( 'LogEventsListShowLogExtract', array( &$s, $types, $page, $user, $param ) ) ) {
- // $out can be either an OutputPage object or a String-by-reference
- if ( $out instanceof OutputPage ){
- $out->addHTML( $s );
- } else {
- $out = $s;
- }
- }
-
- return $pager->getNumRows();
- }
-
- /**
- * SQL clause to skip forbidden log types for this user
- *
- * @param $db DatabaseBase
- * @param $audience string, public/user
- * @return Mixed: string or false
- */
- public static function getExcludeClause( $db, $audience = 'public' ) {
- global $wgLogRestrictions, $wgUser;
- // Reset the array, clears extra "where" clauses when $par is used
- $hiddenLogs = array();
- // Don't show private logs to unprivileged users
- foreach( $wgLogRestrictions as $logType => $right ) {
- if( $audience == 'public' || !$wgUser->isAllowed($right) ) {
- $safeType = $db->strencode( $logType );
- $hiddenLogs[] = $safeType;
- }
- }
- if( count($hiddenLogs) == 1 ) {
- return 'log_type != ' . $db->addQuotes( $hiddenLogs[0] );
- } elseif( $hiddenLogs ) {
- return 'log_type NOT IN (' . $db->makeList($hiddenLogs) . ')';
- }
- return false;
- }
- }
-
-/**
- * @ingroup Pager
- */
-class LogPager extends ReverseChronologicalPager {
- private $types = array(), $performer = '', $title = '', $pattern = '';
- private $typeCGI = '';
- public $mLogEventsList;
-
- /**
- * Constructor
- *
- * @param $list LogEventsList
- * @param $types String or Array: log types to show
- * @param $performer String: the user who made the log entries
- * @param $title String|Title: the page title the log entries are for
- * @param $pattern String: do a prefix search rather than an exact title match
- * @param $conds Array: extra conditions for the query
- * @param $year Integer: the year to start from
- * @param $month Integer: the month to start from
- * @param $tagFilter String: tag
- */
- public function __construct( $list, $types = array(), $performer = '', $title = '', $pattern = '',
- $conds = array(), $year = false, $month = false, $tagFilter = '' ) {
- parent::__construct( $list->getContext() );
- $this->mConds = $conds;
-
- $this->mLogEventsList = $list;
-
- $this->limitType( $types ); // also excludes hidden types
- $this->limitPerformer( $performer );
- $this->limitTitle( $title, $pattern );
- $this->getDateCond( $year, $month );
- $this->mTagFilter = $tagFilter;
- }
-
- public function getDefaultQuery() {
- $query = parent::getDefaultQuery();
- $query['type'] = $this->typeCGI; // arrays won't work here
- $query['user'] = $this->performer;
- $query['month'] = $this->mMonth;
- $query['year'] = $this->mYear;
- return $query;
- }
-
- // Call ONLY after calling $this->limitType() already!
- public function getFilterParams() {
- global $wgFilterLogTypes;
- $filters = array();
- if( count($this->types) ) {
- return $filters;
- }
- foreach( $wgFilterLogTypes as $type => $default ) {
- // Avoid silly filtering
- if( $type !== 'patrol' || $this->getUser()->useNPPatrol() ) {
- $hide = $this->getRequest()->getInt( "hide_{$type}_log", $default );
- $filters[$type] = $hide;
- if( $hide )
- $this->mConds[] = 'log_type != ' . $this->mDb->addQuotes( $type );
- }
- }
- return $filters;
- }
-
- /**
- * Set the log reader to return only entries of the given type.
- * Type restrictions enforced here
- *
- * @param $types String or array: Log types ('upload', 'delete', etc);
- * empty string means no restriction
- */
- private function limitType( $types ) {
- global $wgLogRestrictions;
- // If $types is not an array, make it an array
- $types = ($types === '') ? array() : (array)$types;
- // Don't even show header for private logs; don't recognize it...
- foreach ( $types as $type ) {
- if( isset( $wgLogRestrictions[$type] )
- && !$this->getUser()->isAllowed($wgLogRestrictions[$type])
- ) {
- $types = array_diff( $types, array( $type ) );
- }
- }
- $this->types = $types;
- // Don't show private logs to unprivileged users.
- // Also, only show them upon specific request to avoid suprises.
- $audience = $types ? 'user' : 'public';
- $hideLogs = LogEventsList::getExcludeClause( $this->mDb, $audience );
- if( $hideLogs !== false ) {
- $this->mConds[] = $hideLogs;
- }
- if( count($types) ) {
- $this->mConds['log_type'] = $types;
- // Set typeCGI; used in url param for paging
- if( count($types) == 1 ) $this->typeCGI = $types[0];
- }
- }
-
- /**
- * Set the log reader to return only entries by the given user.
- *
- * @param $name String: (In)valid user name
- */
- private function limitPerformer( $name ) {
- if( $name == '' ) {
- return false;
- }
- $usertitle = Title::makeTitleSafe( NS_USER, $name );
- if( is_null($usertitle) ) {
- return false;
- }
- /* Fetch userid at first, if known, provides awesome query plan afterwards */
- $userid = User::idFromName( $name );
- if( !$userid ) {
- /* It should be nicer to abort query at all,
- but for now it won't pass anywhere behind the optimizer */
- $this->mConds[] = "NULL";
- } else {
- $this->mConds['log_user'] = $userid;
- // Paranoia: avoid brute force searches (bug 17342)
- $user = $this->getUser();
- if( !$user->isAllowed( 'deletedhistory' ) ) {
- $this->mConds[] = $this->mDb->bitAnd('log_deleted', LogPage::DELETED_USER) . ' = 0';
- } elseif( !$user->isAllowed( 'suppressrevision' ) ) {
- $this->mConds[] = $this->mDb->bitAnd('log_deleted', LogPage::SUPPRESSED_USER) .
- ' != ' . LogPage::SUPPRESSED_USER;
- }
- $this->performer = $usertitle->getText();
- }
- }
-
- /**
- * Set the log reader to return only entries affecting the given page.
- * (For the block and rights logs, this is a user page.)
- *
- * @param $page String or Title object: Title name
- * @param $pattern String
- */
- private function limitTitle( $page, $pattern ) {
- global $wgMiserMode;
-
- if ( $page instanceof Title ) {
- $title = $page;
- } else {
- $title = Title::newFromText( $page );
- if( strlen( $page ) == 0 || !$title instanceof Title ) {
- return false;
- }
- }
-
- $this->title = $title->getPrefixedText();
- $ns = $title->getNamespace();
- $db = $this->mDb;
-
- # Using the (log_namespace, log_title, log_timestamp) index with a
- # range scan (LIKE) on the first two parts, instead of simple equality,
- # makes it unusable for sorting. Sorted retrieval using another index
- # would be possible, but then we might have to scan arbitrarily many
- # nodes of that index. Therefore, we need to avoid this if $wgMiserMode
- # is on.
- #
- # This is not a problem with simple title matches, because then we can
- # use the page_time index. That should have no more than a few hundred
- # log entries for even the busiest pages, so it can be safely scanned
- # in full to satisfy an impossible condition on user or similar.
- if( $pattern && !$wgMiserMode ) {
- $this->mConds['log_namespace'] = $ns;
- $this->mConds[] = 'log_title ' . $db->buildLike( $title->getDBkey(), $db->anyString() );
- $this->pattern = $pattern;
- } else {
- $this->mConds['log_namespace'] = $ns;
- $this->mConds['log_title'] = $title->getDBkey();
- }
- // Paranoia: avoid brute force searches (bug 17342)
- $user = $this->getUser();
- if( !$user->isAllowed( 'deletedhistory' ) ) {
- $this->mConds[] = $db->bitAnd('log_deleted', LogPage::DELETED_ACTION) . ' = 0';
- } elseif( !$user->isAllowed( 'suppressrevision' ) ) {
- $this->mConds[] = $db->bitAnd('log_deleted', LogPage::SUPPRESSED_ACTION) .
- ' != ' . LogPage::SUPPRESSED_ACTION;
- }
- }
-
- /**
- * Constructs the most part of the query. Extra conditions are sprinkled in
- * all over this class.
- * @return array
- */
- public function getQueryInfo() {
- $basic = DatabaseLogEntry::getSelectQueryData();
-
- $tables = $basic['tables'];
- $fields = $basic['fields'];
- $conds = $basic['conds'];
- $options = $basic['options'];
- $joins = $basic['join_conds'];
-
- $index = array();
- # Add log_search table if there are conditions on it.
- # This filters the results to only include log rows that have
- # log_search records with the specified ls_field and ls_value values.
- if( array_key_exists( 'ls_field', $this->mConds ) ) {
- $tables[] = 'log_search';
- $index['log_search'] = 'ls_field_val';
- $index['logging'] = 'PRIMARY';
- if ( !$this->hasEqualsClause( 'ls_field' )
- || !$this->hasEqualsClause( 'ls_value' ) )
- {
- # Since (ls_field,ls_value,ls_logid) is unique, if the condition is
- # to match a specific (ls_field,ls_value) tuple, then there will be
- # no duplicate log rows. Otherwise, we need to remove the duplicates.
- $options[] = 'DISTINCT';
- }
- # Avoid usage of the wrong index by limiting
- # the choices of available indexes. This mainly
- # avoids site-breaking filesorts.
- } elseif( $this->title || $this->pattern || $this->performer ) {
- $index['logging'] = array( 'page_time', 'user_time' );
- if( count($this->types) == 1 ) {
- $index['logging'][] = 'log_user_type_time';
- }
- } elseif( count($this->types) == 1 ) {
- $index['logging'] = 'type_time';
- } else {
- $index['logging'] = 'times';
- }
- $options['USE INDEX'] = $index;
- # Don't show duplicate rows when using log_search
- $joins['log_search'] = array( 'INNER JOIN', 'ls_log_id=log_id' );
-
- $info = array(
- 'tables' => $tables,
- 'fields' => $fields,
- 'conds' => array_merge( $conds, $this->mConds ),
- 'options' => $options,
- 'join_conds' => $joins,
- );
- # Add ChangeTags filter query
- ChangeTags::modifyDisplayQuery( $info['tables'], $info['fields'], $info['conds'],
- $info['join_conds'], $info['options'], $this->mTagFilter );
- return $info;
- }
-
- /**
- * Checks if $this->mConds has $field matched to a *single* value
- * @param $field
- * @return bool
- */
- protected function hasEqualsClause( $field ) {
- return (
- array_key_exists( $field, $this->mConds ) &&
- ( !is_array( $this->mConds[$field] ) || count( $this->mConds[$field] ) == 1 )
- );
- }
-
- function getIndexField() {
- return 'log_timestamp';
- }
-
- public function getStartBody() {
- wfProfileIn( __METHOD__ );
- # Do a link batch query
- if( $this->getNumRows() > 0 ) {
- $lb = new LinkBatch;
- foreach ( $this->mResult as $row ) {
- $lb->add( $row->log_namespace, $row->log_title );
- $lb->addObj( Title::makeTitleSafe( NS_USER, $row->user_name ) );
- $lb->addObj( Title::makeTitleSafe( NS_USER_TALK, $row->user_name ) );
- }
- $lb->execute();
- $this->mResult->seek( 0 );
- }
- wfProfileOut( __METHOD__ );
- return '';
- }
-
- public function formatRow( $row ) {
- return $this->mLogEventsList->logLine( $row );
- }
-
- public function getType() {
- return $this->types;
- }
-
- /**
- * @return string
- */
- public function getPerformer() {
- return $this->performer;
- }
-
- /**
- * @return string
- */
- public function getPage() {
- return $this->title;
- }
-
- public function getPattern() {
- return $this->pattern;
- }
-
- public function getYear() {
- return $this->mYear;
- }
-
- public function getMonth() {
- return $this->mMonth;
- }
-
- public function getTagFilter() {
- return $this->mTagFilter;
- }
-
- public function doQuery() {
- // Workaround MySQL optimizer bug
- $this->mDb->setBigSelects();
- parent::doQuery();
- $this->mDb->setBigSelects( 'default' );
- }
-}
-
+++ /dev/null
-<?php
-/**
- * Contain log classes
- *
- * Copyright © 2002, 2004 Brion Vibber <brion@pobox.com>
- * http://www.mediawiki.org/
- *
- * This program is free software; you can redistribute it and/or modify
- * it under the terms of the GNU General Public License as published by
- * the Free Software Foundation; either version 2 of the License, or
- * (at your option) any later version.
- *
- * This program is distributed in the hope that it will be useful,
- * but WITHOUT ANY WARRANTY; without even the implied warranty of
- * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- * GNU General Public License for more details.
- *
- * You should have received a copy of the GNU General Public License along
- * with this program; if not, write to the Free Software Foundation, Inc.,
- * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
- * http://www.gnu.org/copyleft/gpl.html
- *
- * @file
- */
-
-/**
- * Class to simplify the use of log pages.
- * The logs are now kept in a table which is easier to manage and trim
- * than ever-growing wiki pages.
- *
- */
-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;
- /* @access private */
- var $type, $action, $comment, $params;
-
- /**
- * @var User
- */
- var $doer;
-
- /**
- * @var Title
- */
- var $target;
-
- /* @acess public */
- var $updateRecentChanges, $sendToUDP;
-
- /**
- * Constructor
- *
- * @param $type String: one of '', 'block', 'protect', 'rights', 'delete',
- * 'upload', 'move'
- * @param $rc Boolean: whether to update recent changes as well as the logging table
- * @param $udp String: pass 'UDP' to send to the UDP feed if NOT sent to RC
- */
- public function __construct( $type, $rc = true, $udp = 'skipUDP' ) {
- $this->type = $type;
- $this->updateRecentChanges = $rc;
- $this->sendToUDP = ( $udp == 'UDP' );
- }
-
- /**
- * @return bool|int|null
- */
- protected function saveContent() {
- global $wgLogRestrictions;
-
- $dbw = wfGetDB( DB_MASTER );
- $log_id = $dbw->nextSequenceValue( 'logging_log_id_seq' );
-
- $this->timestamp = $now = wfTimestampNow();
- $data = array(
- '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
- );
- } elseif( $this->sendToUDP ) {
- # Don't send private logs to UDP
- if( isset( $wgLogRestrictions[$this->type] ) && $wgLogRestrictions[$this->type] != '*' ) {
- return true;
- }
-
- # 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
- );
- $rc->notifyRC2UDP();
- }
- return $newId;
- }
-
- /**
- * Get the RC comment from the last addEntry() call
- *
- * @return string
- */
- public function getRcComment() {
- $rcComment = $this->actionText;
-
- if( $this->comment != '' ) {
- if ( $rcComment == '' ) {
- $rcComment = $this->comment;
- } else {
- $rcComment .= wfMsgForContent( 'colon-separator' ) . $this->comment;
- }
- }
-
- return $rcComment;
- }
-
- /**
- * Get the comment from the last addEntry() call
- */
- public function getComment() {
- return $this->comment;
- }
-
- /**
- * Get the list of valid log types
- *
- * @return Array of strings
- */
- public static function validTypes() {
- global $wgLogTypes;
- return $wgLogTypes;
- }
-
- /**
- * Is $type a valid log type
- *
- * @param $type String: log type to check
- * @return Boolean
- */
- public static function isLogType( $type ) {
- return in_array( $type, LogPage::validTypes() );
- }
-
- /**
- * Get the name for the given log type
- *
- * @param $type String: logtype
- * @return String: log name
- * @deprecated in 1.19, warnings in 1.21. Use getName()
- */
- public static function logName( $type ) {
- # wfDeprecated( __METHOD__, '1.19' );
- global $wgLogNames;
-
- if( isset( $wgLogNames[$type] ) ) {
- return str_replace( '_', ' ', wfMsg( $wgLogNames[$type] ) );
- } else {
- // Bogus log types? Perhaps an extension was removed.
- return $type;
- }
- }
-
- /**
- * Get the log header for the given log type
- *
- * @todo handle missing log types
- * @param $type String: logtype
- * @return String: headertext of this logtype
- * @deprecated in 1.19, warnings in 1.21. Use getDescription()
- */
- public static function logHeader( $type ) {
- # wfDeprecated( __METHOD__, '1.19' );
- global $wgLogHeaders;
- return wfMsgExt( $wgLogHeaders[$type], array( 'parseinline' ) );
- }
-
- /**
- * Generate text for a log entry
- *
- * @param $type String: log type
- * @param $action String: log action
- * @param $title Mixed: Title object or null
- * @param $skin Mixed: Skin object or null. If null, we want to use the wiki
- * content language, since that will go to the IRC feed.
- * @param $params Array: parameters
- * @param $filterWikilinks Boolean: whether to filter wiki links
- * @return HTML string
- */
- public static function actionText( $type, $action, $title = null, $skin = null,
- $params = array(), $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 = wfMsgExt( $wgLogActions[$key], array( 'parsemag', 'escape', 'language' => $langObj ) );
- } else {
- $titleLink = self::getTitleLink( $type, $langObjOrNull, $title, $params );
-
- if( preg_match( '/^rights\/(rights|autopromote)/', $key ) ) {
- $rightsnone = wfMsgExt( 'rightsnone', array( 'parsemag', 'language' => $langObj ) );
-
- if( $skin ) {
- foreach ( $params as &$param ) {
- $groupArray = array_map( 'trim', explode( ',', $param ) );
- $groupArray = array_map( array( 'User', 'getGroupMember' ), $groupArray );
- $param = $wgLang->listToText( $groupArray );
- }
- }
-
- if( !isset( $params[0] ) || trim( $params[0] ) == '' ) {
- $params[0] = $rightsnone;
- }
-
- if( !isset( $params[1] ) || trim( $params[1] ) == '' ) {
- $params[1] = $rightsnone;
- }
- }
-
- if( count( $params ) == 0 ) {
- $rv = wfMsgExt( $wgLogActions[$key], array( 'parsemag', 'escape', 'replaceafter', 'language' => $langObj ), $titleLink );
- } else {
- $details = '';
- array_unshift( $params, $titleLink );
-
- // User suppression
- if ( preg_match( '/^(block|suppress)\/(block|reblock)$/', $key ) ) {
- if ( $skin ) {
- $params[1] = '<span class="blockExpiry" dir="ltr" title="' . htmlspecialchars( $params[1] ). '">' .
- $wgLang->translateBlockExpiry( $params[1] ) . '</span>';
- } else {
- $params[1] = $wgContLang->translateBlockExpiry( $params[1] );
- }
-
- $params[2] = isset( $params[2] ) ?
- self::formatBlockFlags( $params[2], $langObj ) : '';
- // Page protections
- } elseif ( $type == 'protect' && count($params) == 3 ) {
- // Restrictions and expiries
- if( $skin ) {
- $details .= $wgLang->getDirMark() . htmlspecialchars( " {$params[1]}" );
- } else {
- $details .= " {$params[1]}";
- }
-
- // Cascading flag...
- if( $params[2] ) {
- $details .= ' [' . wfMsgExt( 'protect-summary-cascade', array( 'parsemag', 'language' => $langObj ) ) . ']';
- }
- }
-
- $rv = wfMsgExt( $wgLogActions[$key], array( 'parsemag', 'escape', 'replaceafter', 'language' => $langObj ), $params ) . $details;
- }
- }
- } 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;
- }
-
- /**
- * TODO document
- * @param $type String
- * @param $lang Language or null
- * @param $title Title
- * @param $params Array
- * @return String
- */
- protected static function getTitleLink( $type, $lang, $title, &$params ) {
- global $wgContLang, $wgUserrightsInterwikiDelimiter;
-
- if( !$lang ) {
- return $title->getPrefixedText();
- }
-
- switch( $type ) {
- case 'move':
- $titleLink = Linker::link(
- $title,
- htmlspecialchars( $title->getPrefixedText() ),
- array(),
- array( 'redirect' => 'no' )
- );
-
- $targetTitle = Title::newFromText( $params[0] );
-
- if ( !$targetTitle ) {
- # Workaround for broken database
- $params[0] = htmlspecialchars( $params[0] );
- } else {
- $params[0] = Linker::link(
- $targetTitle,
- htmlspecialchars( $params[0] )
- );
- }
- break;
- case 'block':
- if( substr( $title->getText(), 0, 1 ) == '#' ) {
- $titleLink = $title->getText();
- } else {
- // @todo Store the user identifier in the parameters
- // to make this faster for future log entries
- $id = User::idFromName( $title->getText() );
- $titleLink = Linker::userLink( $id, $title->getText() )
- . Linker::userToolLinks( $id, $title->getText(), false, Linker::TOOL_LINKS_NOBLOCK );
- }
- break;
- case 'rights':
- $text = $wgContLang->ucfirst( $title->getText() );
- $parts = explode( $wgUserrightsInterwikiDelimiter, $text, 2 );
-
- if ( count( $parts ) == 2 ) {
- $titleLink = WikiMap::foreignUserLink( $parts[1], $parts[0],
- htmlspecialchars( $title->getPrefixedText() ) );
-
- if ( $titleLink !== false ) {
- break;
- }
- }
- $titleLink = Linker::link( Title::makeTitle( NS_USER, $text ) );
- break;
- case 'merge':
- $titleLink = Linker::link(
- $title,
- $title->getPrefixedText(),
- array(),
- array( 'redirect' => 'no' )
- );
- $params[0] = Linker::link(
- Title::newFromText( $params[0] ),
- htmlspecialchars( $params[0] )
- );
- $params[1] = $lang->timeanddate( $params[1] );
- break;
- default:
- if( $title->isSpecialPage() ) {
- list( $name, $par ) = SpecialPageFactory::resolveAlias( $title->getDBkey() );
-
- # Use the language name for log titles, rather than Log/X
- if( $name == 'Log' ) {
- $titleLink = '(' . Linker::link( $title, LogPage::logName( $par ) ) . ')';
- } else {
- $titleLink = Linker::link( $title );
- }
- } else {
- $titleLink = Linker::link( $title );
- }
- }
-
- return $titleLink;
- }
-
- /**
- * Add a log entry
- *
- * @param $action String: one of '', 'block', 'protect', 'rights', 'delete', 'upload', 'move', 'move_redir'
- * @param $target Title object
- * @param $comment String: description associated
- * @param $params Array: parameters passed later to wfMsg.* functions
- * @param $doer User object: the user doing the action
- *
- * @return bool|int|null
- */
- public function addEntry( $action, $target, $comment, $params = array(), $doer = null ) {
- global $wgContLang;
-
- if ( !is_array( $params ) ) {
- $params = array( $params );
- }
-
- if ( $comment === null ) {
- $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;
-
- $this->actionText = LogPage::actionText( $this->type, $action, $target, null, $params );
-
- return $this->saveContent();
- }
-
- /**
- * Add relations to log_search table
- *
- * @param $field String
- * @param $values Array
- * @param $logid Integer
- * @return Boolean
- */
- public function addRelations( $field, $values, $logid ) {
- if( !strlen( $field ) || empty( $values ) ) {
- return false; // nothing
- }
-
- $data = array();
-
- foreach( $values as $value ) {
- $data[] = array(
- 'ls_field' => $field,
- 'ls_value' => $value,
- 'ls_log_id' => $logid
- );
- }
-
- $dbw = wfGetDB( DB_MASTER );
- $dbw->insert( 'log_search', $data, __METHOD__, 'IGNORE' );
-
- return true;
- }
-
- /**
- * Create a blob from a parameter array
- *
- * @param $params Array
- * @return String
- */
- public static function makeParamBlob( $params ) {
- return implode( "\n", $params );
- }
-
- /**
- * Extract a parameter array from a blob
- *
- * @param $blob String
- * @return Array
- */
- public static function extractParams( $blob ) {
- if ( $blob === '' ) {
- return array();
- } else {
- return explode( "\n", $blob );
- }
- }
-
- /**
- * Convert a comma-delimited list of block log flags
- * into a more readable (and translated) form
- *
- * @param $flags Flags to format
- * @param $lang Language object to use
- * @return String
- */
- public static function formatBlockFlags( $flags, $lang ) {
- $flags = explode( ',', trim( $flags ) );
-
- if( count( $flags ) > 0 ) {
- for( $i = 0; $i < count( $flags ); $i++ ) {
- $flags[$i] = self::formatBlockFlag( $flags[$i], $lang );
- }
- return '(' . $lang->commaList( $flags ) . ')';
- } else {
- return '';
- }
- }
-
- /**
- * Translate a block log flag if possible
- *
- * @param $flag int Flag to translate
- * @param $lang Language object to use
- * @return String
- */
- public static function formatBlockFlag( $flag, $lang ) {
- static $messages = array();
-
- if( !isset( $messages[$flag] ) ) {
- $messages[$flag] = htmlspecialchars( $flag ); // Fallback
-
- // For grepping. The following core messages can be used here:
- // * block-log-flags-angry-autoblock
- // * block-log-flags-anononly
- // * block-log-flags-hiddenname
- // * block-log-flags-noautoblock
- // * block-log-flags-nocreate
- // * block-log-flags-noemail
- // * block-log-flags-nousertalk
- $msg = wfMessage( 'block-log-flags-' . $flag )->inLanguage( $lang );
-
- if ( $msg->exists() ) {
- $messages[$flag] = $msg->escaped();
- }
- }
-
- return $messages[$flag];
- }
-
-
- /**
- * Name of the log.
- * @return Message
- * @since 1.19
- */
- public function getName() {
- global $wgLogNames;
-
- // BC
- if ( isset( $wgLogNames[$this->type] ) ) {
- $key = $wgLogNames[$this->type];
- } else {
- $key = 'log-name-' . $this->type;
- }
-
- return wfMessage( $key );
- }
-
- /**
- * Description of this log type.
- * @return Message
- * @since 1.19
- */
- public function getDescription() {
- global $wgLogHeaders;
- // BC
- if ( isset( $wgLogHeaders[$this->type] ) ) {
- $key = $wgLogHeaders[$this->type];
- } else {
- $key = 'log-description-' . $this->type;
- }
- return wfMessage( $key );
- }
-
- /**
- * Returns the right needed to read this log type.
- * @return string
- * @since 1.19
- */
- public function getRestriction() {
- global $wgLogRestrictions;
- if ( isset( $wgLogRestrictions[$this->type] ) ) {
- $restriction = $wgLogRestrictions[$this->type];
- } else {
- // '' always returns true with $user->isAllowed()
- $restriction = '';
- }
- return $restriction;
- }
-
- /**
- * Tells if this log is not viewable by all.
- * @return bool
- * @since 1.19
- */
- public function isRestricted() {
- $restriction = $this->getRestriction();
- return $restriction !== '' && $restriction !== '*';
- }
-
-}
--- /dev/null
+<?php
+/**
+ * Contain classes to list log entries
+ *
+ * Copyright © 2004 Brion Vibber <brion@pobox.com>, 2008 Aaron Schulz
+ * http://www.mediawiki.org/
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ */
+
+class LogEventsList {
+ const NO_ACTION_LINK = 1;
+ const NO_EXTRA_USER_LINKS = 2;
+
+ /**
+ * @var Skin
+ */
+ private $skin;
+
+ /**
+ * @var OutputPage
+ */
+ private $out;
+ public $flags;
+
+ /**
+ * @var Array
+ */
+ protected $message;
+
+ /**
+ * @var Array
+ */
+ protected $mDefaultQuery;
+
+ public function __construct( $skin, $out, $flags = 0 ) {
+ $this->skin = $skin;
+ $this->out = $out;
+ $this->flags = $flags;
+ $this->preCacheMessages();
+ }
+
+ /**
+ * As we use the same small set of messages in various methods and that
+ * they are called often, we call them once and save them in $this->message
+ */
+ private function preCacheMessages() {
+ // Precache various messages
+ if( !isset( $this->message ) ) {
+ $messages = array( 'revertmerge', 'protect_change', 'unblocklink', 'change-blocklink',
+ 'revertmove', 'undeletelink', 'undeleteviewlink', 'revdel-restore', 'hist', 'diff',
+ 'pipe-separator', 'revdel-restore-deleted', 'revdel-restore-visible' );
+ foreach( $messages as $msg ) {
+ $this->message[$msg] = wfMsgExt( $msg, array( 'escapenoentities' ) );
+ }
+ }
+ }
+
+ /**
+ * Set page title and show header for this log type
+ * @param $type Array
+ * @deprecated in 1.19
+ */
+ public function showHeader( $type ) {
+ wfDeprecated( __METHOD__, '1.19' );
+ // If only one log type is used, then show a special message...
+ $headerType = (count($type) == 1) ? $type[0] : '';
+ if( LogPage::isLogType( $headerType ) ) {
+ $page = new LogPage( $headerType );
+ $this->out->setPageTitle( $page->getName()->text() );
+ $this->out->addHTML( $page->getDescription()->parseAsBlock() );
+ } else {
+ $this->out->addHTML( wfMsgExt('alllogstext',array('parseinline')) );
+ }
+ }
+
+ /**
+ * Show options for the log list
+ *
+ * @param $types string or Array
+ * @param $user String
+ * @param $page String
+ * @param $pattern String
+ * @param $year Integer: year
+ * @param $month Integer: month
+ * @param $filter: array
+ * @param $tagFilter: array?
+ */
+ public function showOptions( $types=array(), $user='', $page='', $pattern='', $year='',
+ $month = '', $filter = null, $tagFilter='' ) {
+ global $wgScript, $wgMiserMode;
+
+ $action = $wgScript;
+ $title = SpecialPage::getTitleFor( 'Log' );
+ $special = $title->getPrefixedDBkey();
+
+ // For B/C, we take strings, but make sure they are converted...
+ $types = ($types === '') ? array() : (array)$types;
+
+ $tagSelector = ChangeTags::buildTagFilterSelector( $tagFilter );
+
+ $html = Html::hidden( 'title', $special );
+
+ // Basic selectors
+ $html .= $this->getTypeMenu( $types ) . "\n";
+ $html .= $this->getUserInput( $user ) . "\n";
+ $html .= $this->getTitleInput( $page ) . "\n";
+ $html .= $this->getExtraInputs( $types ) . "\n";
+
+ // Title pattern, if allowed
+ if (!$wgMiserMode) {
+ $html .= $this->getTitlePattern( $pattern ) . "\n";
+ }
+
+ // date menu
+ $html .= Xml::tags( 'p', null, Xml::dateMenu( $year, $month ) );
+
+ // Tag filter
+ if ($tagSelector) {
+ $html .= Xml::tags( 'p', null, implode( ' ', $tagSelector ) );
+ }
+
+ // Filter links
+ if ($filter) {
+ $html .= Xml::tags( 'p', null, $this->getFilterLinks( $filter ) );
+ }
+
+ // Submit button
+ $html .= Xml::submitButton( wfMsg( 'allpagessubmit' ) );
+
+ // Fieldset
+ $html = Xml::fieldset( wfMsg( 'log' ), $html );
+
+ // Form wrapping
+ $html = Xml::tags( 'form', array( 'action' => $action, 'method' => 'get' ), $html );
+
+ $this->out->addHTML( $html );
+ }
+
+ /**
+ * @param $filter Array
+ * @return String: Formatted HTML
+ */
+ private function getFilterLinks( $filter ) {
+ global $wgLang;
+ // show/hide links
+ $messages = array( wfMsgHtml( 'show' ), wfMsgHtml( 'hide' ) );
+ // Option value -> message mapping
+ $links = array();
+ $hiddens = ''; // keep track for "go" button
+ foreach( $filter as $type => $val ) {
+ // Should the below assignment be outside the foreach?
+ // Then it would have to be copied. Not certain what is more expensive.
+ $query = $this->getDefaultQuery();
+ $queryKey = "hide_{$type}_log";
+
+ $hideVal = 1 - intval($val);
+ $query[$queryKey] = $hideVal;
+
+ $link = Linker::link(
+ $this->getDisplayTitle(),
+ $messages[$hideVal],
+ array(),
+ $query,
+ array( 'known', 'noclasses' )
+ );
+
+ $links[$type] = wfMsgHtml( "log-show-hide-{$type}", $link );
+ $hiddens .= Html::hidden( "hide_{$type}_log", $val ) . "\n";
+ }
+ // Build links
+ return '<small>'.$wgLang->pipeList( $links ) . '</small>' . $hiddens;
+ }
+
+ private function getDefaultQuery() {
+ global $wgRequest;
+
+ if ( !isset( $this->mDefaultQuery ) ) {
+ $this->mDefaultQuery = $wgRequest->getQueryValues();
+ unset( $this->mDefaultQuery['title'] );
+ unset( $this->mDefaultQuery['dir'] );
+ unset( $this->mDefaultQuery['offset'] );
+ unset( $this->mDefaultQuery['limit'] );
+ unset( $this->mDefaultQuery['order'] );
+ unset( $this->mDefaultQuery['month'] );
+ unset( $this->mDefaultQuery['year'] );
+ }
+ return $this->mDefaultQuery;
+ }
+
+ /**
+ * Get the Title object of the page the links should point to.
+ * This is NOT the Title of the page the entries should be restricted to.
+ *
+ * @return Title object
+ */
+ public function getDisplayTitle() {
+ return $this->out->getTitle();
+ }
+
+ public function getContext() {
+ return $this->out->getContext();
+ }
+
+ /**
+ * @param $queryTypes Array
+ * @return String: Formatted HTML
+ */
+ private function getTypeMenu( $queryTypes ) {
+ $queryType = count($queryTypes) == 1 ? $queryTypes[0] : '';
+ $selector = $this->getTypeSelector();
+ $selector->setDefault( $queryType );
+ return $selector->getHtml();
+ }
+
+ /**
+ * Returns log page selector.
+ * @param $default string The default selection
+ * @return XmlSelect
+ * @since 1.19
+ */
+ public function getTypeSelector() {
+ global $wgUser;
+
+ $typesByName = array(); // Temporary array
+ // First pass to load the log names
+ foreach( LogPage::validTypes() as $type ) {
+ $page = new LogPage( $type );
+ $restriction = $page->getRestriction();
+ if ( $wgUser->isAllowed( $restriction ) ) {
+ $typesByName[$type] = $page->getName()->text();
+ }
+ }
+
+ // Second pass to sort by name
+ asort($typesByName);
+
+ // Always put "All public logs" on top
+ $public = $typesByName[''];
+ unset( $typesByName[''] );
+ $typesByName = array( '' => $public ) + $typesByName;
+
+ $select = new XmlSelect( 'type' );
+ foreach( $typesByName as $type => $name ) {
+ $select->addOption( $name, $type );
+ }
+
+ return $select;
+ }
+
+ /**
+ * @param $user String
+ * @return String: Formatted HTML
+ */
+ private function getUserInput( $user ) {
+ return '<span style="white-space: nowrap">' .
+ Xml::inputLabel( wfMsg( 'specialloguserlabel' ), 'user', 'mw-log-user', 15, $user ) .
+ '</span>';
+ }
+
+ /**
+ * @param $title String
+ * @return String: Formatted HTML
+ */
+ private function getTitleInput( $title ) {
+ return '<span style="white-space: nowrap">' .
+ Xml::inputLabel( wfMsg( 'speciallogtitlelabel' ), 'page', 'mw-log-page', 20, $title ) .
+ '</span>';
+ }
+
+ /**
+ * @param $pattern
+ * @return string Checkbox
+ */
+ private function getTitlePattern( $pattern ) {
+ return '<span style="white-space: nowrap">' .
+ Xml::checkLabel( wfMsg( 'log-title-wildcard' ), 'pattern', 'pattern', $pattern ) .
+ '</span>';
+ }
+
+ /**
+ * @param $types
+ * @return string
+ */
+ private function getExtraInputs( $types ) {
+ global $wgRequest;
+ $offender = $wgRequest->getVal('offender');
+ $user = User::newFromName( $offender, false );
+ if( !$user || ($user->getId() == 0 && !IP::isIPAddress($offender) ) ) {
+ $offender = ''; // Blank field if invalid
+ }
+ if( count($types) == 1 && $types[0] == 'suppress' ) {
+ return Xml::inputLabel( wfMsg('revdelete-offender'), 'offender',
+ 'mw-log-offender', 20, $offender );
+ }
+ return '';
+ }
+
+ /**
+ * @return string
+ */
+ public function beginLogEventsList() {
+ return "<ul>\n";
+ }
+
+ /**
+ * @return string
+ */
+ public function endLogEventsList() {
+ return "</ul>\n";
+ }
+
+ /**
+ * @param $row Row: a single row from the result set
+ * @return String: Formatted HTML list item
+ */
+ public function logLine( $row ) {
+ $entry = DatabaseLogEntry::newFromRow( $row );
+ $formatter = LogFormatter::newFromEntry( $entry );
+ $formatter->setShowUserToolLinks( !( $this->flags & self::NO_EXTRA_USER_LINKS ) );
+
+ $action = $formatter->getActionText();
+ $comment = $formatter->getComment();
+
+ $classes = array( 'mw-logline-' . $entry->getType() );
+ $title = $entry->getTarget();
+ $time = $this->logTimestamp( $entry );
+
+ // Extract extra parameters
+ $paramArray = LogPage::extractParams( $row->log_params );
+ // Add review/revert links and such...
+ $revert = $this->logActionLinks( $row, $title, $paramArray, $comment );
+
+ // Some user can hide log items and have review links
+ $del = $this->getShowHideLinks( $row );
+ if( $del != '' ) $del .= ' ';
+
+ // Any tags...
+ list( $tagDisplay, $newClasses ) = ChangeTags::formatSummaryRow( $row->ts_tags, 'logevent' );
+ $classes = array_merge( $classes, $newClasses );
+
+ return Xml::tags( 'li', array( "class" => implode( ' ', $classes ) ),
+ $del . "$time $action $comment $revert $tagDisplay" ) . "\n";
+ }
+
+ private function logTimestamp( LogEntry $entry ) {
+ global $wgLang;
+ $time = $wgLang->timeanddate( wfTimestamp( TS_MW, $entry->getTimestamp() ), true );
+ return htmlspecialchars( $time );
+ }
+
+ /**
+ * @TODO: split up!
+ *
+ * @param $row
+ * @param Title $title
+ * @param Array $paramArray
+ * @param $comment
+ * @return String
+ */
+ private function logActionLinks( $row, $title, $paramArray, &$comment ) {
+ global $wgUser;
+ if( ( $this->flags & self::NO_ACTION_LINK ) // we don't want to see the action
+ || self::isDeleted( $row, LogPage::DELETED_ACTION ) ) // action is hidden
+ {
+ return '';
+ }
+ $revert = '';
+ if( self::typeAction( $row, 'move', 'move', 'move' ) && !empty( $paramArray[0] ) ) {
+ $destTitle = Title::newFromText( $paramArray[0] );
+ if( $destTitle ) {
+ $revert = '(' . Linker::link(
+ SpecialPage::getTitleFor( 'Movepage' ),
+ $this->message['revertmove'],
+ array(),
+ array(
+ 'wpOldTitle' => $destTitle->getPrefixedDBkey(),
+ 'wpNewTitle' => $title->getPrefixedDBkey(),
+ 'wpReason' => wfMsgForContent( 'revertmove' ),
+ 'wpMovetalk' => 0
+ ),
+ array( 'known', 'noclasses' )
+ ) . ')';
+ }
+ // Show undelete link
+ } elseif( self::typeAction( $row, array( 'delete', 'suppress' ), 'delete', 'deletedhistory' ) ) {
+ if( !$wgUser->isAllowed( 'undelete' ) ) {
+ $viewdeleted = $this->message['undeleteviewlink'];
+ } else {
+ $viewdeleted = $this->message['undeletelink'];
+ }
+ $revert = '(' . Linker::link(
+ SpecialPage::getTitleFor( 'Undelete' ),
+ $viewdeleted,
+ array(),
+ array( 'target' => $title->getPrefixedDBkey() ),
+ array( 'known', 'noclasses' )
+ ) . ')';
+ // Show unblock/change block link
+ } elseif( self::typeAction( $row, array( 'block', 'suppress' ), array( 'block', 'reblock' ), 'block' ) ) {
+ $revert = '(' .
+ Linker::link(
+ SpecialPage::getTitleFor( 'Unblock', $row->log_title ),
+ $this->message['unblocklink'],
+ array(),
+ array(),
+ 'known'
+ ) .
+ $this->message['pipe-separator'] .
+ Linker::link(
+ SpecialPage::getTitleFor( 'Block', $row->log_title ),
+ $this->message['change-blocklink'],
+ array(),
+ array(),
+ 'known'
+ ) .
+ ')';
+ // Show change protection link
+ } elseif( self::typeAction( $row, 'protect', array( 'modify', 'protect', 'unprotect' ) ) ) {
+ $revert .= ' (' .
+ Linker::link( $title,
+ $this->message['hist'],
+ array(),
+ array(
+ 'action' => 'history',
+ 'offset' => $row->log_timestamp
+ )
+ );
+ if( $wgUser->isAllowed( 'protect' ) ) {
+ $revert .= $this->message['pipe-separator'] .
+ Linker::link( $title,
+ $this->message['protect_change'],
+ array(),
+ array( 'action' => 'protect' ),
+ 'known' );
+ }
+ $revert .= ')';
+ // Show unmerge link
+ } elseif( self::typeAction( $row, 'merge', 'merge', 'mergehistory' ) ) {
+ $revert = '(' . Linker::link(
+ SpecialPage::getTitleFor( 'MergeHistory' ),
+ $this->message['revertmerge'],
+ array(),
+ array(
+ 'target' => $paramArray[0],
+ 'dest' => $title->getPrefixedDBkey(),
+ 'mergepoint' => $paramArray[1]
+ ),
+ array( 'known', 'noclasses' )
+ ) . ')';
+ // If an edit was hidden from a page give a review link to the history
+ } elseif( self::typeAction( $row, array( 'delete', 'suppress' ), 'revision', 'deletedhistory' ) ) {
+ $revert = RevisionDeleter::getLogLinks( $title, $paramArray,
+ $this->message );
+ // Hidden log items, give review link
+ } elseif( self::typeAction( $row, array( 'delete', 'suppress' ), 'event', 'deletedhistory' ) ) {
+ if( count($paramArray) >= 1 ) {
+ $revdel = SpecialPage::getTitleFor( 'Revisiondelete' );
+ // $paramArray[1] is a CSV of the IDs
+ $query = $paramArray[0];
+ // Link to each hidden object ID, $paramArray[1] is the url param
+ $revert = '(' . Linker::link(
+ $revdel,
+ $this->message['revdel-restore'],
+ array(),
+ array(
+ 'target' => $title->getPrefixedText(),
+ 'type' => 'logging',
+ 'ids' => $query
+ ),
+ array( 'known', 'noclasses' )
+ ) . ')';
+ }
+ // Do nothing. The implementation is handled by the hook modifiying the passed-by-ref parameters.
+ } else {
+ wfRunHooks( 'LogLine', array( $row->log_type, $row->log_action, $title, $paramArray,
+ &$comment, &$revert, $row->log_timestamp ) );
+ }
+ if( $revert != '' ) {
+ $revert = '<span class="mw-logevent-actionlink">' . $revert . '</span>';
+ }
+ return $revert;
+ }
+
+ /**
+ * @param $row Row
+ * @return string
+ */
+ private function getShowHideLinks( $row ) {
+ global $wgUser;
+ if( ( $this->flags & self::NO_ACTION_LINK ) // we don't want to see the links
+ || $row->log_type == 'suppress' ) { // no one can hide items from the suppress log
+ return '';
+ }
+ $del = '';
+ // Don't show useless link to people who cannot hide revisions
+ if( $wgUser->isAllowed( 'deletedhistory' ) ) {
+ if( $row->log_deleted || $wgUser->isAllowed( 'deleterevision' ) ) {
+ $canHide = $wgUser->isAllowed( 'deleterevision' );
+ // If event was hidden from sysops
+ if( !self::userCan( $row, LogPage::DELETED_RESTRICTED ) ) {
+ $del = Linker::revDeleteLinkDisabled( $canHide );
+ } else {
+ $target = SpecialPage::getTitleFor( 'Log', $row->log_type );
+ $query = array(
+ 'target' => $target->getPrefixedDBkey(),
+ 'type' => 'logging',
+ 'ids' => $row->log_id,
+ );
+ $del = Linker::revDeleteLink( $query,
+ self::isDeleted( $row, LogPage::DELETED_RESTRICTED ), $canHide );
+ }
+ }
+ }
+ return $del;
+ }
+
+ /**
+ * @param $row Row
+ * @param $type Mixed: string/array
+ * @param $action Mixed: string/array
+ * @param $right string
+ * @return Boolean
+ */
+ public static function typeAction( $row, $type, $action, $right='' ) {
+ $match = is_array($type) ?
+ in_array( $row->log_type, $type ) : $row->log_type == $type;
+ if( $match ) {
+ $match = is_array( $action ) ?
+ in_array( $row->log_action, $action ) : $row->log_action == $action;
+ if( $match && $right ) {
+ global $wgUser;
+ $match = $wgUser->isAllowed( $right );
+ }
+ }
+ return $match;
+ }
+
+ /**
+ * Determine if the current user is allowed to view a particular
+ * field of this log row, if it's marked as deleted.
+ *
+ * @param $row Row
+ * @param $field Integer
+ * @param $user User object to check, or null to use $wgUser
+ * @return Boolean
+ */
+ public static function userCan( $row, $field, User $user = null ) {
+ return self::userCanBitfield( $row->log_deleted, $field, $user );
+ }
+
+ /**
+ * Determine if the current user is allowed to view a particular
+ * field of this log row, if it's marked as deleted.
+ *
+ * @param $bitfield Integer (current field)
+ * @param $field Integer
+ * @param $user User object to check, or null to use $wgUser
+ * @return Boolean
+ */
+ public static function userCanBitfield( $bitfield, $field, User $user = null ) {
+ if( $bitfield & $field ) {
+ if ( $bitfield & LogPage::DELETED_RESTRICTED ) {
+ $permission = 'suppressrevision';
+ } else {
+ $permission = 'deletedhistory';
+ }
+ wfDebug( "Checking for $permission due to $field match on $bitfield\n" );
+ if ( $user === null ) {
+ global $wgUser;
+ $user = $wgUser;
+ }
+ return $user->isAllowed( $permission );
+ } else {
+ return true;
+ }
+ }
+
+ /**
+ * @param $row Row
+ * @param $field Integer: one of DELETED_* bitfield constants
+ * @return Boolean
+ */
+ public static function isDeleted( $row, $field ) {
+ return ( $row->log_deleted & $field ) == $field;
+ }
+
+ /**
+ * Show log extract. Either with text and a box (set $msgKey) or without (don't set $msgKey)
+ *
+ * @param $out OutputPage|String-by-reference
+ * @param $types String|Array Log types to show
+ * @param $page String|Title The page title to show log entries for
+ * @param $user String The user who made the log entries
+ * @param $param Associative Array with the following additional options:
+ * - lim Integer Limit of items to show, default is 50
+ * - conds Array Extra conditions for the query (e.g. "log_action != 'revision'")
+ * - showIfEmpty boolean Set to false if you don't want any output in case the loglist is empty
+ * if set to true (default), "No matching items in log" is displayed if loglist is empty
+ * - msgKey Array If you want a nice box with a message, set this to the key of the message.
+ * First element is the message key, additional optional elements are parameters for the key
+ * that are processed with wgMsgExt and option 'parse'
+ * - offset Set to overwrite offset parameter in $wgRequest
+ * set to '' to unset offset
+ * - wrap String Wrap the message in html (usually something like "<div ...>$1</div>").
+ * - flags Integer display flags (NO_ACTION_LINK,NO_EXTRA_USER_LINKS)
+ * @return Integer Number of total log items (not limited by $lim)
+ */
+ public static function showLogExtract(
+ &$out, $types=array(), $page='', $user='', $param = array()
+ ) {
+ $defaultParameters = array(
+ 'lim' => 25,
+ 'conds' => array(),
+ 'showIfEmpty' => true,
+ 'msgKey' => array(''),
+ 'wrap' => "$1",
+ 'flags' => 0
+ );
+ # The + operator appends elements of remaining keys from the right
+ # handed array to the left handed, whereas duplicated keys are NOT overwritten.
+ $param += $defaultParameters;
+ # Convert $param array to individual variables
+ $lim = $param['lim'];
+ $conds = $param['conds'];
+ $showIfEmpty = $param['showIfEmpty'];
+ $msgKey = $param['msgKey'];
+ $wrap = $param['wrap'];
+ $flags = $param['flags'];
+ if ( !is_array( $msgKey ) ) {
+ $msgKey = array( $msgKey );
+ }
+
+ if ( $out instanceof OutputPage ) {
+ $context = $out->getContext();
+ } else {
+ $context = RequestContext::getMain();
+ }
+
+ # Insert list of top 50 (or top $lim) items
+ $loglist = new LogEventsList( $context->getSkin(), $context->getOutput(), $flags );
+ $pager = new LogPager( $loglist, $types, $user, $page, '', $conds );
+ if ( isset( $param['offset'] ) ) { # Tell pager to ignore $wgRequest offset
+ $pager->setOffset( $param['offset'] );
+ }
+ if( $lim > 0 ) $pager->mLimit = $lim;
+ $logBody = $pager->getBody();
+ $s = '';
+ if( $logBody ) {
+ if ( $msgKey[0] ) {
+ $s = '<div class="mw-warning-with-logexcerpt">';
+
+ if ( count( $msgKey ) == 1 ) {
+ $s .= wfMsgExt( $msgKey[0], array( 'parse' ) );
+ } else { // Process additional arguments
+ $args = $msgKey;
+ array_shift( $args );
+ $s .= wfMsgExt( $msgKey[0], array( 'parse' ), $args );
+ }
+ }
+ $s .= $loglist->beginLogEventsList() .
+ $logBody .
+ $loglist->endLogEventsList();
+ } else {
+ if ( $showIfEmpty ) {
+ $s = Html::rawElement( 'div', array( 'class' => 'mw-warning-logempty' ),
+ wfMsgExt( 'logempty', array( 'parseinline' ) ) );
+ }
+ }
+ if( $pager->getNumRows() > $pager->mLimit ) { # Show "Full log" link
+ $urlParam = array();
+ if ( $page instanceof Title ) {
+ $urlParam['page'] = $page->getPrefixedDBkey();
+ } elseif ( $page != '' ) {
+ $urlParam['page'] = $page;
+ }
+ if ( $user != '')
+ $urlParam['user'] = $user;
+ if ( !is_array( $types ) ) # Make it an array, if it isn't
+ $types = array( $types );
+ # If there is exactly one log type, we can link to Special:Log?type=foo
+ if ( count( $types ) == 1 )
+ $urlParam['type'] = $types[0];
+ $s .= Linker::link(
+ SpecialPage::getTitleFor( 'Log' ),
+ wfMsgHtml( 'log-fulllog' ),
+ array(),
+ $urlParam
+ );
+ }
+ if ( $logBody && $msgKey[0] ) {
+ $s .= '</div>';
+ }
+
+ if ( $wrap != '' ) { // Wrap message in html
+ $s = str_replace( '$1', $s, $wrap );
+ }
+
+ /* hook can return false, if we don't want the message to be emitted (Wikia BugId:7093) */
+ if ( wfRunHooks( 'LogEventsListShowLogExtract', array( &$s, $types, $page, $user, $param ) ) ) {
+ // $out can be either an OutputPage object or a String-by-reference
+ if ( $out instanceof OutputPage ){
+ $out->addHTML( $s );
+ } else {
+ $out = $s;
+ }
+ }
+
+ return $pager->getNumRows();
+ }
+
+ /**
+ * SQL clause to skip forbidden log types for this user
+ *
+ * @param $db DatabaseBase
+ * @param $audience string, public/user
+ * @return Mixed: string or false
+ */
+ public static function getExcludeClause( $db, $audience = 'public' ) {
+ global $wgLogRestrictions, $wgUser;
+ // Reset the array, clears extra "where" clauses when $par is used
+ $hiddenLogs = array();
+ // Don't show private logs to unprivileged users
+ foreach( $wgLogRestrictions as $logType => $right ) {
+ if( $audience == 'public' || !$wgUser->isAllowed($right) ) {
+ $safeType = $db->strencode( $logType );
+ $hiddenLogs[] = $safeType;
+ }
+ }
+ if( count($hiddenLogs) == 1 ) {
+ return 'log_type != ' . $db->addQuotes( $hiddenLogs[0] );
+ } elseif( $hiddenLogs ) {
+ return 'log_type NOT IN (' . $db->makeList($hiddenLogs) . ')';
+ }
+ return false;
+ }
+ }
+
+/**
+ * @ingroup Pager
+ */
+class LogPager extends ReverseChronologicalPager {
+ private $types = array(), $performer = '', $title = '', $pattern = '';
+ private $typeCGI = '';
+ public $mLogEventsList;
+
+ /**
+ * Constructor
+ *
+ * @param $list LogEventsList
+ * @param $types String or Array: log types to show
+ * @param $performer String: the user who made the log entries
+ * @param $title String|Title: the page title the log entries are for
+ * @param $pattern String: do a prefix search rather than an exact title match
+ * @param $conds Array: extra conditions for the query
+ * @param $year Integer: the year to start from
+ * @param $month Integer: the month to start from
+ * @param $tagFilter String: tag
+ */
+ public function __construct( $list, $types = array(), $performer = '', $title = '', $pattern = '',
+ $conds = array(), $year = false, $month = false, $tagFilter = '' ) {
+ parent::__construct( $list->getContext() );
+ $this->mConds = $conds;
+
+ $this->mLogEventsList = $list;
+
+ $this->limitType( $types ); // also excludes hidden types
+ $this->limitPerformer( $performer );
+ $this->limitTitle( $title, $pattern );
+ $this->getDateCond( $year, $month );
+ $this->mTagFilter = $tagFilter;
+ }
+
+ public function getDefaultQuery() {
+ $query = parent::getDefaultQuery();
+ $query['type'] = $this->typeCGI; // arrays won't work here
+ $query['user'] = $this->performer;
+ $query['month'] = $this->mMonth;
+ $query['year'] = $this->mYear;
+ return $query;
+ }
+
+ // Call ONLY after calling $this->limitType() already!
+ public function getFilterParams() {
+ global $wgFilterLogTypes;
+ $filters = array();
+ if( count($this->types) ) {
+ return $filters;
+ }
+ foreach( $wgFilterLogTypes as $type => $default ) {
+ // Avoid silly filtering
+ if( $type !== 'patrol' || $this->getUser()->useNPPatrol() ) {
+ $hide = $this->getRequest()->getInt( "hide_{$type}_log", $default );
+ $filters[$type] = $hide;
+ if( $hide )
+ $this->mConds[] = 'log_type != ' . $this->mDb->addQuotes( $type );
+ }
+ }
+ return $filters;
+ }
+
+ /**
+ * Set the log reader to return only entries of the given type.
+ * Type restrictions enforced here
+ *
+ * @param $types String or array: Log types ('upload', 'delete', etc);
+ * empty string means no restriction
+ */
+ private function limitType( $types ) {
+ global $wgLogRestrictions;
+ // If $types is not an array, make it an array
+ $types = ($types === '') ? array() : (array)$types;
+ // Don't even show header for private logs; don't recognize it...
+ foreach ( $types as $type ) {
+ if( isset( $wgLogRestrictions[$type] )
+ && !$this->getUser()->isAllowed($wgLogRestrictions[$type])
+ ) {
+ $types = array_diff( $types, array( $type ) );
+ }
+ }
+ $this->types = $types;
+ // Don't show private logs to unprivileged users.
+ // Also, only show them upon specific request to avoid suprises.
+ $audience = $types ? 'user' : 'public';
+ $hideLogs = LogEventsList::getExcludeClause( $this->mDb, $audience );
+ if( $hideLogs !== false ) {
+ $this->mConds[] = $hideLogs;
+ }
+ if( count($types) ) {
+ $this->mConds['log_type'] = $types;
+ // Set typeCGI; used in url param for paging
+ if( count($types) == 1 ) $this->typeCGI = $types[0];
+ }
+ }
+
+ /**
+ * Set the log reader to return only entries by the given user.
+ *
+ * @param $name String: (In)valid user name
+ */
+ private function limitPerformer( $name ) {
+ if( $name == '' ) {
+ return false;
+ }
+ $usertitle = Title::makeTitleSafe( NS_USER, $name );
+ if( is_null($usertitle) ) {
+ return false;
+ }
+ /* Fetch userid at first, if known, provides awesome query plan afterwards */
+ $userid = User::idFromName( $name );
+ if( !$userid ) {
+ /* It should be nicer to abort query at all,
+ but for now it won't pass anywhere behind the optimizer */
+ $this->mConds[] = "NULL";
+ } else {
+ $this->mConds['log_user'] = $userid;
+ // Paranoia: avoid brute force searches (bug 17342)
+ $user = $this->getUser();
+ if( !$user->isAllowed( 'deletedhistory' ) ) {
+ $this->mConds[] = $this->mDb->bitAnd('log_deleted', LogPage::DELETED_USER) . ' = 0';
+ } elseif( !$user->isAllowed( 'suppressrevision' ) ) {
+ $this->mConds[] = $this->mDb->bitAnd('log_deleted', LogPage::SUPPRESSED_USER) .
+ ' != ' . LogPage::SUPPRESSED_USER;
+ }
+ $this->performer = $usertitle->getText();
+ }
+ }
+
+ /**
+ * Set the log reader to return only entries affecting the given page.
+ * (For the block and rights logs, this is a user page.)
+ *
+ * @param $page String or Title object: Title name
+ * @param $pattern String
+ */
+ private function limitTitle( $page, $pattern ) {
+ global $wgMiserMode;
+
+ if ( $page instanceof Title ) {
+ $title = $page;
+ } else {
+ $title = Title::newFromText( $page );
+ if( strlen( $page ) == 0 || !$title instanceof Title ) {
+ return false;
+ }
+ }
+
+ $this->title = $title->getPrefixedText();
+ $ns = $title->getNamespace();
+ $db = $this->mDb;
+
+ # Using the (log_namespace, log_title, log_timestamp) index with a
+ # range scan (LIKE) on the first two parts, instead of simple equality,
+ # makes it unusable for sorting. Sorted retrieval using another index
+ # would be possible, but then we might have to scan arbitrarily many
+ # nodes of that index. Therefore, we need to avoid this if $wgMiserMode
+ # is on.
+ #
+ # This is not a problem with simple title matches, because then we can
+ # use the page_time index. That should have no more than a few hundred
+ # log entries for even the busiest pages, so it can be safely scanned
+ # in full to satisfy an impossible condition on user or similar.
+ if( $pattern && !$wgMiserMode ) {
+ $this->mConds['log_namespace'] = $ns;
+ $this->mConds[] = 'log_title ' . $db->buildLike( $title->getDBkey(), $db->anyString() );
+ $this->pattern = $pattern;
+ } else {
+ $this->mConds['log_namespace'] = $ns;
+ $this->mConds['log_title'] = $title->getDBkey();
+ }
+ // Paranoia: avoid brute force searches (bug 17342)
+ $user = $this->getUser();
+ if( !$user->isAllowed( 'deletedhistory' ) ) {
+ $this->mConds[] = $db->bitAnd('log_deleted', LogPage::DELETED_ACTION) . ' = 0';
+ } elseif( !$user->isAllowed( 'suppressrevision' ) ) {
+ $this->mConds[] = $db->bitAnd('log_deleted', LogPage::SUPPRESSED_ACTION) .
+ ' != ' . LogPage::SUPPRESSED_ACTION;
+ }
+ }
+
+ /**
+ * Constructs the most part of the query. Extra conditions are sprinkled in
+ * all over this class.
+ * @return array
+ */
+ public function getQueryInfo() {
+ $basic = DatabaseLogEntry::getSelectQueryData();
+
+ $tables = $basic['tables'];
+ $fields = $basic['fields'];
+ $conds = $basic['conds'];
+ $options = $basic['options'];
+ $joins = $basic['join_conds'];
+
+ $index = array();
+ # Add log_search table if there are conditions on it.
+ # This filters the results to only include log rows that have
+ # log_search records with the specified ls_field and ls_value values.
+ if( array_key_exists( 'ls_field', $this->mConds ) ) {
+ $tables[] = 'log_search';
+ $index['log_search'] = 'ls_field_val';
+ $index['logging'] = 'PRIMARY';
+ if ( !$this->hasEqualsClause( 'ls_field' )
+ || !$this->hasEqualsClause( 'ls_value' ) )
+ {
+ # Since (ls_field,ls_value,ls_logid) is unique, if the condition is
+ # to match a specific (ls_field,ls_value) tuple, then there will be
+ # no duplicate log rows. Otherwise, we need to remove the duplicates.
+ $options[] = 'DISTINCT';
+ }
+ # Avoid usage of the wrong index by limiting
+ # the choices of available indexes. This mainly
+ # avoids site-breaking filesorts.
+ } elseif( $this->title || $this->pattern || $this->performer ) {
+ $index['logging'] = array( 'page_time', 'user_time' );
+ if( count($this->types) == 1 ) {
+ $index['logging'][] = 'log_user_type_time';
+ }
+ } elseif( count($this->types) == 1 ) {
+ $index['logging'] = 'type_time';
+ } else {
+ $index['logging'] = 'times';
+ }
+ $options['USE INDEX'] = $index;
+ # Don't show duplicate rows when using log_search
+ $joins['log_search'] = array( 'INNER JOIN', 'ls_log_id=log_id' );
+
+ $info = array(
+ 'tables' => $tables,
+ 'fields' => $fields,
+ 'conds' => array_merge( $conds, $this->mConds ),
+ 'options' => $options,
+ 'join_conds' => $joins,
+ );
+ # Add ChangeTags filter query
+ ChangeTags::modifyDisplayQuery( $info['tables'], $info['fields'], $info['conds'],
+ $info['join_conds'], $info['options'], $this->mTagFilter );
+ return $info;
+ }
+
+ /**
+ * Checks if $this->mConds has $field matched to a *single* value
+ * @param $field
+ * @return bool
+ */
+ protected function hasEqualsClause( $field ) {
+ return (
+ array_key_exists( $field, $this->mConds ) &&
+ ( !is_array( $this->mConds[$field] ) || count( $this->mConds[$field] ) == 1 )
+ );
+ }
+
+ function getIndexField() {
+ return 'log_timestamp';
+ }
+
+ public function getStartBody() {
+ wfProfileIn( __METHOD__ );
+ # Do a link batch query
+ if( $this->getNumRows() > 0 ) {
+ $lb = new LinkBatch;
+ foreach ( $this->mResult as $row ) {
+ $lb->add( $row->log_namespace, $row->log_title );
+ $lb->addObj( Title::makeTitleSafe( NS_USER, $row->user_name ) );
+ $lb->addObj( Title::makeTitleSafe( NS_USER_TALK, $row->user_name ) );
+ }
+ $lb->execute();
+ $this->mResult->seek( 0 );
+ }
+ wfProfileOut( __METHOD__ );
+ return '';
+ }
+
+ public function formatRow( $row ) {
+ return $this->mLogEventsList->logLine( $row );
+ }
+
+ public function getType() {
+ return $this->types;
+ }
+
+ /**
+ * @return string
+ */
+ public function getPerformer() {
+ return $this->performer;
+ }
+
+ /**
+ * @return string
+ */
+ public function getPage() {
+ return $this->title;
+ }
+
+ public function getPattern() {
+ return $this->pattern;
+ }
+
+ public function getYear() {
+ return $this->mYear;
+ }
+
+ public function getMonth() {
+ return $this->mMonth;
+ }
+
+ public function getTagFilter() {
+ return $this->mTagFilter;
+ }
+
+ public function doQuery() {
+ // Workaround MySQL optimizer bug
+ $this->mDb->setBigSelects();
+ parent::doQuery();
+ $this->mDb->setBigSelects( 'default' );
+ }
+}
+
--- /dev/null
+<?php
+/**
+ * Contain log classes
+ *
+ * Copyright © 2002, 2004 Brion Vibber <brion@pobox.com>
+ * http://www.mediawiki.org/
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License along
+ * with this program; if not, write to the Free Software Foundation, Inc.,
+ * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
+ * http://www.gnu.org/copyleft/gpl.html
+ *
+ * @file
+ */
+
+/**
+ * Class to simplify the use of log pages.
+ * The logs are now kept in a table which is easier to manage and trim
+ * than ever-growing wiki pages.
+ *
+ */
+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;
+ /* @access private */
+ var $type, $action, $comment, $params;
+
+ /**
+ * @var User
+ */
+ var $doer;
+
+ /**
+ * @var Title
+ */
+ var $target;
+
+ /* @acess public */
+ var $updateRecentChanges, $sendToUDP;
+
+ /**
+ * Constructor
+ *
+ * @param $type String: one of '', 'block', 'protect', 'rights', 'delete',
+ * 'upload', 'move'
+ * @param $rc Boolean: whether to update recent changes as well as the logging table
+ * @param $udp String: pass 'UDP' to send to the UDP feed if NOT sent to RC
+ */
+ public function __construct( $type, $rc = true, $udp = 'skipUDP' ) {
+ $this->type = $type;
+ $this->updateRecentChanges = $rc;
+ $this->sendToUDP = ( $udp == 'UDP' );
+ }
+
+ /**
+ * @return bool|int|null
+ */
+ protected function saveContent() {
+ global $wgLogRestrictions;
+
+ $dbw = wfGetDB( DB_MASTER );
+ $log_id = $dbw->nextSequenceValue( 'logging_log_id_seq' );
+
+ $this->timestamp = $now = wfTimestampNow();
+ $data = array(
+ '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
+ );
+ } elseif( $this->sendToUDP ) {
+ # Don't send private logs to UDP
+ if( isset( $wgLogRestrictions[$this->type] ) && $wgLogRestrictions[$this->type] != '*' ) {
+ return true;
+ }
+
+ # 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
+ );
+ $rc->notifyRC2UDP();
+ }
+ return $newId;
+ }
+
+ /**
+ * Get the RC comment from the last addEntry() call
+ *
+ * @return string
+ */
+ public function getRcComment() {
+ $rcComment = $this->actionText;
+
+ if( $this->comment != '' ) {
+ if ( $rcComment == '' ) {
+ $rcComment = $this->comment;
+ } else {
+ $rcComment .= wfMsgForContent( 'colon-separator' ) . $this->comment;
+ }
+ }
+
+ return $rcComment;
+ }
+
+ /**
+ * Get the comment from the last addEntry() call
+ */
+ public function getComment() {
+ return $this->comment;
+ }
+
+ /**
+ * Get the list of valid log types
+ *
+ * @return Array of strings
+ */
+ public static function validTypes() {
+ global $wgLogTypes;
+ return $wgLogTypes;
+ }
+
+ /**
+ * Is $type a valid log type
+ *
+ * @param $type String: log type to check
+ * @return Boolean
+ */
+ public static function isLogType( $type ) {
+ return in_array( $type, LogPage::validTypes() );
+ }
+
+ /**
+ * Get the name for the given log type
+ *
+ * @param $type String: logtype
+ * @return String: log name
+ * @deprecated in 1.19, warnings in 1.21. Use getName()
+ */
+ public static function logName( $type ) {
+ # wfDeprecated( __METHOD__, '1.19' );
+ global $wgLogNames;
+
+ if( isset( $wgLogNames[$type] ) ) {
+ return str_replace( '_', ' ', wfMsg( $wgLogNames[$type] ) );
+ } else {
+ // Bogus log types? Perhaps an extension was removed.
+ return $type;
+ }
+ }
+
+ /**
+ * Get the log header for the given log type
+ *
+ * @todo handle missing log types
+ * @param $type String: logtype
+ * @return String: headertext of this logtype
+ * @deprecated in 1.19, warnings in 1.21. Use getDescription()
+ */
+ public static function logHeader( $type ) {
+ # wfDeprecated( __METHOD__, '1.19' );
+ global $wgLogHeaders;
+ return wfMsgExt( $wgLogHeaders[$type], array( 'parseinline' ) );
+ }
+
+ /**
+ * Generate text for a log entry
+ *
+ * @param $type String: log type
+ * @param $action String: log action
+ * @param $title Mixed: Title object or null
+ * @param $skin Mixed: Skin object or null. If null, we want to use the wiki
+ * content language, since that will go to the IRC feed.
+ * @param $params Array: parameters
+ * @param $filterWikilinks Boolean: whether to filter wiki links
+ * @return HTML string
+ */
+ public static function actionText( $type, $action, $title = null, $skin = null,
+ $params = array(), $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 = wfMsgExt( $wgLogActions[$key], array( 'parsemag', 'escape', 'language' => $langObj ) );
+ } else {
+ $titleLink = self::getTitleLink( $type, $langObjOrNull, $title, $params );
+
+ if( preg_match( '/^rights\/(rights|autopromote)/', $key ) ) {
+ $rightsnone = wfMsgExt( 'rightsnone', array( 'parsemag', 'language' => $langObj ) );
+
+ if( $skin ) {
+ foreach ( $params as &$param ) {
+ $groupArray = array_map( 'trim', explode( ',', $param ) );
+ $groupArray = array_map( array( 'User', 'getGroupMember' ), $groupArray );
+ $param = $wgLang->listToText( $groupArray );
+ }
+ }
+
+ if( !isset( $params[0] ) || trim( $params[0] ) == '' ) {
+ $params[0] = $rightsnone;
+ }
+
+ if( !isset( $params[1] ) || trim( $params[1] ) == '' ) {
+ $params[1] = $rightsnone;
+ }
+ }
+
+ if( count( $params ) == 0 ) {
+ $rv = wfMsgExt( $wgLogActions[$key], array( 'parsemag', 'escape', 'replaceafter', 'language' => $langObj ), $titleLink );
+ } else {
+ $details = '';
+ array_unshift( $params, $titleLink );
+
+ // User suppression
+ if ( preg_match( '/^(block|suppress)\/(block|reblock)$/', $key ) ) {
+ if ( $skin ) {
+ $params[1] = '<span class="blockExpiry" dir="ltr" title="' . htmlspecialchars( $params[1] ). '">' .
+ $wgLang->translateBlockExpiry( $params[1] ) . '</span>';
+ } else {
+ $params[1] = $wgContLang->translateBlockExpiry( $params[1] );
+ }
+
+ $params[2] = isset( $params[2] ) ?
+ self::formatBlockFlags( $params[2], $langObj ) : '';
+ // Page protections
+ } elseif ( $type == 'protect' && count($params) == 3 ) {
+ // Restrictions and expiries
+ if( $skin ) {
+ $details .= $wgLang->getDirMark() . htmlspecialchars( " {$params[1]}" );
+ } else {
+ $details .= " {$params[1]}";
+ }
+
+ // Cascading flag...
+ if( $params[2] ) {
+ $details .= ' [' . wfMsgExt( 'protect-summary-cascade', array( 'parsemag', 'language' => $langObj ) ) . ']';
+ }
+ }
+
+ $rv = wfMsgExt( $wgLogActions[$key], array( 'parsemag', 'escape', 'replaceafter', 'language' => $langObj ), $params ) . $details;
+ }
+ }
+ } 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;
+ }
+
+ /**
+ * TODO document
+ * @param $type String
+ * @param $lang Language or null
+ * @param $title Title
+ * @param $params Array
+ * @return String
+ */
+ protected static function getTitleLink( $type, $lang, $title, &$params ) {
+ global $wgContLang, $wgUserrightsInterwikiDelimiter;
+
+ if( !$lang ) {
+ return $title->getPrefixedText();
+ }
+
+ switch( $type ) {
+ case 'move':
+ $titleLink = Linker::link(
+ $title,
+ htmlspecialchars( $title->getPrefixedText() ),
+ array(),
+ array( 'redirect' => 'no' )
+ );
+
+ $targetTitle = Title::newFromText( $params[0] );
+
+ if ( !$targetTitle ) {
+ # Workaround for broken database
+ $params[0] = htmlspecialchars( $params[0] );
+ } else {
+ $params[0] = Linker::link(
+ $targetTitle,
+ htmlspecialchars( $params[0] )
+ );
+ }
+ break;
+ case 'block':
+ if( substr( $title->getText(), 0, 1 ) == '#' ) {
+ $titleLink = $title->getText();
+ } else {
+ // @todo Store the user identifier in the parameters
+ // to make this faster for future log entries
+ $id = User::idFromName( $title->getText() );
+ $titleLink = Linker::userLink( $id, $title->getText() )
+ . Linker::userToolLinks( $id, $title->getText(), false, Linker::TOOL_LINKS_NOBLOCK );
+ }
+ break;
+ case 'rights':
+ $text = $wgContLang->ucfirst( $title->getText() );
+ $parts = explode( $wgUserrightsInterwikiDelimiter, $text, 2 );
+
+ if ( count( $parts ) == 2 ) {
+ $titleLink = WikiMap::foreignUserLink( $parts[1], $parts[0],
+ htmlspecialchars( $title->getPrefixedText() ) );
+
+ if ( $titleLink !== false ) {
+ break;
+ }
+ }
+ $titleLink = Linker::link( Title::makeTitle( NS_USER, $text ) );
+ break;
+ case 'merge':
+ $titleLink = Linker::link(
+ $title,
+ $title->getPrefixedText(),
+ array(),
+ array( 'redirect' => 'no' )
+ );
+ $params[0] = Linker::link(
+ Title::newFromText( $params[0] ),
+ htmlspecialchars( $params[0] )
+ );
+ $params[1] = $lang->timeanddate( $params[1] );
+ break;
+ default:
+ if( $title->isSpecialPage() ) {
+ list( $name, $par ) = SpecialPageFactory::resolveAlias( $title->getDBkey() );
+
+ # Use the language name for log titles, rather than Log/X
+ if( $name == 'Log' ) {
+ $titleLink = '(' . Linker::link( $title, LogPage::logName( $par ) ) . ')';
+ } else {
+ $titleLink = Linker::link( $title );
+ }
+ } else {
+ $titleLink = Linker::link( $title );
+ }
+ }
+
+ return $titleLink;
+ }
+
+ /**
+ * Add a log entry
+ *
+ * @param $action String: one of '', 'block', 'protect', 'rights', 'delete', 'upload', 'move', 'move_redir'
+ * @param $target Title object
+ * @param $comment String: description associated
+ * @param $params Array: parameters passed later to wfMsg.* functions
+ * @param $doer User object: the user doing the action
+ *
+ * @return bool|int|null
+ */
+ public function addEntry( $action, $target, $comment, $params = array(), $doer = null ) {
+ global $wgContLang;
+
+ if ( !is_array( $params ) ) {
+ $params = array( $params );
+ }
+
+ if ( $comment === null ) {
+ $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;
+
+ $this->actionText = LogPage::actionText( $this->type, $action, $target, null, $params );
+
+ return $this->saveContent();
+ }
+
+ /**
+ * Add relations to log_search table
+ *
+ * @param $field String
+ * @param $values Array
+ * @param $logid Integer
+ * @return Boolean
+ */
+ public function addRelations( $field, $values, $logid ) {
+ if( !strlen( $field ) || empty( $values ) ) {
+ return false; // nothing
+ }
+
+ $data = array();
+
+ foreach( $values as $value ) {
+ $data[] = array(
+ 'ls_field' => $field,
+ 'ls_value' => $value,
+ 'ls_log_id' => $logid
+ );
+ }
+
+ $dbw = wfGetDB( DB_MASTER );
+ $dbw->insert( 'log_search', $data, __METHOD__, 'IGNORE' );
+
+ return true;
+ }
+
+ /**
+ * Create a blob from a parameter array
+ *
+ * @param $params Array
+ * @return String
+ */
+ public static function makeParamBlob( $params ) {
+ return implode( "\n", $params );
+ }
+
+ /**
+ * Extract a parameter array from a blob
+ *
+ * @param $blob String
+ * @return Array
+ */
+ public static function extractParams( $blob ) {
+ if ( $blob === '' ) {
+ return array();
+ } else {
+ return explode( "\n", $blob );
+ }
+ }
+
+ /**
+ * Convert a comma-delimited list of block log flags
+ * into a more readable (and translated) form
+ *
+ * @param $flags Flags to format
+ * @param $lang Language object to use
+ * @return String
+ */
+ public static function formatBlockFlags( $flags, $lang ) {
+ $flags = explode( ',', trim( $flags ) );
+
+ if( count( $flags ) > 0 ) {
+ for( $i = 0; $i < count( $flags ); $i++ ) {
+ $flags[$i] = self::formatBlockFlag( $flags[$i], $lang );
+ }
+ return '(' . $lang->commaList( $flags ) . ')';
+ } else {
+ return '';
+ }
+ }
+
+ /**
+ * Translate a block log flag if possible
+ *
+ * @param $flag int Flag to translate
+ * @param $lang Language object to use
+ * @return String
+ */
+ public static function formatBlockFlag( $flag, $lang ) {
+ static $messages = array();
+
+ if( !isset( $messages[$flag] ) ) {
+ $messages[$flag] = htmlspecialchars( $flag ); // Fallback
+
+ // For grepping. The following core messages can be used here:
+ // * block-log-flags-angry-autoblock
+ // * block-log-flags-anononly
+ // * block-log-flags-hiddenname
+ // * block-log-flags-noautoblock
+ // * block-log-flags-nocreate
+ // * block-log-flags-noemail
+ // * block-log-flags-nousertalk
+ $msg = wfMessage( 'block-log-flags-' . $flag )->inLanguage( $lang );
+
+ if ( $msg->exists() ) {
+ $messages[$flag] = $msg->escaped();
+ }
+ }
+
+ return $messages[$flag];
+ }
+
+
+ /**
+ * Name of the log.
+ * @return Message
+ * @since 1.19
+ */
+ public function getName() {
+ global $wgLogNames;
+
+ // BC
+ if ( isset( $wgLogNames[$this->type] ) ) {
+ $key = $wgLogNames[$this->type];
+ } else {
+ $key = 'log-name-' . $this->type;
+ }
+
+ return wfMessage( $key );
+ }
+
+ /**
+ * Description of this log type.
+ * @return Message
+ * @since 1.19
+ */
+ public function getDescription() {
+ global $wgLogHeaders;
+ // BC
+ if ( isset( $wgLogHeaders[$this->type] ) ) {
+ $key = $wgLogHeaders[$this->type];
+ } else {
+ $key = 'log-description-' . $this->type;
+ }
+ return wfMessage( $key );
+ }
+
+ /**
+ * Returns the right needed to read this log type.
+ * @return string
+ * @since 1.19
+ */
+ public function getRestriction() {
+ global $wgLogRestrictions;
+ if ( isset( $wgLogRestrictions[$this->type] ) ) {
+ $restriction = $wgLogRestrictions[$this->type];
+ } else {
+ // '' always returns true with $user->isAllowed()
+ $restriction = '';
+ }
+ return $restriction;
+ }
+
+ /**
+ * Tells if this log is not viewable by all.
+ * @return bool
+ * @since 1.19
+ */
+ public function isRestricted() {
+ $restriction = $this->getRestriction();
+ return $restriction !== '' && $restriction !== '*';
+ }
+
+}