This class formats rights log entries. More...

Inheritance diagram for RightsLogFormatter:

Collaboration diagram for RightsLogFormatter:

[legend]

Public Member Functions
	formatParametersForApi ()
	Format parameters for API output.

Public Member Functions inherited from LogFormatter
	canViewLogType ()
	Check if a log item type can be displayed.

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

	getActionText ()
	Gets the log action, including username.

	getComment ()
	Gets the user provided comment Stable to override.

	getIRCActionComment ()
	Even uglier hack to maintain backwards compatibility with IRC bots (T36508).

	getIRCActionText ()
	Even uglier hack to maintain backwards compatibility with IRC bots (T36508).

	getLinkRenderer ()

	getMessageParametersForTesting ()

	getPerformerElement ()
	Provides the name of the user who performed the log action.

	getPlainActionText ()
	Ugly hack to produce plaintext version of the message.

	getPreloadTitles ()
	Stable to override.

	setAudience ( $audience)
	Set the visibility restrictions for displaying content.

	setContext (IContextSource $context)
	Replace the default context.

	setLinkRenderer (LinkRenderer $linkRenderer)

	setShowUserToolLinks ( $value)
	If set to true, will produce user tool links after the user name.

Protected Member Functions
	formatRightsList ( $groups, $serializedUGMs=[])

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

	getMessageParameters ()
	Formats parameters intented for action message from array of all parameters.

	getParametersForApi ()
	Get the array of parameters, converted from legacy format if necessary.

	makePageLink (Title $title=null, $parameters=[], $html=null)
	Helper to make a link to the page, taking the plaintext value in consideration.

Protected Member Functions inherited from LogFormatter
	__construct (LogEntry $entry)
	Stable to call.

	canView ( $field)
	Check if a log item can be displayed.

	extractParameters ()
	Extracts the optional extra parameters for use in action messages.

	formatParameterValue ( $type, $value)
	Formats parameters values dependent to their type.

	formatParameterValueForApi ( $name, $type, $value)
	Format a single parameter value for API output.

	getActionMessage ()
	Returns a sentence describing the log action.

	getRestrictedElement ( $message)
	Helper method for displaying restricted element.

	makeUserLink (User $user, $toolFlags=0)

	msg ( $key,... $params)
	Shortcut for wfMessage which honors local context.

	styleRestricedElement ( $content)
	Helper method for styling restricted element.

Private Member Functions
	makeGroupArray ( $group)

Additional Inherited Members
Static Public Member Functions inherited from LogFormatter
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 inherited from LogFormatter
IContextSource	$context
	Context for logging.

const	FOR_PUBLIC = 1

const	FOR_THIS_USER = 2

Protected Attributes inherited from LogFormatter
int	$audience = self::FOR_PUBLIC
	Constant for handling log_deleted.

LogEntryBase	$entry

string	$irctext = false

bool	$linkFlood = false
	Whether to output user tool links.

array	$parsedParameters

string	$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

This class formats rights log entries.

Since: 1.21

Definition at line 33 of file RightsLogFormatter.php.

Member Function Documentation

◆ formatParametersForApi()

RightsLogFormatter::formatParametersForApi ( )

Format parameters for API output.

The result array should generally map named keys to values. Index and type should be omitted, e.g. "4::foo" should be returned as "foo" in the output. Values should generally be unformatted.

Renames or removals of keys besides from the legacy numeric format to modern named style should be avoided. Any renames should be announced to the mediawiki-api-announce mailing list.

Since: 1.25 Stable to override

Returns: array

Reimplemented from LogFormatter.

Definition at line 213 of file RightsLogFormatter.php.

◆ formatRightsList()

RightsLogFormatter::formatRightsList	(	$groups,
		$serializedUGMs = `[]`
	)

protected

Definition at line 119 of file RightsLogFormatter.php.

References LogFormatter\msg().

Referenced by getMessageParameters().

◆ getMessageKey()

RightsLogFormatter::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. Stable to override

Returns: string Message key

Reimplemented from LogFormatter.

Definition at line 62 of file RightsLogFormatter.php.

References getMessageParameters().

◆ getMessageParameters()

RightsLogFormatter::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 Stable to override
Returns
array

Reimplemented from LogFormatter.

Definition at line 73 of file RightsLogFormatter.php.

References formatRightsList(), makeGroupArray(), LogFormatter\msg(), and Message\rawParam().

Referenced by getMessageKey().

◆ getParametersForApi()

RightsLogFormatter::getParametersForApi ( )

protected

Get the array of parameters, converted from legacy format if necessary.

Since: 1.25 Stable to override

Returns: array

Reimplemented from LogFormatter.

Definition at line 155 of file RightsLogFormatter.php.

References LogFormatter\$entry, LogEntry\getParameters(), and makeGroupArray().

◆ makeGroupArray()

RightsLogFormatter::makeGroupArray ( $group )

private

Definition at line 232 of file RightsLogFormatter.php.

Referenced by getMessageParameters(), and getParametersForApi().

◆ makePageLink()

RightsLogFormatter::makePageLink	(	Title	$title = `null`,
			$parameters = `[]`,
			$html = `null`
	)

protected

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

Stable to override

Parameters

Title \| null	$title	The page
array	$parameters	Query parameters
string \| null	$html	Linktext of the link as raw html

Returns: string

Reimplemented from LogFormatter.

Definition at line 34 of file RightsLogFormatter.php.

References $title, and $wgUserrightsInterwikiDelimiter.

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

includes/logging/RightsLogFormatter.php

Public Member Functions

Protected Member Functions

Private Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation

◆ formatParametersForApi()

◆ formatRightsList()

◆ getMessageKey()

◆ getMessageParameters()

◆ getParametersForApi()

◆ makeGroupArray()

◆ makePageLink()