Implements the default log formatting. More...

Inheritance diagram for LogFormatter:

Public Member Functions
	getActionLinks ()
	Returns extra links that comes after the action text, like "revert", etc.
	getActionText ()
	Gets the log action, including username.
	getComment ()
	Gets the luser provided comment.
	getIRCActionComment ()
	Even uglier hack to maintain backwards compatibilty with IRC bots (bug 34508).
	getIRCActionText ()
	Even uglier hack to maintain backwards compatibilty with IRC bots (bug 34508).
	getPerformerElement ()
	Provides the name of the user who performed the log action.
	getPlainActionText ()
	Ugly hack to produce plaintext version of the message.
	getPreloadTitles ()
	setAudience ($audience)
	Set the visibility restrictions for displaying content.
	setContext (IContextSource $context)
	Replace the default context.
	setShowUserToolLinks ($value)
	If set to true, will produce user tool links after the user name.
Static Public Member Functions
static	newFromEntry (LogEntry $entry)
	Constructs a new formatter suitable for given entry.
static	newFromRow ($row)
	Handy shortcut for constructing a formatter directly from database row.
Public Attributes
const	FOR_PUBLIC = 1
const	FOR_THIS_USER = 2
Protected Member Functions
	__construct (LogEntry $entry)
	canView ($field)
	Check if a log item can be displayed.
	extractParameters ()
	Extracts the optional extra parameters for use in action messages.
	getActionMessage ()
	Returns a sentence describing the log action.
	getMessageKey ()
	Returns a key to be used for formatting the action sentence.
	getMessageParameters ()
	Formats parameters intented for action message from array of all parameters.
	getRestrictedElement ($message)
	Helper method for displaying restricted element.
	makePageLink (Title $title=null, $parameters=array())
	Helper to make a link to the page, taking the plaintext value in consideration.
	makeUserLink (User $user)
	msg ($key)
	Shortcut for wfMessage which honors local context.
	styleRestricedElement ($content)
	Helper method for styling restricted element.
Protected Attributes
	$audience = self::FOR_PUBLIC
	Integer constant for handling log_deleted.
	$entry
	$irctext = false
	$linkFlood = false
	Whether to output user tool links.
boolean	$plaintext = false
	Set to true if we are constructing a message text that is going to be included in page history or send to IRC feed.

Detailed Description

Implements the default log formatting.

Can be overridden by subclassing and setting $wgLogActionsHandlers['type/subtype'] = 'class'; or $wgLogActionsHandlers['type/*'] = 'class';

Since:: 1.19

Definition at line 33 of file LogFormatter.php.

Constructor & Destructor Documentation

LogFormatter::__construct ( LogEntry $ entry ) [protected]

Definition at line 96 of file LogFormatter.php.

References $entry, and RequestContext\getMain().

Member Function Documentation

LogFormatter::canView ( $ field ) [protected]

Check if a log item can be displayed.

Parameters:

$field integer LogPage::DELETED_* constant

Returns:: bool

Definition at line 126 of file LogFormatter.php.

LogFormatter::extractParameters ( ) [protected]

Extracts the optional extra parameters for use in action messages.

The array indexes start from number 3.

Returns:: array

Definition at line 369 of file LogFormatter.php.

LogFormatter::getActionLinks ( )

Returns extra links that comes after the action text, like "revert", etc.

Returns:: string

Reimplemented in DeleteLogFormatter, MoveLogFormatter, and LegacyLogFormatter.

Definition at line 360 of file LogFormatter.php.

LogFormatter::getActionMessage ( ) [protected]

Returns a sentence describing the log action.

Usually a Message object is returned, but old style log types and entries might return pre-escaped html string.

Returns:: Message|string pre-escaped html

Reimplemented in LegacyLogFormatter.

Definition at line 335 of file LogFormatter.php.

LogFormatter::getActionText ( )

Gets the log action, including username.

Returns:: string HTML

Definition at line 312 of file LogFormatter.php.

LogFormatter::getComment ( )

Gets the luser provided comment.

Returns:: string HTML

Reimplemented in NewUsersLogFormatter, and LegacyLogFormatter.

Definition at line 469 of file LogFormatter.php.

LogFormatter::getIRCActionComment ( )

Even uglier hack to maintain backwards compatibilty with IRC bots (bug 34508).

See also:: getActionText()

Returns:: string text

Definition at line 165 of file LogFormatter.php.

LogFormatter::getIRCActionText ( )

Even uglier hack to maintain backwards compatibilty with IRC bots (bug 34508).

See also:: getActionText()

Returns:: string text

Definition at line 186 of file LogFormatter.php.

LogFormatter::getMessageKey ( ) [protected]

Returns a key to be used for formatting the action sentence.

Default is logentry-TYPE-SUBTYPE for modern logs. Legacy log types will use custom keys, and subclasses can also alter the key depending on the entry itself.

Returns:: string message key

Reimplemented in PatrolLogFormatter, DeleteLogFormatter, and MoveLogFormatter.

Definition at line 348 of file LogFormatter.php.

LogFormatter::getMessageParameters ( ) [protected]

Formats parameters intented for action message from array of all parameters.

There are three hardcoded parameters (array is zero-indexed, this list not):

1: user name with premade link
2: usable for gender magic function
3: target page with premade link
Returns:
array

Reimplemented in NewUsersLogFormatter, PatrolLogFormatter, DeleteLogFormatter, and MoveLogFormatter.

Definition at line 410 of file LogFormatter.php.

LogFormatter::getPerformerElement ( )

Provides the name of the user who performed the log action.

Used as part of log action message or standalone, depending which parts of the log entry has been hidden.

Returns:: String

Definition at line 451 of file LogFormatter.php.

LogFormatter::getPlainActionText ( )

Ugly hack to produce plaintext version of the message.

Usually you also want to set extraneous request context to avoid formatting for any particular user.

See also:: getActionText()

Returns:: string text

Definition at line 152 of file LogFormatter.php.

LogFormatter::getPreloadTitles ( )

Returns:: Array of titles that should be preloaded with LinkBatch.

Reimplemented in NewUsersLogFormatter, and MoveLogFormatter.

Definition at line 545 of file LogFormatter.php.

LogFormatter::getRestrictedElement ( $ message ) [protected]

Helper method for displaying restricted element.

Parameters:

$message string

Returns:: string HTML or wikitext

Definition at line 489 of file LogFormatter.php.

LogFormatter::makePageLink	(	Title $	title = `null`,
		$	parameters = `array()`
	)		`[protected]`

Helper to make a link to the page, taking the plaintext value in consideration.

Parameters:

$title	Title the page
$parameters	array query parameters

Returns:: String

Definition at line 433 of file LogFormatter.php.

LogFormatter::makeUserLink ( User $ user ) [protected]

Definition at line 522 of file LogFormatter.php.

References User\getEditCount(), User\getId(), User\getName(), Linker\userLink(), and Linker\userToolLinksRedContribs().

LogFormatter::msg ( $ key ) [protected]

Shortcut for wfMessage which honors local context.

Todo:: Would it be better to require replacing the global context instead?

Parameters:

$key string

Returns:: Message

Definition at line 518 of file LogFormatter.php.

static LogFormatter::newFromEntry ( LogEntry $ entry ) [static]

Constructs a new formatter suitable for given entry.

Parameters:

$entry LogEntry

Returns:: LogFormatter

Definition at line 45 of file LogFormatter.php.

References LogEntry\getFullType(), and LogEntry\getType().

Referenced by RecentChangeTest\assertIRCComment(), Title\moveToInternal(), newFromRow(), and ManualLogEntry\publish().

static LogFormatter::newFromRow ( $ row ) [static]

Handy shortcut for constructing a formatter directly from database row.

Parameters:

$row

See also:: DatabaseLogEntry::getSelectQueryData

Returns:: LogFormatter

Definition at line 71 of file LogFormatter.php.

References newFromEntry(), and DatabaseLogEntry\newFromRow().

Referenced by FeedUtils\formatDiff(), RevDel_LogItem\getHTML(), and LogPager\getStartBody().

LogFormatter::setAudience ( $ audience )

Set the visibility restrictions for displaying content.

If set to public, and an item is deleted, then it will be replaced with a placeholder even if the context user is allowed to view it.

Parameters:

$audience integer self::FOR_THIS_USER or self::FOR_PUBLIC

Definition at line 115 of file LogFormatter.php.

LogFormatter::setContext ( IContextSource $ context )

Replace the default context.

Parameters:

$context IContextSource

Definition at line 105 of file LogFormatter.php.

LogFormatter::setShowUserToolLinks ( $ value )

If set to true, will produce user tool links after the user name.

This should be replaced with generic CSS/JS solution.

Parameters:

$value boolean

Definition at line 141 of file LogFormatter.php.

LogFormatter::styleRestricedElement ( $ content ) [protected]

Helper method for styling restricted element.

Parameters:

$content string

Returns:: string HTML or wikitext

Definition at line 504 of file LogFormatter.php.

Member Data Documentation

LogFormatter::$audience = self::FOR_PUBLIC [protected]

Integer constant for handling log_deleted.

Definition at line 81 of file LogFormatter.php.

LogFormatter::$entry [protected]

Definition at line 78 of file LogFormatter.php.

Referenced by __construct().

LogFormatter::$irctext = false [protected]

Definition at line 94 of file LogFormatter.php.

LogFormatter::$linkFlood = false [protected]

Whether to output user tool links.

Definition at line 84 of file LogFormatter.php.

boolean LogFormatter::$plaintext = false [protected]

Set to true if we are constructing a message text that is going to be included in page history or send to IRC feed.

Links are replaced with plaintext or with [[pagename]] kind of syntax, that is parsed by page histories and IRC feeds.

Definition at line 92 of file LogFormatter.php.

const LogFormatter::FOR_PUBLIC = 1

Definition at line 35 of file LogFormatter.php.

const LogFormatter::FOR_THIS_USER = 2

Definition at line 36 of file LogFormatter.php.

Referenced by RevDel_LogItem\getHTML().

The documentation for this class was generated from the following file:

includes/logging/LogFormatter.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation