DifferenceEngine is responsible for rendering the difference between two revisions as HTML. More...

Inheritance diagram for DifferenceEngine:

[legend]

Collaboration diagram for DifferenceEngine:

[legend]

Public Member Functions
	__construct ( $context=null, $old=0, $new=0, $rcid=0, $refreshCache=false, $unhide=false)
	#- More...

	addHeader ( $diff, $otitle, $ntitle, $multi='', $notice='')
	Add the header to a diff body. More...

	deletedIdMarker ( $id)
	Build a wikitext link toward a deleted revision, if viewable. More...

	deletedLink ( $id)
	Look up a special:Undelete link to the given deleted revision id, as a workaround for being unable to load deleted diffs in currently. More...

	generateContentDiffBody (Content $old, Content $new)
	Generate a diff, no caching. More...

	generateTextDiffBody ( $otext, $ntext)
	Generate a diff, no caching. More...

	getDiff ( $otitle, $ntitle, $notice='')
	Get complete diff table, including header. More...

	getDiffBody ()
	Get the diff table body, without header. More...

	getDiffBodyForRole ( $role)
	Get the diff table body for one slot, without header. More...

	getDiffLang ()
	Get the language of the difference engine, defaults to page content language. More...

	getExtraCacheKeys ()
	Implements DifferenceEngineSlotDiffRenderer::getExtraCacheKeys(). More...

	getMultiNotice ()
	If there are revisions between the ones being compared, return a note saying so. More...

	getNewid ()
	Get the ID of new revision (right pane) of the diff. More...

	getNewRevision ()
	Get the right side of the diff. More...

	getOldid ()
	Get the ID of old revision (left pane) of the diff. More...

	getOldRevision ()
	Get the left side of the diff. More...

	getPermissionErrors (User $user)
	Get the permission errors associated with the revisions for the current diff. More...

	getRevisionHeader ( $rev, $complete='')
	Get a header for a specified revision. More...

	getTitle ()
	Since 1.18 Stable to override Returns Title\|null More...

	hasDeletedRevision ()
	Checks whether one of the given Revisions was deleted. More...

	hasSuppressedRevision ()
	Checks whether one of the given Revisions was suppressed. More...

	isUserAllowedToSeeRevisions (Authority $performer)
	Checks whether the current user has permission for accessing the revisions of the diff. More...

	loadNewText ()
	Load the text of the new revision, not the old one. More...

	loadRevisionData ()
	Load revision metadata for the specified revisions. More...

	loadText ()
	Load the text of the revisions, as well as revision data. More...

	localiseLineNumbers ( $text)
	Replace line numbers with the text in the user's language. More...

	localiseLineNumbersCb ( $matches)

	mapDiffPrevNext ( $old, $new)
	Maps a revision pair definition as accepted by DifferenceEngine constructor to a pair of actual integers representing revision ids. More...

	markAsSlotDiffRenderer ()
	Mark this DifferenceEngine as a slot renderer (as opposed to a page renderer). More...

	markPatrolledLink ()
	Build a link to mark a change as patrolled. More...

	renderNewRevision ()
	Show the new revision of the page. More...

	setContent (Content $oldContent, Content $newContent)
	Use specified text instead of loading from the database. More...

	setReducedLineNumbers ( $value=true)
	Set reduced line numbers mode. More...

	setRevisions (?RevisionRecord $oldRevision, RevisionRecord $newRevision)
	Use specified text instead of loading from the database. More...

	setSlotDiffOptions ( $options)

	setTextLanguage (Language $lang)
	Set the language in which the diff text is written. More...

	shouldBeHiddenFromUser ( $user)
	Checks whether the diff should be hidden from the current user This is based on whether the user is allowed to see it and has specifically asked to see it. More...

	showDiff ( $otitle, $ntitle, $notice='')
	Get the diff text, send it to the OutputPage object Returns false if the diff could not be generated, otherwise returns true. More...

	showDiffPage ( $diffOnly=false)

	showDiffStyle ()
	Add style sheets for diff display. More...

	wasCacheHit ()

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

	getAuthority ()

	getConfig ()

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

	getLanguage ()

	getOutput ()

	getRequest ()

	getSkin ()

	getStats ()

	getTiming ()

	getUser ()
	Stable to override. More...

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

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

	setContext (IContextSource $context)

Static Public Member Functions
static	getEngine ()
	Process DiffEngine config and get a sane, usable engine. More...

static	intermediateEditsMsg ( $numEdits, $numUsers, $limit)
	Get a notice about how many intermediate edits and users there are. More...

Public Attributes
bool	$enableDebugComment = false
	Set this to true to add debug info to the HTML output. More...

Protected Member Functions
	debug ( $generator="internal")
	Generate a debug comment indicating diff generating time, server node, and generator backend. More...

	getDiffBodyCacheKey ()
	Returns the cache key for diff body text or content. More...

	getDiffBodyCacheKeyParams ()
	Get the cache key parameters. More...

	getMarkPatrolledLinkInfo ()
	Returns an array of meta data needed to build a "mark as patrolled" link and adds a JS module to the output. More...

	getParserOutput (WikiPage $page, RevisionRecord $revRecord)

	getSlotContents ()
	Get the old and new content objects for all slots. More...

	getSlotDiffRenderers ()

	getSlotHeader ( $headerText)
	Get a slot header for inclusion in a diff body (as a table row). More...

	textDiff ( $otext, $ntext)
	Generates diff, to be wrapped internally in a logging/instrumentation. More...

Protected Attributes
bool	$isContentOverridden = false
	Was the content overridden via setContent()? If the content was overridden, most internal state (e.g. More...

bool	$isSlotDiffRenderer = false
	Temporary hack for B/C while slot diff related methods of DifferenceEngine are being deprecated. More...

LinkRenderer	$linkRenderer

bool	$mCacheHit = false
	Was the diff fetched from cache? More...

Language	$mDiffLang

string	$mMarkPatrolledLink = null
	Link to action=markpatrolled. More...

int string false null	$mNewid
	Revision ID for the new revision. More...

Title null	$mNewPage
	Title of new revision or null if the new revision does not exist or does not belong to a page. More...

int false null	$mOldid
	Revision ID for the old revision. More...

Title null	$mOldPage
	Title of old revision or null if the old revision does not exist or does not belong to a page. More...

bool	$mReducedLineNumbers = false
	If true, line X is not displayed when X is 1, for example to increase readability and conserve space with many small diffs. More...

bool	$mRefreshCache = false
	Refresh the diff cache. More...

bool	$mRevisionsLoaded = false
	Have the revisions been loaded. More...

int	$mTextLoaded = 0
	How many text blobs have been loaded, 0, 1 or 2? More...

SlotDiffRenderer[]	$slotDiffRenderers = null
	DifferenceEngine classes for the slots, keyed by role name. More...

bool	$unhide = false
	Show rev_deleted content if allowed. More...

Private Member Functions
	addLocalisedTitleTooltips ( $text)
	Add title attributes for tooltips on moved paragraph indicators. More...

	addLocalisedTitleTooltipsCb (array $matches)

	getDebugString ()

	loadRevisionIds ()

	localiseDiff ( $text)
	Localise diff output. More...

	revisionDeleteLink (RevisionRecord $revRecord)

	showMissingRevision ()

	userCanEdit (RevisionRecord $revRecord)

Private Attributes
IContentHandlerFactory	$contentHandlerFactory

HookContainer	$hookContainer

HookRunner	$hookRunner

Content null	$mNewContent

RevisionRecord null	$mNewRevisionRecord
	New revision (right pane). More...

string[] null	$mNewTags
	Change tags of new revision or null if it does not exist / is not saved. More...

Content null	$mOldContent

RevisionRecord null false	$mOldRevisionRecord
	Old revision (left pane). More...

string[] null	$mOldTags
	Change tags of old revision or null if it does not exist / is not saved. More...

bool	$mRevisionsIdsLoaded = false
	Have the revisions IDs been loaded. More...

RevisionStore	$revisionStore

array	$slotDiffOptions = []
	A set of options that will be passed to the SlotDiffRenderer upon creation. More...

WikiPageFactory	$wikiPageFactory

const	DIFF_VERSION = '1.12'
	Constant to indicate diff cache compatibility. More...

Detailed Description

DifferenceEngine is responsible for rendering the difference between two revisions as HTML.

This includes interpreting URL parameters, retrieving revision data, checking access permissions, selecting and invoking the diff generator class for the individual slots, doing post-processing on the generated diff, adding the rest of the HTML (such as headers) and writing the whole thing to OutputPage.

DifferenceEngine can be subclassed by extensions, by customizing ContentHandler::createDifferenceEngine; the content handler will be selected based on the content model of the main slot (of the new revision, when the two are different). That might change after PageTypeHandler gets introduced.

In the past, the class was also used for slot-level diff generation, and extensions might still subclass it and add such functionality. When that is the case (sepcifically, when a ContentHandler returns a standard SlotDiffRenderer but a nonstandard DifferenceEngine) DifferenceEngineSlotDiffRenderer will be used to convert the old behavior into the new one.

Todo:: This class is huge and poorly defined. It should be split into a controller responsible for interpreting query parameters, retrieving data and checking permissions; and a HTML renderer.

Definition at line 58 of file DifferenceEngine.php.

Constructor & Destructor Documentation

◆ __construct()

DifferenceEngine::__construct	(	$context = `null`,
		$old = `0`,
		$new = `0`,
		$rcid = `0`,
		$refreshCache = `false`,
		$unhide = `false`
	)

#-

Parameters

IContextSource \| null	$context	Context to use, anything else will be ignored
int	$old	Old ID we want to show and diff with.
string \| int	$new	Either revision ID or 'prev' or 'next'. Default: 0.
int	$rcid	Deprecated, no longer used!
bool	$refreshCache	If set, refreshes the diff cache
bool	$unhide	If set, allow viewing deleted revs

Definition at line 246 of file DifferenceEngine.php.

References ContextSource\$context, $unhide, deprecatePublicProperty(), ContextSource\setContext(), and wfDebug().

Member Function Documentation

◆ addHeader()

DifferenceEngine::addHeader	(	$diff,
		$otitle,
		$ntitle,
		$multi = `''`,
		$notice = `''`
	)

Add the header to a diff body.

Parameters

string	$diff	Diff body
string	$otitle	Old revision header
string	$ntitle	New revision header
string	$multi	Notice telling user that there are intermediate revisions between the ones being compared
string	$notice	Other notices, e.g. that user is viewing deleted content

Returns: string

Definition at line 1840 of file DifferenceEngine.php.

References $header, getDiffLang(), ContextSource\getLanguage(), ContextSource\getUser(), and Html\openElement().

Referenced by getDiff(), and showDiffPage().

◆ addLocalisedTitleTooltips()

DifferenceEngine::addLocalisedTitleTooltips ( $text )

private

Add title attributes for tooltips on moved paragraph indicators.

Parameters

string $text

Returns: string

Definition at line 1644 of file DifferenceEngine.php.

Referenced by localiseDiff().

◆ addLocalisedTitleTooltipsCb()

DifferenceEngine::addLocalisedTitleTooltipsCb ( array $matches )

private

Parameters

array $matches

Returns: string

Definition at line 1656 of file DifferenceEngine.php.

References $matches, and ContextSource\msg().

◆ debug()

DifferenceEngine::debug ( $generator = "internal" )

protected

Generate a debug comment indicating diff generating time, server node, and generator backend.

Parameters

string $generator : What diff engine was used

Returns: string

Definition at line 1566 of file DifferenceEngine.php.

References $generator, ContextSource\getConfig(), wfHostname(), and wfTimestamp().

Referenced by getDebugString().

◆ deletedIdMarker()

DifferenceEngine::deletedIdMarker ( $id )

Build a wikitext link toward a deleted revision, if viewable.

Parameters

int $id Revision ID

Returns: string Wikitext fragment

Definition at line 485 of file DifferenceEngine.php.

References deletedLink().

Referenced by showMissingRevision().

◆ deletedLink()

DifferenceEngine::deletedLink ( $id )

Look up a special:Undelete link to the given deleted revision id, as a workaround for being unable to load deleted diffs in currently.

Parameters

int $id Revision ID

Returns: string|bool Link HTML or false

Definition at line 450 of file DifferenceEngine.php.

References $dbr, $revisionStore, $revStore, $title, DB_REPLICA, SpecialPage\getTitleFor(), Title\makeTitleSafe(), and wfGetDB().

Referenced by deletedIdMarker().

◆ generateContentDiffBody()

DifferenceEngine::generateContentDiffBody	(	Content	$old,
		Content	$new
	)

Generate a diff, no caching.

Since: 1.21

Parameters

Content	$old	Old content
Content	$new	New content

Exceptions

Exception If old or new content is not an instance of TextContent.

Returns: bool|string

Deprecated:: since 1.32, use a SlotDiffRenderer instead.

Definition at line 1436 of file DifferenceEngine.php.

References Content\getContentHandler(), ContextSource\getContext(), and getDebugString().

◆ generateTextDiffBody()

DifferenceEngine::generateTextDiffBody	(	$otext,
		$ntext
	)

Generate a diff, no caching.

Parameters

string	$otext	Old text, must be already segmented
string	$ntext	New text, must be already segmented

Exceptions

Exception If content handling for text content is configured in a way that makes maintaining B/C hard.

Returns: bool|string

Deprecated:: since 1.32, use a TextSlotDiffRenderer instead.

Definition at line 1464 of file DifferenceEngine.php.

References CONTENT_MODEL_TEXT, ContextSource\getContext(), and getDebugString().

◆ getDebugString()

DifferenceEngine::getDebugString ( )

private

Returns: string

Definition at line 1584 of file DifferenceEngine.php.

References debug(), and getEngine().

Referenced by generateContentDiffBody(), generateTextDiffBody(), and textDiff().

◆ getDiff()

DifferenceEngine::getDiff	(	$otitle,
		$ntitle,
		$notice = `''`
	)

Get complete diff table, including header.

Parameters

string \| false	$otitle	Header for old text or false
string \| false	$ntitle	Header for new text or false
string	$notice	HTML between diff header and body

Returns: mixed

Definition at line 1166 of file DifferenceEngine.php.

References addHeader(), getDiffBody(), getMultiNotice(), and ContextSource\msg().

Referenced by showDiff().

◆ getDiffBody()

DifferenceEngine::getDiffBody ( )

Get the diff table body, without header.

Returns: string|false

Definition at line 1188 of file DifferenceEngine.php.

References $cache, getDiffBodyCacheKey(), getDiffBodyCacheKeyParams(), getSlotContents(), getSlotDiffRenderers(), getSlotHeader(), loadRevisionData(), loadText(), and localiseDiff().

Referenced by getDiff().

◆ getDiffBodyCacheKey()

DifferenceEngine::getDiffBodyCacheKey ( )

protected

Returns the cache key for diff body text or content.

Deprecated:: since 1.31, use getDiffBodyCacheKeyParams() instead

Since: 1.23

Exceptions

MWException

Returns: string|null

Definition at line 1335 of file DifferenceEngine.php.

Referenced by getDiffBody(), and getExtraCacheKeys().

◆ getDiffBodyCacheKeyParams()

DifferenceEngine::getDiffBodyCacheKeyParams ( )

protected

Get the cache key parameters.

Subclasses can replace the first element in the array to something more specific to the type of diff (e.g. "inline-diff"), or append if the cache should vary on more things. Overriding entirely should be avoided.

Since: 1.31

Returns: string[]

Exceptions

MWException

Definition at line 1352 of file DifferenceEngine.php.

References DIFF_VERSION, getEngine(), and getSlotDiffRenderers().

Referenced by getDiffBody(), and getExtraCacheKeys().

◆ getDiffBodyForRole()

DifferenceEngine::getDiffBodyForRole ( $role )

Get the diff table body for one slot, without header.

Parameters

string $role

Returns: string|false

Definition at line 1289 of file DifferenceEngine.php.

References getSlotContents(), getSlotDiffRenderers(), getSlotHeader(), and localiseDiff().

◆ getDiffLang()

DifferenceEngine::getDiffLang ( )

Get the language of the difference engine, defaults to page content language.

Returns: Language

Definition at line 382 of file DifferenceEngine.php.

References $mDiffLang, and getTitle().

Referenced by addHeader().

◆ getEngine()

static DifferenceEngine::getEngine ( )

static

Process DiffEngine config and get a sane, usable engine.

Returns: string 'wikidiff2', 'php', or path to an executable

Definition at line 1483 of file DifferenceEngine.php.

References wfDebug(), and wfWarn().

Referenced by getDebugString(), getDiffBodyCacheKeyParams(), ContentHandler\getSlotDiffRendererWithOptions(), and localiseDiff().

◆ getExtraCacheKeys()

DifferenceEngine::getExtraCacheKeys ( )

Implements DifferenceEngineSlotDiffRenderer::getExtraCacheKeys().

Only used when DifferenceEngine is wrapped in DifferenceEngineSlotDiffRenderer.

Returns: string[]

Definition at line 1386 of file DifferenceEngine.php.

References getDiffBodyCacheKey(), and getDiffBodyCacheKeyParams().

◆ getMarkPatrolledLinkInfo()

DifferenceEngine::getMarkPatrolledLinkInfo ( )

protected

Returns an array of meta data needed to build a "mark as patrolled" link and adds a JS module to the output.

Returns: array|false An array of meta data for a patrol link (rcid only) or false if no link is needed

Definition at line 942 of file DifferenceEngine.php.

References ContextSource\getConfig(), ContextSource\getOutput(), ContextSource\getUser(), RecentChange\isInRCLifespan(), RecentChange\newFromConds(), and RecentChange\PRC_UNPATROLLED.

Referenced by markPatrolledLink().

◆ getMultiNotice()

DifferenceEngine::getMultiNotice ( )

If there are revisions between the ones being compared, return a note saying so.

Returns: string

Definition at line 1668 of file DifferenceEngine.php.

References $mNewRevisionRecord, $mOldRevisionRecord, and intermediateEditsMsg().

Referenced by getDiff(), and showDiffPage().

◆ getNewid()

DifferenceEngine::getNewid ( )

Get the ID of new revision (right pane) of the diff.

0 for the current revision, false if the new revision does not exist, null if it's unsaved. To get a real revision ID instead of 0, call loadRevisionData() first.

Returns: int|false|null

Definition at line 417 of file DifferenceEngine.php.

References $mNewid, and loadRevisionIds().

◆ getNewRevision()

DifferenceEngine::getNewRevision ( )

Get the right side of the diff.

Should not be null but can still happen in the case of load failure.

Returns: RevisionRecord|null

Definition at line 438 of file DifferenceEngine.php.

References $mNewRevisionRecord.

◆ getOldid()

DifferenceEngine::getOldid ( )

Get the ID of old revision (left pane) of the diff.

0 for the revision previous to getNewid(), false if the old revision does not exist, null if it's unsaved. To get a real revision ID instead of 0, call loadRevisionData() first.

Returns: int|false|null

Definition at line 405 of file DifferenceEngine.php.

References $mOldid, and loadRevisionIds().

◆ getOldRevision()

DifferenceEngine::getOldRevision ( )

Get the left side of the diff.

Could be null when the first revision of the page is diffed to 'prev' (or in the case of load failure).

Returns: RevisionRecord|null

Definition at line 429 of file DifferenceEngine.php.

◆ getParserOutput()

DifferenceEngine::getParserOutput	(	WikiPage	$page,
		RevisionRecord	$revRecord
	)

protected

Parameters

WikiPage	$page
RevisionRecord	$revRecord

Returns: ParserOutput|false False if the revision was not found

Definition at line 1101 of file DifferenceEngine.php.

References ContextSource\getContext(), Revision\RevisionRecord\getId(), WikiPage\getParserOutput(), and WikiPage\makeParserOptions().

Referenced by renderNewRevision().

◆ getPermissionErrors()

DifferenceEngine::getPermissionErrors ( User $user )

Get the permission errors associated with the revisions for the current diff.

Parameters

User $user

Returns: array[] Array of arrays of the arguments to wfMessage to explain permissions problems.

Definition at line 540 of file DifferenceEngine.php.

References loadRevisionData(), and wfMergeErrorArrays().

Referenced by showDiffPage().

◆ getRevisionHeader()

DifferenceEngine::getRevisionHeader	(	$rev,
		$complete = `''`
	)

Get a header for a specified revision.

Parameters

Revision \| RevisionRecord	$rev	(passing a Revision is deprecated since 1.35)
string	$complete	'complete' to get the header wrapped depending the visibility of the revision and a link to edit the page.

Returns: string HTML fragment

Definition at line 1769 of file DifferenceEngine.php.

References $header, $lang, $title, ContextSource\getLanguage(), ContextSource\getUser(), ContextSource\msg(), Html\rawElement(), userCanEdit(), and wfDeprecated().

Referenced by renderNewRevision(), and showDiffPage().

◆ getSlotContents()

DifferenceEngine::getSlotContents ( )

protected

Get the old and new content objects for all slots.

This method does not do any permission checks.

Returns: array [ role => [ 'old' => SlotRecord|null, 'new' => SlotRecord|null ], ... ]

Definition at line 323 of file DifferenceEngine.php.

References $mNewContent, $mOldContent, and loadRevisionData().

Referenced by getDiffBody(), getDiffBodyForRole(), and getSlotDiffRenderers().

◆ getSlotDiffRenderers()

DifferenceEngine::getSlotDiffRenderers ( )

protected

Returns: SlotDiffRenderer[] Diff renderers for each slot, keyed by role name. Includes slots only present in one of the revisions.

Definition at line 283 of file DifferenceEngine.php.

References $content, ContextSource\$context, $slotDiffRenderers, ContextSource\getContext(), getSlotContents(), and loadRevisionData().

Referenced by getDiffBody(), getDiffBodyCacheKeyParams(), getDiffBodyForRole(), and showDiffStyle().

◆ getSlotHeader()

DifferenceEngine::getSlotHeader ( $headerText )

protected

Get a slot header for inclusion in a diff body (as a table row).

Parameters

string $headerText The text of the header

Returns: string

Definition at line 1318 of file DifferenceEngine.php.

References Html\element(), ContextSource\getLanguage(), and Html\rawElement().

Referenced by getDiffBody(), and getDiffBodyForRole().

◆ getTitle()

DifferenceEngine::getTitle ( )

Since: 1.18 Stable to override

Returns: Title|null

Reimplemented from ContextSource.

Definition at line 362 of file DifferenceEngine.php.

References getTitle(), Title\makeTitle(), and NS_SPECIAL.

Referenced by getDiffLang(), loadRevisionData(), loadRevisionIds(), renderNewRevision(), and showDiffPage().

◆ hasDeletedRevision()

DifferenceEngine::hasDeletedRevision ( )

Checks whether one of the given Revisions was deleted.

Returns: bool

Definition at line 522 of file DifferenceEngine.php.

References loadRevisionData().

Referenced by hasSuppressedRevision(), shouldBeHiddenFromUser(), and showDiffPage().

◆ hasSuppressedRevision()

DifferenceEngine::hasSuppressedRevision ( )

Checks whether one of the given Revisions was suppressed.

Returns: bool

Definition at line 559 of file DifferenceEngine.php.

References hasDeletedRevision().

Referenced by showDiffPage().

◆ intermediateEditsMsg()

static DifferenceEngine::intermediateEditsMsg	(	$numEdits,
		$numUsers,
		$limit
	)

static

Get a notice about how many intermediate edits and users there are.

Parameters

int	$numEdits
int	$numUsers
int	$limit

Returns: string

Definition at line 1735 of file DifferenceEngine.php.

References wfMessage().

Referenced by getMultiNotice().

◆ isUserAllowedToSeeRevisions()

DifferenceEngine::isUserAllowedToSeeRevisions ( Authority $performer )

Checks whether the current user has permission for accessing the revisions of the diff.

Note that this does not check whether the user has permission to view the page, it only checks revdelete permissions.

It is the caller's responsibility to call $this->getUserPermissionErrors or similar checks.

Parameters

Authority $performer

Returns: bool

Definition at line 579 of file DifferenceEngine.php.

References loadRevisionData().

Referenced by shouldBeHiddenFromUser(), and showDiffPage().

◆ loadNewText()

DifferenceEngine::loadNewText ( )

Load the text of the new revision, not the old one.

Returns: bool Whether the content of the new revision could be loaded successfully.

Definition at line 2182 of file DifferenceEngine.php.

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

Referenced by renderNewRevision().

◆ loadRevisionData()

DifferenceEngine::loadRevisionData ( )

Load revision metadata for the specified revisions.

If newid is 0, then compare the old revision in oldid to the current revision of the current page (as defined by the request context); if oldid is 0, then compare the revision in newid to the immediately previous one.

If oldid is false, leave the corresponding revision object set to false. This can happen with 'diff=prev' pointing to a non-existent revision, and is also used directly by the API.

Returns: bool Whether both revisions were loaded successfully. Setting mOldRevisionRecord to false counts as successful loading.

Definition at line 2029 of file DifferenceEngine.php.

References $dbr, DB_REPLICA, getTitle(), loadRevisionIds(), Title\newFromLinkTarget(), and wfGetDB().

Referenced by getDiffBody(), getPermissionErrors(), getSlotContents(), getSlotDiffRenderers(), hasDeletedRevision(), isUserAllowedToSeeRevisions(), loadNewText(), loadText(), and showDiffPage().

◆ loadRevisionIds()

DifferenceEngine::loadRevisionIds ( )

private

Definition at line 1995 of file DifferenceEngine.php.

References $mNewid, $mOldid, getTitle(), and mapDiffPrevNext().

Referenced by getNewid(), getOldid(), and loadRevisionData().

◆ loadText()

DifferenceEngine::loadText ( )

Load the text of the revisions, as well as revision data.

When the old revision is missing (mOldRev is false), loading mOldContent is not attempted.

Returns: bool Whether the content of both revisions could be loaded successfully. (When mOldRev is false, that still counts as a success.)

Definition at line 2139 of file DifferenceEngine.php.

References $mOldContent, ContextSource\getUser(), and loadRevisionData().

Referenced by getDiffBody().

◆ localiseDiff()

DifferenceEngine::localiseDiff ( $text )

private

Localise diff output.

Parameters

string $text

Returns: string

Definition at line 1601 of file DifferenceEngine.php.

References addLocalisedTitleTooltips(), getEngine(), and localiseLineNumbers().

Referenced by getDiffBody(), and getDiffBodyForRole().

◆ localiseLineNumbers()

DifferenceEngine::localiseLineNumbers ( $text )

Replace line numbers with the text in the user's language.

Parameters

string $text

Returns: string

Definition at line 1618 of file DifferenceEngine.php.

Referenced by localiseDiff().

◆ localiseLineNumbersCb()

DifferenceEngine::localiseLineNumbersCb ( $matches )

Parameters

array $matches

Returns: string

Definition at line 1630 of file DifferenceEngine.php.

References $matches, and ContextSource\msg().

◆ mapDiffPrevNext()

DifferenceEngine::mapDiffPrevNext	(	$old,
		$new
	)

Maps a revision pair definition as accepted by DifferenceEngine constructor to a pair of actual integers representing revision ids.

Parameters

int	$old	Revision id, e.g. from URL parameter 'oldid'
int \| string	$new	Revision id or strings 'next' or 'prev', e.g. from URL parameter 'diff'

Returns: array List of two revision ids, older first, later second. Zero signifies invalid argument passed. false signifies that there is no previous/next revision ($old is the oldest/newest one). -return (int|false)[]

Definition at line 1964 of file DifferenceEngine.php.

Referenced by loadRevisionIds().

◆ markAsSlotDiffRenderer()

DifferenceEngine::markAsSlotDiffRenderer ( )

Mark this DifferenceEngine as a slot renderer (as opposed to a page renderer).

This is used in legacy mode when the DifferenceEngine is wrapped in a DifferenceEngineSlotDiffRenderer.

Definition at line 314 of file DifferenceEngine.php.

◆ markPatrolledLink()

DifferenceEngine::markPatrolledLink ( )

Build a link to mark a change as patrolled.

Returns empty string if there's either no revision to patrol or the user is not allowed to.

Side effect: When the patrol link is build, this method will call OutputPage::preventClickjacking() and load a JS module.

Returns: string HTML or empty string

Definition at line 910 of file DifferenceEngine.php.

References $mMarkPatrolledLink, getMarkPatrolledLinkInfo(), and ContextSource\msg().

Referenced by renderNewRevision(), and showDiffPage().

◆ renderNewRevision()

DifferenceEngine::renderNewRevision ( )

Show the new revision of the page.

Note: Not supported after calling setContent().

Definition at line 1020 of file DifferenceEngine.php.

References ContextSource\getOutput(), getParserOutput(), getRevisionHeader(), getTitle(), ContextSource\getWikiPage(), loadNewText(), and markPatrolledLink().

Referenced by showDiffPage().

◆ revisionDeleteLink()

DifferenceEngine::revisionDeleteLink ( RevisionRecord $revRecord )

private

Parameters

RevisionRecord $revRecord

Returns: string

Definition at line 1002 of file DifferenceEngine.php.

References Revision\RevisionRecord\getPageAsLinkTarget(), Linker\getRevDeleteLink(), and ContextSource\getUser().

Referenced by showDiffPage().

◆ setContent()

DifferenceEngine::setContent	(	Content	$oldContent,
		Content	$newContent
	)

Use specified text instead of loading from the database.

Parameters

Content	$oldContent
Content	$newContent

Since: 1.21

Deprecated:: since 1.32, use setRevisions or ContentHandler::getSlotDiffRenderer.

Definition at line 1900 of file DifferenceEngine.php.

Referenced by DifferenceEngineSlotDiffRenderer\__construct().

◆ setReducedLineNumbers()

DifferenceEngine::setReducedLineNumbers ( $value = true )

Set reduced line numbers mode.

When set, line X is not displayed when X is 1, for example to increase readability and conserve space with many small diffs.

Parameters

bool $value

Definition at line 373 of file DifferenceEngine.php.

◆ setRevisions()

DifferenceEngine::setRevisions	(	?RevisionRecord	$oldRevision,
		RevisionRecord	$newRevision
	)

Use specified text instead of loading from the database.

Parameters

RevisionRecord \| null	$oldRevision
RevisionRecord	$newRevision

Definition at line 1915 of file DifferenceEngine.php.

References Revision\RevisionRecord\getContent(), Revision\RevisionRecord\getId(), Revision\RevisionRecord\getPageAsLinkTarget(), ContextSource\getUser(), and Title\newFromLinkTarget().

◆ setSlotDiffOptions()

DifferenceEngine::setSlotDiffOptions ( $options )

Parameters

array $options for the difference engine - accepts keys 'diff-type'

Definition at line 1419 of file DifferenceEngine.php.

◆ setTextLanguage()

DifferenceEngine::setTextLanguage ( Language $lang )

Set the language in which the diff text is written.

Parameters

Language $lang

Since: 1.19

Definition at line 1948 of file DifferenceEngine.php.

References $lang.

◆ shouldBeHiddenFromUser()

DifferenceEngine::shouldBeHiddenFromUser ( $user )

Checks whether the diff should be hidden from the current user This is based on whether the user is allowed to see it and has specifically asked to see it.

Parameters

User $user

Returns: bool

Definition at line 605 of file DifferenceEngine.php.

References hasDeletedRevision(), and isUserAllowedToSeeRevisions().

Referenced by showDiffPage().

◆ showDiff()

DifferenceEngine::showDiff	(	$otitle,
		$ntitle,
		$notice = `''`
	)

Get the diff text, send it to the OutputPage object Returns false if the diff could not be generated, otherwise returns true.

Parameters

string \| false	$otitle	Header for old text or false
string \| false	$ntitle	Header for new text or false
string	$notice	HTML between diff header and body

Returns: bool

Definition at line 1125 of file DifferenceEngine.php.

References getDiff(), ContextSource\getOutput(), showDiffStyle(), and showMissingRevision().

Referenced by showDiffPage().

◆ showDiffPage()

DifferenceEngine::showDiffPage ( $diffOnly = false )

Parameters

bool $diffOnly

Definition at line 613 of file DifferenceEngine.php.

References $mNewRevisionRecord, $mOldRevisionRecord, $slotDiffOptions, addHeader(), Html\element(), ChangesList\flag(), ChangeTags\formatSummaryRow(), Linker\generateRollback(), ContextSource\getContext(), getMultiNotice(), ContextSource\getOutput(), getPermissionErrors(), ContextSource\getRequest(), getRevisionHeader(), getTitle(), ContextSource\getUser(), hasDeletedRevision(), hasSuppressedRevision(), isUserAllowedToSeeRevisions(), loadRevisionData(), markPatrolledLink(), ContextSource\msg(), Html\rawElement(), renderNewRevision(), Linker\revComment(), revisionDeleteLink(), Linker\revUserTools(), shouldBeHiddenFromUser(), showDiff(), showDiffStyle(), showMissingRevision(), Linker\titleAttrib(), userCanEdit(), and Html\warningBox().

◆ showDiffStyle()

DifferenceEngine::showDiffStyle ( )

Add style sheets for diff display.

Definition at line 1145 of file DifferenceEngine.php.

References ContextSource\getOutput(), and getSlotDiffRenderers().

Referenced by showDiff(), and showDiffPage().

◆ showMissingRevision()

DifferenceEngine::showMissingRevision ( )

private

Definition at line 494 of file DifferenceEngine.php.

References deletedIdMarker(), ContextSource\getLanguage(), ContextSource\getOutput(), and ContextSource\msg().

Referenced by showDiff(), and showDiffPage().

◆ textDiff()

DifferenceEngine::textDiff	(	$otext,
		$ntext
	)

protected

Generates diff, to be wrapped internally in a logging/instrumentation.

Parameters

string	$otext	Old text, must be already segmented
string	$ntext	New text, must be already segmented

Exceptions

Exception If content handling for text content is configured in a way that makes maintaining B/C hard.

Returns: bool|string

Deprecated:: since 1.32, use a TextSlotDiffRenderer instead.

Definition at line 1545 of file DifferenceEngine.php.

References CONTENT_MODEL_TEXT, ContextSource\getContext(), and getDebugString().

◆ userCanEdit()

DifferenceEngine::userCanEdit ( RevisionRecord $revRecord )

private

Parameters

RevisionRecord $revRecord

Returns: bool whether the user can see and edit the revision.

Definition at line 1752 of file DifferenceEngine.php.

References Revision\RevisionRecord\userCan().

Referenced by getRevisionHeader(), and showDiffPage().

◆ wasCacheHit()

DifferenceEngine::wasCacheHit ( )

Returns: bool

Definition at line 394 of file DifferenceEngine.php.

References $mCacheHit.

Member Data Documentation

◆ $contentHandlerFactory

IContentHandlerFactory DifferenceEngine::$contentHandlerFactory

private

Definition at line 220 of file DifferenceEngine.php.

◆ $enableDebugComment

bool DifferenceEngine::$enableDebugComment = false

Set this to true to add debug info to the HTML output.

Warning: this may cause RSS readers to spuriously mark articles as "new" (T22601)

Definition at line 179 of file DifferenceEngine.php.

◆ $hookContainer

HookContainer DifferenceEngine::$hookContainer

private

Definition at line 231 of file DifferenceEngine.php.

◆ $hookRunner

HookRunner DifferenceEngine::$hookRunner

private

Definition at line 228 of file DifferenceEngine.php.

◆ $isContentOverridden

bool DifferenceEngine::$isContentOverridden = false

protected

Was the content overridden via setContent()? If the content was overridden, most internal state (e.g.

mOldid or mOldRev) should be ignored and only mOldContent and mNewContent is reliable. (Note that setRevisions() does not set this flag as in that case all properties are overriden and remain consistent with each other, so no special handling is needed.)

Definition at line 168 of file DifferenceEngine.php.

◆ $isSlotDiffRenderer

bool DifferenceEngine::$isSlotDiffRenderer = false

protected

Temporary hack for B/C while slot diff related methods of DifferenceEngine are being deprecated.

When true, we are inside a DifferenceEngineSlotDiffRenderer and $slotDiffRenderers should not be used.

Definition at line 204 of file DifferenceEngine.php.

◆ $linkRenderer

LinkRenderer DifferenceEngine::$linkRenderer

protected

Definition at line 215 of file DifferenceEngine.php.

◆ $mCacheHit

bool DifferenceEngine::$mCacheHit = false

protected

Was the diff fetched from cache?

Definition at line 171 of file DifferenceEngine.php.

Referenced by wasCacheHit().

◆ $mDiffLang

Language DifferenceEngine::$mDiffLang

protected

Definition at line 149 of file DifferenceEngine.php.

Referenced by getDiffLang().

◆ $mMarkPatrolledLink

string DifferenceEngine::$mMarkPatrolledLink = null

protected

Link to action=markpatrolled.

Definition at line 187 of file DifferenceEngine.php.

Referenced by markPatrolledLink().

◆ $mNewContent

Content null DifferenceEngine::$mNewContent

private

Deprecated:: since 1.32, content slots are now handled by the corresponding SlotDiffRenderer. This property is set to the content of the main slot, but not actually used for the main diff.

Definition at line 146 of file DifferenceEngine.php.

Referenced by getSlotContents().

◆ $mNewid

int string false null DifferenceEngine::$mNewid

protected

Revision ID for the new revision.

0 for the last revision of the current page (as defined by the request context), false if the revision does not exist, null if it is unsaved, or an alias such as 'next'.

Definition at line 84 of file DifferenceEngine.php.

Referenced by getNewid(), and loadRevisionIds().

◆ $mNewPage

Title null DifferenceEngine::$mNewPage

protected

Title of new revision or null if the new revision does not exist or does not belong to a page.

Since 1.32 public access is deprecated and the property can be null.

Definition at line 120 of file DifferenceEngine.php.

◆ $mNewRevisionRecord

RevisionRecord null DifferenceEngine::$mNewRevisionRecord

private

New revision (right pane).

Note that this might be an unsaved revision (e.g. for edit preview). Null in case of load failure; diff methods will just return an error message in that case, and loadRevisionData() will return false. Also null until lazy-loaded. Ignored completely when isContentOverridden is set.

Definition at line 106 of file DifferenceEngine.php.

Referenced by getMultiNotice(), getNewRevision(), and showDiffPage().

◆ $mNewTags

string [] null DifferenceEngine::$mNewTags

private

Change tags of new revision or null if it does not exist / is not saved.

Definition at line 132 of file DifferenceEngine.php.

◆ $mOldContent

Content null DifferenceEngine::$mOldContent

private

Deprecated:: since 1.32, content slots are now handled by the corresponding SlotDiffRenderer. This property is set to the content of the main slot, but not actually used for the main diff.

Definition at line 139 of file DifferenceEngine.php.

Referenced by getSlotContents(), and loadText().

◆ $mOldid

int false null DifferenceEngine::$mOldid

protected

Revision ID for the old revision.

0 for the revision previous to $mNewid, false if the diff does not have an old revision (e.g. 'oldid=<first revision of page>&diff=prev'), or the revision does not exist, null if the revision is unsaved.

Definition at line 76 of file DifferenceEngine.php.

Referenced by getOldid(), and loadRevisionIds().

◆ $mOldPage

Title null DifferenceEngine::$mOldPage

protected

Title of old revision or null if the old revision does not exist or does not belong to a page.

Since 1.32 public access is deprecated and the property can be null.

Definition at line 113 of file DifferenceEngine.php.

◆ $mOldRevisionRecord

RevisionRecord null false DifferenceEngine::$mOldRevisionRecord

private

Old revision (left pane).

Allowed to be an unsaved revision, unlikely that's ever needed though. False when the old revision does not exist; this can happen when using diff=prev on the first revision. Null when the revision should exist but doesn't (e.g. load failure); loadRevisionData() will return false in that case. Also null until lazy-loaded. Ignored completely when isContentOverridden is set.

Definition at line 96 of file DifferenceEngine.php.

Referenced by getMultiNotice(), and showDiffPage().

◆ $mOldTags

string [] null DifferenceEngine::$mOldTags

private

Change tags of old revision or null if it does not exist / is not saved.

Definition at line 126 of file DifferenceEngine.php.

◆ $mReducedLineNumbers

bool DifferenceEngine::$mReducedLineNumbers = false

protected

If true, line X is not displayed when X is 1, for example to increase readability and conserve space with many small diffs.

Definition at line 184 of file DifferenceEngine.php.

◆ $mRefreshCache

bool DifferenceEngine::$mRefreshCache = false

protected

Refresh the diff cache.

Definition at line 193 of file DifferenceEngine.php.

◆ $mRevisionsIdsLoaded

bool DifferenceEngine::$mRevisionsIdsLoaded = false

private

Have the revisions IDs been loaded.

Definition at line 152 of file DifferenceEngine.php.

◆ $mRevisionsLoaded

bool DifferenceEngine::$mRevisionsLoaded = false

protected

Have the revisions been loaded.

Definition at line 155 of file DifferenceEngine.php.

◆ $mTextLoaded

int DifferenceEngine::$mTextLoaded = 0

protected

How many text blobs have been loaded, 0, 1 or 2?

Definition at line 158 of file DifferenceEngine.php.

◆ $revisionStore

RevisionStore DifferenceEngine::$revisionStore

private

Definition at line 225 of file DifferenceEngine.php.

Referenced by deletedLink().

◆ $slotDiffOptions

array DifferenceEngine::$slotDiffOptions = []

private

A set of options that will be passed to the SlotDiffRenderer upon creation.

Definition at line 210 of file DifferenceEngine.php.

Referenced by showDiffPage().

◆ $slotDiffRenderers

SlotDiffRenderer [] DifferenceEngine::$slotDiffRenderers = null

protected

DifferenceEngine classes for the slots, keyed by role name.

Definition at line 196 of file DifferenceEngine.php.

Referenced by getSlotDiffRenderers().

◆ $unhide

bool DifferenceEngine::$unhide = false

protected

Show rev_deleted content if allowed.

Definition at line 190 of file DifferenceEngine.php.

Referenced by __construct().

◆ $wikiPageFactory

WikiPageFactory DifferenceEngine::$wikiPageFactory

private

Definition at line 234 of file DifferenceEngine.php.

◆ DIFF_VERSION

const DifferenceEngine::DIFF_VERSION = '1.12'

private

Constant to indicate diff cache compatibility.

Bump this when changing the diff formatting in a way that fixes important bugs or such to force cached diff views to clear.

Definition at line 68 of file DifferenceEngine.php.

Referenced by getDiffBodyCacheKeyParams().

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

includes/diff/DifferenceEngine.php

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addHeader()

◆ addLocalisedTitleTooltips()

◆ addLocalisedTitleTooltipsCb()

◆ debug()

◆ deletedIdMarker()

◆ deletedLink()

◆ generateContentDiffBody()

◆ generateTextDiffBody()

◆ getDebugString()

◆ getDiff()

◆ getDiffBody()

◆ getDiffBodyCacheKey()

◆ getDiffBodyCacheKeyParams()

◆ getDiffBodyForRole()

◆ getDiffLang()

◆ getEngine()

◆ getExtraCacheKeys()

◆ getMarkPatrolledLinkInfo()

◆ getMultiNotice()

◆ getNewid()

◆ getNewRevision()

◆ getOldid()

◆ getOldRevision()

◆ getParserOutput()

◆ getPermissionErrors()

◆ getRevisionHeader()

◆ getSlotContents()

◆ getSlotDiffRenderers()

◆ getSlotHeader()

◆ getTitle()

◆ hasDeletedRevision()

◆ hasSuppressedRevision()

◆ intermediateEditsMsg()

◆ isUserAllowedToSeeRevisions()

◆ loadNewText()

◆ loadRevisionData()

◆ loadRevisionIds()

◆ loadText()

◆ localiseDiff()

◆ localiseLineNumbers()

◆ localiseLineNumbersCb()

◆ mapDiffPrevNext()

◆ markAsSlotDiffRenderer()

◆ markPatrolledLink()

◆ renderNewRevision()

◆ revisionDeleteLink()

◆ setContent()

◆ setReducedLineNumbers()

◆ setRevisions()

◆ setSlotDiffOptions()

◆ setTextLanguage()

◆ shouldBeHiddenFromUser()

◆ showDiff()

◆ showDiffPage()

◆ showDiffStyle()

◆ showMissingRevision()

◆ textDiff()

◆ userCanEdit()

◆ wasCacheHit()

Member Data Documentation

◆ $contentHandlerFactory

◆ $enableDebugComment

◆ $hookContainer

◆ $hookRunner

◆ $isContentOverridden

◆ $isSlotDiffRenderer

◆ $linkRenderer

◆ $mCacheHit

◆ $mDiffLang