Inheritance diagram for ChangesList:

[legend]

Collaboration diagram for ChangesList:

[legend]

Public Member Functions
	__construct ( $obj, array $filterGroups=[])
	Changeslist constructor. More...

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

	endRecentChangesList ()
	Returns text for the end of RC. More...

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

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

	getRollback (RecentChange $rc)

	getTags (RecentChange $rc, array &$classes)

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

	initChangesListRows ( $rows)

	insertArticleLink (&$s, RecentChange $rc, $unpatrolled, $watched)

	insertComment ( $rc)
	Insert a formatted comment. More...

	insertDateHeader (&$s, $rc_timestamp)

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

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

	insertLog (&$s, $title, $logtype)

	insertLogEntry ( $rc)
	Insert a formatted action. More...

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

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

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

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

	isWatchlist ()

	recentChangesFlags ( $flags, $nothing=' ')
	Returns the appropriate flags for new page, minor change and patrolling. More...

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

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

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

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

	getConfig ()
	Get the Config object. More...

	getContext ()
	Get the base IContextSource object. More...

	getLanguage ()
	Get the Language object. More...

	getOutput ()
	Get the OutputPage object. More...

	getRequest ()
	Get the WebRequest object. More...

	getSkin ()
	Get the Skin object. More...

	getStats ()
	Get the Stats object. More...

	getTiming ()
	Get the Timing object. More...

	getTitle ()
	Get the Title object. More...

	getUser ()
	Get the User object. More...

	getWikiPage ()
	Get the WikiPage object. More...

	msg ()
	Get a Message object with context set Parameters are the same as wfMessage() More...

	setContext (IContextSource $context)
	Set the IContextSource object. More...

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

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

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. More...

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

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

Public Attributes
Skin	$skin

const	CSS_CLASS_PREFIX = 'mw-changeslist-'

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

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

	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. More...

	maybeWatchedLink ( $link, $watched=false)

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

	showAsUnpatrolled (RecentChange $rc)

Protected Attributes
array	$filterGroups

	$lastdate

LinkRenderer	$linkRenderer

	$message

	$rc_cache

	$rcCacheIndex

	$rclistOpen

	$rcMoveIndex

	$watchlist = false

BagOStuff	$watchMsgCache

Private Member Functions
	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. More...

Detailed Description

Definition at line 28 of file ChangesList.php.

Constructor & Destructor Documentation

◆ __construct()

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

Changeslist constructor.

Parameters

Skin \| IContextSource	$obj
array	$filterGroups	Array of ChangesListFilterGroup objects (currently optional)

Reimplemented in EnhancedChangesList.

Definition at line 63 of file ChangesList.php.

References $filterGroups, ContextSource\getSkin(), preCacheMessages(), ContextSource\setContext(), and skin().

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 254 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 355 of file ChangesList.php.

References $out.

◆ 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 "!".

Parameters

string	$flag	One key of $wgRecentChangesFlags
IContextSource	$context

Returns: string HTML

Definition at line 221 of file ChangesList.php.

References ContextSource\$context, $value, as, Html\element(), RequestContext\getMain(), global, ContextSource\setContext(), text, and wfMessage().

Referenced by SpecialUndelete\diffHeader(), DeletedContribsPager\formatRevisionRow(), SpecialUndelete\formatRevisionRow(), ContribsPager\formatRow(), HistoryPager\historyLine(), recentChangesFlags(), and DifferenceEngine\showDiffPage().

◆ formatCharacterDifference()

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

Format the character difference of one or several changes.

Parameters

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

Returns: string HTML fragment

Definition at line 335 of file ChangesList.php.

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

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

◆ getArticleLink()

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

Parameters

RecentChange	$rc
bool	$unpatrolled
bool	$watched

Returns: string HTML

Since: 1.26

Definition at line 460 of file ChangesList.php.

References $changesList, $params, $s, Revision\DELETED_TEXT, ContextSource\getLanguage(), isDeleted(), and Hooks\run().

Referenced by OldChangesList\formatChangeLine(), insertArticleLink(), EnhancedChangesList\recentChangesBlockGroup(), and EnhancedChangesList\recentChangesBlockLine().

◆ 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: array of classes

Definition at line 171 of file ChangesList.php.

References getHTMLClassesForFilters().

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

◆ getHTMLClassesForFilters()

ChangesList::getHTMLClassesForFilters ( $rc )

protected

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

Parameters

RecentChange $rc

Returns: array Array of CSS classes

Definition at line 199 of file ChangesList.php.

References as.

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

◆ getRollback()

ChangesList::getRollback ( RecentChange $rc )

Parameters

RecentChange $rc

Returns: string

Since: 1.26

Definition at line 652 of file ChangesList.php.

References $s, and insertRollback().

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

◆ getTags()

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

Parameters

RecentChange	$rc
array	$classes

Returns: string

Since: 1.26

Definition at line 683 of file ChangesList.php.

References $s, and insertTags().

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

◆ getTimestamp()

ChangesList::getTimestamp ( $rc )

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

Parameters

RecentChange $rc

Returns: string HTML fragment

Definition at line 497 of file ChangesList.php.

References ContextSource\getLanguage(), and message.

Referenced by insertTimestamp().

◆ initChangesListRows()

ChangesList::initChangesListRows ( $rows )

Parameters

ResultWrapper | array $rows

Definition at line 268 of file ChangesList.php.

References Hooks\run().

◆ insertArticleLink()

ChangesList::insertArticleLink	(	&	$s,
		RecentChange	$rc,
			$unpatrolled,
			$watched
	)

Parameters

string	$s	Article link will be appended to this string, in place.
RecentChange	$rc
bool	$unpatrolled
bool	$watched

Deprecated:: since 1.27, use getArticleLink instead.

Definition at line 449 of file ChangesList.php.

References $s, and getArticleLink().

◆ insertComment()

ChangesList::insertComment ( $rc )

Insert a formatted comment.

Parameters

RecentChange $rc

Returns: string

Definition at line 553 of file ChangesList.php.

References Linker\commentBlock(), Revision\DELETED_COMMENT, isDeleted(), and ContextSource\msg().

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

◆ insertDateHeader()

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

Parameters

string	$s	HTML to update
mixed	$rc_timestamp

Definition at line 366 of file ChangesList.php.

References $s, Xml\element(), ContextSource\getLanguage(), and ContextSource\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 397 of file ChangesList.php.

References $query, $s, Revision\DELETED_TEXT, ContextSource\getUser(), message, ContextSource\msg(), RC_CATEGORIZE, RC_LOG, and RC_NEW.

Referenced by OldChangesList\formatChangeLine().

◆ insertExtra()

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

Definition at line 689 of file ChangesList.php.

Referenced by OldChangesList\formatChangeLine().

◆ insertLog()

ChangesList::insertLog	(	&	$s,
			$title,
			$logtype
	)

Parameters

string	$s	HTML to update
Title	$title
string	$logtype

Definition at line 384 of file ChangesList.php.

References $page, $s, $title, ContextSource\getContext(), and ContextSource\msg().

Referenced by OldChangesList\formatChangeLine().

◆ insertLogEntry()

ChangesList::insertLogEntry ( $rc )

Insert a formatted action.

Parameters

RecentChange $rc

Returns: string

Definition at line 539 of file ChangesList.php.

References ContextSource\getContext(), ContextSource\getLanguage(), and LogFormatter\newFromRow().

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

◆ insertRollback()

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

Inserts a rollback link.

Parameters

string	$s
RecentChange	$rc

Definition at line 624 of file ChangesList.php.

References $page, $rev, $s, Linker\generateRollback(), ContextSource\getContext(), ContextSource\getUser(), and RC_EDIT.

Referenced by OldChangesList\formatChangeLine(), and getRollback().

◆ insertTags()

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

Parameters

string	$s
RecentChange	$rc
array	$classes

Definition at line 663 of file ChangesList.php.

References $s, ChangeTags\formatSummaryRow(), and list.

Referenced by OldChangesList\formatChangeLine(), and getTags().

◆ insertTimestamp()

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

Insert time timestamp string from $rc into $s.

Parameters

string	$s	HTML to update
RecentChange	$rc

Definition at line 512 of file ChangesList.php.

References $s, and getTimestamp().

Referenced by OldChangesList\formatChangeLine().

◆ 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 522 of file ChangesList.php.

References $s, Revision\DELETED_USER, ContextSource\getLanguage(), isDeleted(), ContextSource\msg(), Linker\userLink(), and Linker\userToolLinks().

Referenced by OldChangesList\formatChangeLine().

◆ 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 737 of file ChangesList.php.

References RC_CATEGORIZE.

Referenced by OldChangesList\formatChangeLine(), 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 586 of file ChangesList.php.

Referenced by getArticleLink(), EnhancedChangesList\getLineData(), RCCacheEntryFactory\getUserLink(), insertComment(), insertUserRelatedLinks(), RCCacheEntryFactory\newFromRecentChange(), and EnhancedChangesList\recentChangesBlockGroup().

◆ isUnpatrolled()

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

static

Parameters

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

Returns: bool

Definition at line 702 of file ChangesList.php.

References $user, and RC_NEW.

Referenced by ApiQueryWatchlist\extractOutputData(), ApiQueryRecentChanges\extractRowInfo(), RCCacheEntryFactory\newFromRecentChange(), and showAsUnpatrolled().

◆ isWatchlist()

ChangesList::isWatchlist ( )

Returns: bool True when setWatchlistDivs has been called

Since: 1.23

Definition at line 127 of file ChangesList.php.

References $watchlist.

◆ maybeWatchedLink()

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

protected

Parameters

string	$link
bool	$watched

Returns: string

Definition at line 611 of file ChangesList.php.

References $link.

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 85 of file ChangesList.php.

References ContextSource\$context, $user, IContextSource\getRequest(), IContextSource\getSkin(), IContextSource\getUser(), and Hooks\run().

Referenced by SpecialRecentChanges\outputChangesList(), and SpecialWatchlist\outputChangesList().

◆ 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 567 of file ChangesList.php.

References $cache, $watchMsgCache, ContextSource\msg(), and use.

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

◆ preCacheMessages()

ChangesList::preCacheMessages ( )

private

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.

Definition at line 135 of file ChangesList.php.

References as, message, and ContextSource\msg().

Referenced by __construct().

◆ recentChangesFlags()

ChangesList::recentChangesFlags	(	$flags,
		$nothing = `' '`
	)

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 152 of file ChangesList.php.

References $flags, as, flag(), ContextSource\getConfig(), and ContextSource\getContext().

Referenced by OldChangesList\formatChangeLine(), 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	$linenumber	(default null)

Returns: string|bool

Reimplemented in EnhancedChangesList, and OldChangesList.

Definition at line 111 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 119 of file ChangesList.php.

References $value.

◆ showAsUnpatrolled()

ChangesList::showAsUnpatrolled ( RecentChange $rc )

protected

Definition at line 693 of file ChangesList.php.

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

Referenced by OldChangesList\formatChangeLine().

◆ 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	$context

Returns: string

Definition at line 282 of file ChangesList.php.

References $code, ContextSource\$context, $lang, $tag, Html\element(), IContextSource\getConfig(), IContextSource\getLanguage(), RequestContext\getMain(), and IContextSource\msg().

Referenced by formatCharacterDifference(), ContribsPager\formatRow(), RecentChange\getCharacterDifference(), and HistoryPager\historyLine().

◆ userCan()

static ChangesList::userCan	(		$rc,
			$field,
		User	$user = `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
User	$user	User object to check, or null to use $wgUser

Returns: bool

Definition at line 598 of file ChangesList.php.

References $user, RC_LOG, LogEventsList\userCanBitfield(), and Revision\userCanBitfield().

Referenced by EnhancedChangesList\getLineData(), EnhancedChangesList\getLogText(), and RCCacheEntryFactory\showDiffLinks().

Member Data Documentation

◆ $filterGroups

array ChangesList::$filterGroups

protected

Definition at line 55 of file ChangesList.php.

Referenced by EnhancedChangesList\__construct(), and __construct().

◆ $lastdate

ChangesList::$lastdate

protected

Definition at line 37 of file ChangesList.php.

◆ $linkRenderer

LinkRenderer ChangesList::$linkRenderer

protected

Definition at line 50 of file ChangesList.php.

◆ $message

ChangesList::$message

protected

Definition at line 38 of file ChangesList.php.

◆ $rc_cache

ChangesList::$rc_cache

protected

Definition at line 39 of file ChangesList.php.

◆ $rcCacheIndex

ChangesList::$rcCacheIndex

protected

Definition at line 40 of file ChangesList.php.

◆ $rclistOpen

ChangesList::$rclistOpen

protected

Definition at line 41 of file ChangesList.php.

◆ $rcMoveIndex

ChangesList::$rcMoveIndex

protected

Definition at line 42 of file ChangesList.php.

◆ $skin

Skin ChangesList::$skin

Definition at line 34 of file ChangesList.php.

◆ $watchlist

ChangesList::$watchlist = false

protected

Definition at line 36 of file ChangesList.php.

Referenced by isWatchlist().

◆ $watchMsgCache

BagOStuff ChangesList::$watchMsgCache

protected

Definition at line 45 of file ChangesList.php.

Referenced by numberofWatchingusers().

◆ CSS_CLASS_PREFIX

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

Definition at line 29 of file ChangesList.php.

Referenced by ChangesListFilter\getCssClass().

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

Private Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ beginRecentChangesList()

◆ endRecentChangesList()

◆ flag()

◆ formatCharacterDifference()

◆ getArticleLink()

◆ getHTMLClasses()

◆ getHTMLClassesForFilters()

◆ getRollback()

◆ getTags()

◆ getTimestamp()

◆ initChangesListRows()

◆ insertArticleLink()

◆ insertComment()

◆ insertDateHeader()

◆ insertDiffHist()

◆ insertExtra()

◆ insertLog()

◆ insertLogEntry()

◆ insertRollback()

◆ insertTags()

◆ insertTimestamp()

◆ insertUserRelatedLinks()

◆ isCategorizationWithoutRevision()

◆ isDeleted()

◆ isUnpatrolled()

◆ isWatchlist()

◆ maybeWatchedLink()

◆ newFromContext()

◆ numberofWatchingusers()

◆ preCacheMessages()

◆ recentChangesFlags()

◆ recentChangesLine()

◆ setWatchlistDivs()

◆ showAsUnpatrolled()

◆ showCharacterDifference()

◆ userCan()

Member Data Documentation

◆ $filterGroups

◆ $lastdate

◆ $linkRenderer

◆ $message

◆ $rc_cache

◆ $rcCacheIndex

◆ $rclistOpen

◆ $rcMoveIndex

◆ $skin

◆ $watchlist

◆ $watchMsgCache

◆ CSS_CLASS_PREFIX