Inherited by EnhancedChangesList, and OldChangesList.

Collaboration diagram for ChangesList:

[legend]

Public Member Functions
	__construct ( $context, array $filterGroups=[])

	beginRecentChangesList ()
	Returns text for the start of the tabular part of RC.

	endRecentChangesList ()
	Returns text for the end of RC.

	formatCharacterDifference (RecentChange $old, RecentChange $new=null)
	Format the character difference of one or several changes.

	getArticleLink (&$rc, $unpatrolled, $watched)
	Get the HTML link to the changed page, possibly with a prefix from hook handlers, and a suffix for temporarily watched items.

	getRollback (RecentChange $rc)

	getTags (RecentChange $rc, array &$classes)

	getTimestamp ( $rc)
	Get the timestamp from $rc formatted with current user's settings and a separator.

	getWatchlistExpiry (RecentChange $recentChange)
	Get HTML to display the clock icon for watched items that have a watchlist expiry time.

	initChangesListRows ( $rows)

	insertComment ( $rc)
	Insert a formatted comment.

	insertDateHeader (&$s, $rc_timestamp)

	insertDiffHist (&$s, &$rc, $unpatrolled=null)

	insertExtra (&$s, &$rc, &$classes)

	insertLog (&$s, $title, $logtype, $useParentheses=true)

	insertLogEntry ( $rc)
	Insert a formatted action.

	insertRollback (&$s, &$rc)
	Insert a rollback link.

	insertTags (&$s, &$rc, &$classes)

	insertTimestamp (&$s, $rc)
	Insert time timestamp string from $rc into $s.

	insertUserRelatedLinks (&$s, &$rc)
	Insert links to user page, user talk page and eventually a blocking link.

	isWatchlist ()

	recentChangesFlags ( $flags, $nothing="\u{00A0}")
	Returns the appropriate flags for new page, minor change and patrolling.

	recentChangesLine (&$rc, $watched=false, $linenumber=null)
	Format a line.

	setChangeLinePrefixer (callable $prefixer)
	Sets the callable that generates a change line prefix added to the beginning of each line.

	setWatchlistDivs ( $value=true)
	Sets the list to use a "<li class='watchlist-(namespace)-(page)'>" tag.

Public Member Functions inherited from ContextSource
	canUseWikiPage ()
	Check whether a WikiPage object can be get with getWikiPage().

	exportSession ()
	Export the resolved user IP, HTTP headers, user ID, and session ID.

	getActionName ()
	Get the action name for the current web request.

	getAuthority ()

	getConfig ()

	getContext ()
	Get the base IContextSource object.

	getCsrfTokenSet ()
	Get a repository to obtain and match CSRF tokens.

	getLanguage ()

	getOutput ()

	getRequest ()

	getSkin ()

	getTiming ()

	getTitle ()

	getUser ()

	getWikiPage ()
	Get the WikiPage object.

	msg ( $key,... $params)
	Get a Message object with context set Parameters are the same as wfMessage()

	setContext (IContextSource $context)

Static Public Member Functions
static	flag ( $flag, IContextSource $context=null)
	Make an "<abbr>" element for a given change flag.

static	isDeleted ( $rc, $field)
	Determine if said field of a revision is hidden.

static	isUnpatrolled ( $rc, User $user)

static	newFromContext (IContextSource $context, array $groups=[])
	Fetch an appropriate changes list class for the specified context Some users might want to use an enhanced list format, for instance.

static	revDateLink (RevisionRecord $rev, Authority $performer, Language $lang, $title=null)
	Render the date and time of a revision in the current user language based on whether the user is able to view this information or not.

static	showCharacterDifference ( $old, $new, IContextSource $context=null)
	Show formatted char difference.

static	userCan ( $rc, $field, Authority $performer=null)
	Determine if the current user is allowed to view a particular field of this revision, if it's marked as deleted.

Public Attributes
const	CSS_CLASS_PREFIX = 'mw-changeslist-'

Protected Member Functions
	getDataAttributes (RecentChange $rc)
	Get recommended data attributes for a change line.

	getHighlightsContainerDiv ()
	Get the container for highlights that are used in the new StructuredFilters system.

	getHTMLClasses ( $rc, $watched)
	Get an array of default HTML class attributes for the change.

	getHTMLClassesForFilters ( $rc)
	Get an array of CSS classes attributed to filters for this row.

	isCategorizationWithoutRevision ( $rcObj)
	Determines whether a revision is linked to this change; this may not be the case when the categorization wasn't done by an edit but a conditional parser function.

	maybeWatchedLink ( $link, $watched=false)

	numberofWatchingusers ( $count)
	Returns the string which indicates the number of watching users.

	showAsUnpatrolled (RecentChange $rc)

Protected Attributes
callable	$changeLinePrefixer

RowCommentFormatter	$commentFormatter

ChangesListFilterGroup[]	$filterGroups

string[]	$formattedComments
	Comments indexed by rc_id.

	$lastdate

LinkRenderer	$linkRenderer

	$message

	$rc_cache

	$rcCacheIndex

	$rclistOpen

	$rcMoveIndex

MapCacheLRU	$tagsCache

MapCacheLRU	$userLinkCache

	$watchlist = false

MapCacheLRU	$watchMsgCache

Detailed Description

Definition at line 44 of file ChangesList.php.

Constructor & Destructor Documentation

◆ __construct()

ChangesList::__construct	(		$context,
		array	$filterGroups = [] )

Parameters

IContextSource	$context
ChangesListFilterGroup[]	$filterGroups	Array of ChangesListFilterGroup objects (currently optional)

Reimplemented in EnhancedChangesList.

Definition at line 97 of file ChangesList.php.

References ContextSource\setContext().

Member Function Documentation

◆ beginRecentChangesList()

ChangesList::beginRecentChangesList ( )

Returns text for the start of the tabular part of RC.

Returns: string

Reimplemented in EnhancedChangesList.

Definition at line 334 of file ChangesList.php.

References ContextSource\getOutput().

◆ endRecentChangesList()

ChangesList::endRecentChangesList ( )

Returns text for the end of RC.

Returns: string

Reimplemented in EnhancedChangesList.

Definition at line 449 of file ChangesList.php.

◆ flag()

static ChangesList::flag	(		$flag,
		IContextSource	$context = null )

static

Make an "<abbr>" element for a given change flag.

The flag indicating a new page, minor edit, bot edit, or unpatrolled edit. In English it typically contains "N", "m", "b", or "!".

Styling for these flags is provided through mediawiki.interface.helpers.styles.

Parameters

string	$flag	One key of $wgRecentChangesFlags
IContextSource \| null	$context

Returns: string HTML

Definition at line 300 of file ChangesList.php.

References ContextSource\setContext(), and wfMessage().

◆ formatCharacterDifference()

ChangesList::formatCharacterDifference	(	RecentChange	$old,
		RecentChange	$new = null )

Format the character difference of one or several changes.

Parameters

RecentChange	$old
RecentChange \| null	$new	Last change to use, if not provided, $old will be used

Returns: string HTML fragment

Definition at line 429 of file ChangesList.php.

References getContext().

Referenced by EnhancedChangesList\getLineData(), EnhancedChangesList\recentChangesBlockGroup(), and EnhancedChangesList\recentChangesBlockLine().

◆ getArticleLink()

ChangesList::getArticleLink	(	&	$rc,
			$unpatrolled,
			$watched )

Get the HTML link to the changed page, possibly with a prefix from hook handlers, and a suffix for temporarily watched items.

Parameters

RecentChange	&$rc
bool	$unpatrolled
bool	$watched

Returns: string HTML

Since: 1.26

Definition at line 593 of file ChangesList.php.

References ContextSource\getLanguage(), and getWatchlistExpiry().

Referenced by EnhancedChangesList\recentChangesBlockGroup(), and EnhancedChangesList\recentChangesBlockLine().

◆ getDataAttributes()

ChangesList::getDataAttributes ( RecentChange $rc )

protected

Get recommended data attributes for a change line.

Parameters

RecentChange $rc

Returns: string[] attribute name => value

Definition at line 1018 of file ChangesList.php.

References RecentChange\getAttribute().

Referenced by EnhancedChangesList\getLineData(), EnhancedChangesList\recentChangesBlockLine(), and OldChangesList\recentChangesLine().

◆ getHighlightsContainerDiv()

ChangesList::getHighlightsContainerDiv ( )

protected

Get the container for highlights that are used in the new StructuredFilters system.

Returns: string HTML structure of the highlight container div

Definition at line 159 of file ChangesList.php.

Referenced by EnhancedChangesList\recentChangesBlockLine(), and OldChangesList\recentChangesLine().

◆ getHTMLClasses()

ChangesList::getHTMLClasses	(		$rc,
			$watched )

protected

Get an array of default HTML class attributes for the change.

Parameters

RecentChange \| RCCacheEntry	$rc
string \| bool	$watched	Optionally timestamp for adding watched class

Returns: string[] List of CSS class names

Definition at line 237 of file ChangesList.php.

References getHTMLClassesForFilters().

Referenced by EnhancedChangesList\getLineData(), EnhancedChangesList\recentChangesBlockLine(), and OldChangesList\recentChangesLine().

◆ getHTMLClassesForFilters()

ChangesList::getHTMLClassesForFilters ( $rc )

protected

Get an array of CSS classes attributed to filters for this row.

Used for highlighting in the front-end.

Parameters

RecentChange $rc

Returns: string[] Array of CSS classes

Definition at line 268 of file ChangesList.php.

Referenced by getHTMLClasses(), and EnhancedChangesList\recentChangesBlockGroup().

◆ getRollback()

ChangesList::getRollback ( RecentChange $rc )

Parameters

RecentChange $rc

Returns: string

Since: 1.26

Definition at line 917 of file ChangesList.php.

Referenced by EnhancedChangesList\getLineData(), and EnhancedChangesList\recentChangesBlockLine().

◆ getTags()

ChangesList::getTags	(	RecentChange	$rc,
		array &	$classes )

Parameters

RecentChange	$rc
string[]	&$classes

Returns: string

Since: 1.26

Definition at line 960 of file ChangesList.php.

Referenced by EnhancedChangesList\getLineData(), EnhancedChangesList\recentChangesBlockGroup(), and EnhancedChangesList\recentChangesBlockLine().

◆ getTimestamp()

ChangesList::getTimestamp ( $rc )

Get the timestamp from $rc formatted with current user's settings and a separator.

Parameters

RecentChange $rc

Deprecated: use revDateLink instead.

Returns: string HTML fragment

Definition at line 670 of file ChangesList.php.

◆ getWatchlistExpiry()

ChangesList::getWatchlistExpiry ( RecentChange $recentChange )

Get HTML to display the clock icon for watched items that have a watchlist expiry time.

Since: 1.35

Parameters

RecentChange $recentChange

Returns: string The HTML to display an indication of the expiry time.

Definition at line 637 of file ChangesList.php.

◆ initChangesListRows()

ChangesList::initChangesListRows ( $rows )

Parameters

IResultWrapper | stdClass[] $rows

Definition at line 351 of file ChangesList.php.

◆ insertComment()

ChangesList::insertComment ( $rc )

Insert a formatted comment.

Parameters

RecentChange $rc

Returns: string

Definition at line 765 of file ChangesList.php.

Referenced by EnhancedChangesList\getLineData(), and EnhancedChangesList\recentChangesBlockLine().

◆ insertDateHeader()

ChangesList::insertDateHeader	(	&	$s,
			$rc_timestamp )

Parameters

string	&$s	HTML to update
mixed	$rc_timestamp

Definition at line 499 of file ChangesList.php.

References ContextSource\getLanguage(), and getUser().

Referenced by OldChangesList\recentChangesLine().

◆ insertDiffHist()

ChangesList::insertDiffHist	(	&	$s,
		&	$rc,
			$unpatrolled = null )

Parameters

string	&$s	HTML to update
RecentChange	&$rc
bool \| null	$unpatrolled	Unused variable, since 1.27.

Definition at line 538 of file ChangesList.php.

References getAuthority(), RC_CATEGORIZE, RC_LOG, and RC_NEW.

◆ insertExtra()

ChangesList::insertExtra	(	&	$s,
		&	$rc,
		&	$classes )

Definition at line 966 of file ChangesList.php.

◆ insertLog()

ChangesList::insertLog	(	&	$s,
			$title,
			$logtype,
			$useParentheses = true )

Parameters

string	&$s	HTML to update
Title	$title
string	$logtype
bool	$useParentheses	(optional) Wrap log entry in parentheses where needed

Definition at line 518 of file ChangesList.php.

References getContext(), and ContextSource\msg().

◆ insertLogEntry()

ChangesList::insertLogEntry ( $rc )

Insert a formatted action.

Parameters

RecentChange $rc

Returns: string

Definition at line 745 of file ChangesList.php.

References getContext().

Referenced by EnhancedChangesList\getLineData(), and EnhancedChangesList\recentChangesBlockLine().

◆ insertRollback()

ChangesList::insertRollback	(	&	$s,
		&	$rc )

Insert a rollback link.

Parameters

string	&$s
RecentChange	&$rc

Definition at line 863 of file ChangesList.php.

◆ insertTags()

ChangesList::insertTags	(	&	$s,
		&	$rc,
		&	$classes )

Parameters

string	&$s
RecentChange	&$rc
string[]	&$classes

Definition at line 928 of file ChangesList.php.

References ChangeTags\formatSummaryRow().

◆ insertTimestamp()

ChangesList::insertTimestamp	(	&	$s,
			$rc )

Insert time timestamp string from $rc into $s.

Parameters

string	&$s	HTML to update
RecentChange	$rc

Definition at line 697 of file ChangesList.php.

References getTimestamp().

◆ insertUserRelatedLinks()

ChangesList::insertUserRelatedLinks	(	&	$s,
		&	$rc )

Insert links to user page, user talk page and eventually a blocking link.

Parameters

string	&$s	HTML to update
RecentChange	&$rc

Definition at line 707 of file ChangesList.php.

◆ isCategorizationWithoutRevision()

ChangesList::isCategorizationWithoutRevision ( $rcObj )

protected

Determines whether a revision is linked to this change; this may not be the case when the categorization wasn't done by an edit but a conditional parser function.

Since: 1.27

Parameters

RecentChange | RCCacheEntry $rcObj

Returns: bool

Definition at line 1008 of file ChangesList.php.

References RC_CATEGORIZE.

Referenced by EnhancedChangesList\getLineData(), and EnhancedChangesList\recentChangesBlockLine().

◆ isDeleted()

static ChangesList::isDeleted	(		$rc,
			$field )

static

Determine if said field of a revision is hidden.

Parameters

RCCacheEntry \| RecentChange	$rc
int	$field	One of DELETED_* bitfield constants

Returns: bool

Definition at line 821 of file ChangesList.php.

◆ isUnpatrolled()

static ChangesList::isUnpatrolled	(		$rc,
		User	$user )

static

Parameters

stdClass \| RecentChange	$rc	Database row from recentchanges or a RecentChange object
User	$user

Returns: bool

Definition at line 979 of file ChangesList.php.

References RC_NEW, MediaWiki\User\User\useFilePatrol(), MediaWiki\User\User\useNPPatrol(), and MediaWiki\User\User\useRCPatrol().

◆ isWatchlist()

ChangesList::isWatchlist ( )

Returns: bool True when setWatchlistDivs has been called

Since: 1.23

Definition at line 190 of file ChangesList.php.

◆ maybeWatchedLink()

ChangesList::maybeWatchedLink	(		$link,
			$watched = false )

protected

Parameters

string	$link
bool	$watched

Returns: string

Definition at line 849 of file ChangesList.php.

Referenced by EnhancedChangesList\recentChangesBlockGroup().

◆ newFromContext()

static ChangesList::newFromContext	(	IContextSource	$context,
		array	$groups = [] )

static

Fetch an appropriate changes list class for the specified context Some users might want to use an enhanced list format, for instance.

Parameters

IContextSource	$context
array	$groups	Array of ChangesListFilterGroup objects (currently optional)

Returns: ChangesList

Definition at line 118 of file ChangesList.php.

References IContextSource\getRequest(), IContextSource\getSkin(), and IContextSource\getUser().

◆ numberofWatchingusers()

ChangesList::numberofWatchingusers ( $count )

protected

Returns the string which indicates the number of watching users.

Parameters

int $count Number of user watching a page

Returns: string

Definition at line 796 of file ChangesList.php.

References getUser().

Referenced by EnhancedChangesList\recentChangesBlockGroup(), and EnhancedChangesList\recentChangesBlockLine().

◆ recentChangesFlags()

ChangesList::recentChangesFlags	(		$flags,
			$nothing = "\u{00A0}" )

Returns the appropriate flags for new page, minor change and patrolling.

Parameters

array	$flags	Associative array of 'flag' => Bool
string	$nothing	To use for empty space

Returns: string

Definition at line 216 of file ChangesList.php.

References ContextSource\getConfig(), and getContext().

Referenced by EnhancedChangesList\getLineData(), EnhancedChangesList\recentChangesBlockGroup(), and EnhancedChangesList\recentChangesBlockLine().

◆ recentChangesLine()

ChangesList::recentChangesLine	(	&	$rc,
			$watched = false,
			$linenumber = null )

Format a line.

Since: 1.27

Parameters

RecentChange	&$rc	Passed by reference
bool	$watched	(default false)
int \| null	$linenumber	(default null)

Returns: string|bool

Reimplemented in EnhancedChangesList, and OldChangesList.

Definition at line 149 of file ChangesList.php.

◆ revDateLink()

static ChangesList::revDateLink	(	RevisionRecord	$rev,
		Authority	$performer,
		Language	$lang,
			$title = null )

static

Render the date and time of a revision in the current user language based on whether the user is able to view this information or not.

Parameters

RevisionRecord	$rev
Authority	$performer
Language	$lang
Title \| null	$title	(optional) where Title does not match the Title associated with the RevisionRecord

Access: internal: For usage by Pager classes only (e.g. HistoryPager and ContribsPager).

Returns: string HTML

Definition at line 467 of file ChangesList.php.

References MediaWiki\Revision\RevisionRecord\getId(), MediaWiki\Revision\RevisionRecord\getPageAsLinkTarget(), MediaWiki\Revision\RevisionRecord\getTimestamp(), MediaWiki\Permissions\Authority\getUser(), MediaWiki\Revision\RevisionRecord\isDeleted(), MediaWiki\Revision\RevisionRecord\userCan(), Language\userTime(), and Language\userTimeAndDate().

◆ setChangeLinePrefixer()

ChangesList::setChangeLinePrefixer ( callable $prefixer )

Sets the callable that generates a change line prefix added to the beginning of each line.

Parameters

callable $prefixer Callable to run that generates the change line prefix. Takes three parameters: a RecentChange object, a ChangesList object, and whether the current entry is a grouped entry.

Definition at line 1049 of file ChangesList.php.

◆ setWatchlistDivs()

ChangesList::setWatchlistDivs ( $value = true )

Sets the list to use a "<li class='watchlist-(namespace)-(page)'>" tag.

Parameters

bool $value

Definition at line 182 of file ChangesList.php.

◆ showAsUnpatrolled()

ChangesList::showAsUnpatrolled ( RecentChange $rc )

protected

Definition at line 970 of file ChangesList.php.

References getUser().

◆ showCharacterDifference()

static ChangesList::showCharacterDifference	(		$old,
			$new,
		IContextSource	$context = null )

static

Show formatted char difference.

Needs the css module 'mediawiki.special.changeslist' to style output

Parameters

int	$old	Number of bytes
int	$new	Number of bytes
IContextSource \| null	$context

Returns: string

Definition at line 375 of file ChangesList.php.

◆ userCan()

static ChangesList::userCan	(		$rc,
			$field,
		Authority	$performer = null )

static

Determine if the current user is allowed to view a particular field of this revision, if it's marked as deleted.

Parameters

RCCacheEntry \| RecentChange	$rc
int	$field
Authority \| null	$performer	to check permissions against. If null, the global RequestContext's User is assumed instead.

Returns: bool

Definition at line 834 of file ChangesList.php.

References RC_LOG.

Referenced by EnhancedChangesList\getLineData().

Member Data Documentation

◆ $changeLinePrefixer

callable ChangesList::$changeLinePrefixer

protected

Definition at line 58 of file ChangesList.php.

◆ $commentFormatter

RowCommentFormatter ChangesList::$commentFormatter

protected

Definition at line 71 of file ChangesList.php.

◆ $filterGroups

ChangesListFilterGroup [] ChangesList::$filterGroups

protected

Definition at line 81 of file ChangesList.php.

Referenced by EnhancedChangesList\__construct().

◆ $formattedComments

string [] ChangesList::$formattedComments

protected

Comments indexed by rc_id.

Definition at line 76 of file ChangesList.php.

◆ $lastdate

ChangesList::$lastdate

protected

Definition at line 50 of file ChangesList.php.

◆ $linkRenderer

LinkRenderer ChangesList::$linkRenderer

protected

Definition at line 66 of file ChangesList.php.

◆ $message

ChangesList::$message

protected

Definition at line 51 of file ChangesList.php.

◆ $rc_cache

ChangesList::$rc_cache

protected

Definition at line 52 of file ChangesList.php.

◆ $rcCacheIndex

ChangesList::$rcCacheIndex

protected

Definition at line 53 of file ChangesList.php.

◆ $rclistOpen

ChangesList::$rclistOpen

protected

Definition at line 54 of file ChangesList.php.

◆ $rcMoveIndex

ChangesList::$rcMoveIndex

protected

Definition at line 55 of file ChangesList.php.

◆ $tagsCache

MapCacheLRU ChangesList::$tagsCache

protected

Definition at line 86 of file ChangesList.php.

◆ $userLinkCache

MapCacheLRU ChangesList::$userLinkCache

protected

Definition at line 91 of file ChangesList.php.

◆ $watchlist

ChangesList::$watchlist = false

protected

Definition at line 49 of file ChangesList.php.

◆ $watchMsgCache

MapCacheLRU ChangesList::$watchMsgCache

protected

Definition at line 61 of file ChangesList.php.

◆ CSS_CLASS_PREFIX

const ChangesList::CSS_CLASS_PREFIX = 'mw-changeslist-'

Definition at line 47 of file ChangesList.php.

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

includes/changes/ChangesList.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ beginRecentChangesList()

◆ endRecentChangesList()

◆ flag()

◆ formatCharacterDifference()

◆ getArticleLink()

◆ getDataAttributes()

◆ getHighlightsContainerDiv()

◆ getHTMLClasses()

◆ getHTMLClassesForFilters()

◆ getRollback()

◆ getTags()

◆ getTimestamp()

◆ getWatchlistExpiry()

◆ initChangesListRows()

◆ insertComment()

◆ insertDateHeader()

◆ insertDiffHist()

◆ insertExtra()

◆ insertLog()

◆ insertLogEntry()

◆ insertRollback()

◆ insertTags()

◆ insertTimestamp()

◆ insertUserRelatedLinks()

◆ isCategorizationWithoutRevision()

◆ isDeleted()

◆ isUnpatrolled()

◆ isWatchlist()

◆ maybeWatchedLink()

◆ newFromContext()

◆ numberofWatchingusers()

◆ recentChangesFlags()

◆ recentChangesLine()

◆ revDateLink()

◆ setChangeLinePrefixer()

◆ setWatchlistDivs()

◆ showAsUnpatrolled()

◆ showCharacterDifference()

◆ userCan()

Member Data Documentation

◆ $changeLinePrefixer

◆ $commentFormatter

◆ $filterGroups

◆ $formattedComments

◆ $lastdate

◆ $linkRenderer

◆ $message

◆ $rc_cache

◆ $rcCacheIndex

◆ $rclistOpen

◆ $rcMoveIndex

◆ $tagsCache

◆ $userLinkCache

◆ $watchlist

◆ $watchMsgCache

◆ CSS_CLASS_PREFIX