Base implementation for content objects. More...

Inheritance diagram for AbstractContent:

[legend]

Collaboration diagram for AbstractContent:

Public Member Functions
	__construct ( $modelId=null)

	addSectionHeader ( $header)

	convert ( $toModel, $lossy='')
	This base implementation calls the hook ConvertContent to enable custom conversions.

	equals (Content $that=null)

	getContentHandler ()

	getDefaultFormat ()

	getDeletionUpdates (WikiPage $page, ParserOutput $parserOutput=null)

	getModel ()

	getParserOutput (Title $title, $revId=null, ParserOptions $options=null, $generateHtml=true)
	Returns a ParserOutput object containing information derived from this content.

	getRedirectChain ()

	getRedirectTarget ()
	Subclasses that implement redirects should override this.

	getSecondaryDataUpdates (Title $title, Content $old=null, $recursive=true, ParserOutput $parserOutput=null)
	Returns a list of DataUpdate objects for recording information about this Content in some secondary data store.

	getSection ( $sectionId)

	getSupportedFormats ()

	getUltimateRedirectTarget ()

	isEmpty ()

	isRedirect ()

	isSupportedFormat ( $format)

	isValid ()
	Subclasses may override this to implement (light weight) validation.

	matchMagicWord (MagicWord $word)
	This default implementation always returns false.

	preloadTransform (Title $title, ParserOptions $popts, $params=[])

	prepareSave (WikiPage $page, $flags, $parentRevId, User $user)

	preSaveTransform (Title $title, User $user, ParserOptions $popts)

	replaceSection ( $sectionId, Content $with, $sectionTitle='')

	serialize ( $format=null)

	updateRedirect (Title $target)
	This default implementation always returns $this.

Public Member Functions inherited from Content
	copy ()
	Return a copy of this Content object.

	getNativeData ()
	Returns native representation of the data.

	getSize ()
	Returns the content's nominal size in "bogo-bytes".

	getTextForSearchIndex ()

	getTextForSummary ( $maxLength=250)
	Returns a textual representation of the content suitable for use in edit summaries and log messages.

	getWikitextForTransclusion ()

	isCountable ( $hasLinks=null)
	Returns true if this content is countable as a "real" wiki page, provided that it's also in a countable location (e.g.

Protected Member Functions
	checkFormat ( $format)

	checkModelID ( $modelId)

	fillParserOutput (Title $title, $revId, ParserOptions $options, $generateHtml, ParserOutput &$output)
	Fills the provided ParserOutput with information derived from the content.

Protected Attributes
	$model_id
	Name of the content model this Content object represents.

Detailed Description

Base implementation for content objects.

Definition at line 34 of file AbstractContent.php.

Constructor & Destructor Documentation

◆ __construct()

AbstractContent::__construct ( $modelId = null )

Parameters

string | null $modelId

Since: 1.21

Reimplemented in DummyContentForTesting, DummyNonTextContent, GadgetDefinitionContent, WikitextContent, and RevisionTestModifyableContent.

Definition at line 50 of file AbstractContent.php.

Member Function Documentation

◆ addSectionHeader()

AbstractContent::addSectionHeader ( $header )

Since: 1.21

Parameters

string $header

Returns: Content $this

See also: Content::addSectionHeader

Implements Content.

Reimplemented in WikitextContent.

Definition at line 386 of file AbstractContent.php.

◆ checkFormat()

AbstractContent::checkFormat ( $format )

protected

Since: 1.21

Parameters

string $format The serialization format to check.

Exceptions

MWException If the format is not supported by this content handler.

Definition at line 136 of file AbstractContent.php.

References getModel(), and isSupportedFormat().

◆ checkModelID()

AbstractContent::checkModelID ( $modelId )

protected

Since: 1.21

Parameters

string $modelId The model to check

Exceptions

MWException If the provided ID is not the ID of the content model supported by this Content object.

Definition at line 72 of file AbstractContent.php.

Referenced by TextContent\diff().

◆ convert()

AbstractContent::convert	(		$toModel,
			$lossy = '' )

This base implementation calls the hook ConvertContent to enable custom conversions.

Subclasses may override this to implement conversion for "their" content model.

Parameters

string	$toModel
string	$lossy

Returns: Content|bool

See also: Content::convert()

Implements Content.

Reimplemented in TextContent.

Definition at line 466 of file AbstractContent.php.

References $result, and getModel().

◆ equals()

AbstractContent::equals ( Content $that = null )

Since: 1.21

Parameters

Content | null $that

Returns: bool

See also: Content::equals

Implements Content.

Definition at line 191 of file AbstractContent.php.

References Content\getNativeData().

Referenced by CssContent\getRedirectTarget(), and JavaScriptContent\getRedirectTarget().

◆ fillParserOutput()

AbstractContent::fillParserOutput	(	Title	$title,
			$revId,
		ParserOptions	$options,
			$generateHtml,
		ParserOutput &	$output )

protected

Fills the provided ParserOutput with information derived from the content.

Unless $generateHtml was false, this includes an HTML representation of the content.

This is called by getParserOutput() after consulting the ContentGetParserOutput hook. Subclasses are expected to override this method (or getParserOutput(), if need be). Subclasses of TextContent should generally override getHtml() instead.

This placeholder implementation always throws an exception.

Since: 1.24

Parameters

Title	$title	Context title for parsing
int \| null	$revId	Revision ID (for {{REVISIONID}})
ParserOptions	$options
bool	$generateHtml	Whether or not to generate HTML
ParserOutput	&$output	The output object to fill (reference).

Exceptions

MWException

Reimplemented in GadgetDefinitionContent, JsonContent, TextContent, WikitextContent, DummyContentForTesting, and DummyNonTextContent.

Definition at line 547 of file AbstractContent.php.

Referenced by getParserOutput().

◆ getContentHandler()

AbstractContent::getContentHandler ( )

Since: 1.21

See also: Content::getContentHandler

Returns: ContentHandler

Implements Content.

Definition at line 88 of file AbstractContent.php.

Referenced by GadgetDefinitionContent\getAssocArray(), getDefaultFormat(), CssContent\getRedirectTarget(), JavaScriptContent\getRedirectTarget(), getSupportedFormats(), isSupportedFormat(), serialize(), CssContent\updateRedirect(), and JavaScriptContent\updateRedirect().

◆ getDefaultFormat()

AbstractContent::getDefaultFormat ( )

Since: 1.21

See also: Content::getDefaultFormat

Returns: string

Implements Content.

Definition at line 98 of file AbstractContent.php.

References getContentHandler().

◆ getDeletionUpdates()

AbstractContent::getDeletionUpdates	(	WikiPage	$page,
		ParserOutput	$parserOutput = null )

Since: 1.21

Parameters

WikiPage	$page
ParserOutput \| null	$parserOutput

Returns: DeferrableUpdate[]

See also: Content::getDeletionUpdates

Implements Content.

Reimplemented in GadgetDefinitionContent.

Definition at line 433 of file AbstractContent.php.

◆ getModel()

AbstractContent::getModel ( )

Since: 1.21

See also: Content::getModel

Returns: string

Implements Content.

Definition at line 60 of file AbstractContent.php.

References $model_id.

Referenced by checkFormat(), convert(), TextContent\fillParserOutput(), TextContent\preSaveTransform(), and WikitextContent\replaceSection().

◆ getParserOutput()

AbstractContent::getParserOutput	(	Title	$title,
			$revId = null,
		ParserOptions	$options = null,
			$generateHtml = true )

Returns a ParserOutput object containing information derived from this content.

Most importantly, unless $generateHtml was false, the return value contains an HTML representation of the content.

Subclasses that want to control the parser output may override this, but it is preferred to override fillParserOutput() instead.

Subclasses that override getParserOutput() itself should take care to call the ContentGetParserOutput hook.

Since: 1.24

Parameters

Title	$title	Context title for parsing
int \| null	$revId	Revision ID (for {{REVISIONID}})
ParserOptions \| null	$options
bool	$generateHtml	Whether or not to generate HTML

Returns: ParserOutput Containing information derived from this content.

Implements Content.

Reimplemented in MessageContent, DummyContentForTesting, and DummyNonTextContent.

Definition at line 500 of file AbstractContent.php.

References $options, fillParserOutput(), and getRedirectTarget().

Referenced by getSecondaryDataUpdates(), and WikitextContent\isCountable().

◆ getRedirectChain()

AbstractContent::getRedirectChain ( )

Since: 1.21

Returns: Title[]|null

See also: Content::getRedirectChain

Implements Content.

Definition at line 253 of file AbstractContent.php.

References $title, $titles, $wgMaxRedirects, getRedirectTarget(), and Title\isValidRedirectTarget().

Referenced by WikitextContent\fillParserOutput(), and getUltimateRedirectTarget().

◆ getRedirectTarget()

AbstractContent::getRedirectTarget ( )

Subclasses that implement redirects should override this.

Since: 1.21

Returns: Title|null

See also: Content::getRedirectTarget

Implements Content.

Reimplemented in CssContent, JavaScriptContent, and WikitextContent.

Definition at line 292 of file AbstractContent.php.

Referenced by getParserOutput(), getRedirectChain(), and isRedirect().

◆ getSecondaryDataUpdates()

AbstractContent::getSecondaryDataUpdates	(	Title	$title,
		Content	$old = null,
			$recursive = true,
		ParserOutput	$parserOutput = null )

Returns a list of DataUpdate objects for recording information about this Content in some secondary data store.

This default implementation returns a LinksUpdate object and calls the SecondaryDataUpdates hook.

Subclasses may override this to determine the secondary data updates more efficiently, preferably without the need to generate a parser output object. They should however make sure to call SecondaryDataUpdates to give extensions a chance to inject additional updates.

Since: 1.21

Parameters

Title	$title
Content \| null	$old
bool	$recursive
ParserOutput \| null	$parserOutput

Returns: DataUpdate[]

See also: Content::getSecondaryDataUpdates()

Implements Content.

Reimplemented in GadgetDefinitionContent.

Definition at line 230 of file AbstractContent.php.

References getParserOutput().

◆ getSection()

AbstractContent::getSection ( $sectionId )

Since: 1.21

Parameters

string | int $sectionId

Returns: null

See also: Content::getSection

Implements Content.

Reimplemented in WikitextContent.

Definition at line 346 of file AbstractContent.php.

◆ getSupportedFormats()

AbstractContent::getSupportedFormats ( )

Since: 1.21

See also: Content::getSupportedFormats

Returns: string[]

Implements Content.

Definition at line 108 of file AbstractContent.php.

References getContentHandler().

◆ getUltimateRedirectTarget()

AbstractContent::getUltimateRedirectTarget ( )

Note: Migrated here from Title::newFromRedirectRecurse.

Since: 1.21

Returns: Title|null

See also: Content::getUltimateRedirectTarget

Implements Content.

Definition at line 305 of file AbstractContent.php.

References $titles, and getRedirectChain().

◆ isEmpty()

AbstractContent::isEmpty ( )

Since: 1.21

Returns: bool

See also: Content::isEmpty

Implements Content.

Definition at line 165 of file AbstractContent.php.

References Content\getSize().

◆ isRedirect()

AbstractContent::isRedirect ( )

Since: 1.21

Returns: bool

See also: Content::isRedirect

Implements Content.

Definition at line 318 of file AbstractContent.php.

References getRedirectTarget().

Referenced by TextContent\isCountable(), WikitextContent\isCountable(), CssContent\updateRedirect(), JavaScriptContent\updateRedirect(), and WikitextContent\updateRedirect().

◆ isSupportedFormat()

AbstractContent::isSupportedFormat ( $format )

Since: 1.21

Parameters

string $format

Returns: bool

See also: Content::isSupportedFormat

Implements Content.

Definition at line 121 of file AbstractContent.php.

References getContentHandler().

Referenced by checkFormat().

◆ isValid()

AbstractContent::isValid ( )

Subclasses may override this to implement (light weight) validation.

Since: 1.21

Returns: bool Always true.

See also: Content::isValid

Implements Content.

Reimplemented in GadgetDefinitionContent, and JsonContent.

Definition at line 178 of file AbstractContent.php.

Referenced by prepareSave().

◆ matchMagicWord()

AbstractContent::matchMagicWord ( MagicWord $word )

This default implementation always returns false.

Subclasses may override this to supply matching logic.

Since: 1.21

Parameters

MagicWord $word

Returns: bool Always false.

See also: Content::matchMagicWord

Implements Content.

Reimplemented in WikitextContent.

Definition at line 451 of file AbstractContent.php.

◆ preloadTransform()

AbstractContent::preloadTransform	(	Title	$title,
		ParserOptions	$popts,
			$params = [] )

Since: 1.21

Parameters

Title	$title
ParserOptions	$popts
array	$params

Returns: Content $this

See also: Content::preloadTransform

Implements Content.

Reimplemented in WikitextContent.

Definition at line 400 of file AbstractContent.php.

◆ prepareSave()

AbstractContent::prepareSave	(	WikiPage	$page,
			$flags,
			$parentRevId,
		User	$user )

Since: 1.21

Parameters

WikiPage	$page
int	$flags
int	$parentRevId
User	$user

Returns: Status

See also: Content::prepareSave

Implements Content.

Definition at line 415 of file AbstractContent.php.

References isValid().

◆ preSaveTransform()

AbstractContent::preSaveTransform	(	Title	$title,
		User	$user,
		ParserOptions	$popts )

Since: 1.21

Parameters

Title	$title
User	$user
ParserOptions	$popts

Returns: Content $this

See also: Content::preSaveTransform

Implements Content.

Reimplemented in CssContent, JavaScriptContent, JsonContent, TextContent, and WikitextContent.

Definition at line 374 of file AbstractContent.php.

◆ replaceSection()

AbstractContent::replaceSection	(		$sectionId,
		Content	$with,
			$sectionTitle = '' )

Since: 1.21

Parameters

string \| int \| null \| bool	$sectionId
Content	$with
string	$sectionTitle

Returns: null

See also: Content::replaceSection

Implements Content.

Reimplemented in WikitextContent.

Definition at line 360 of file AbstractContent.php.

◆ serialize()

AbstractContent::serialize ( $format = null )

Since: 1.21

Parameters

string | null $format

Returns: string

See also: Content::serialize

Implements Content.

Reimplemented in DummyContentForTesting, and DummyNonTextContent.

Definition at line 154 of file AbstractContent.php.

References getContentHandler().

◆ updateRedirect()

AbstractContent::updateRedirect ( Title $target )

This default implementation always returns $this.

Subclasses that implement redirects should override this.

Since: 1.21

Parameters

Title $target

Returns: Content $this

See also: Content::updateRedirect

Implements Content.

Reimplemented in CssContent, JavaScriptContent, and WikitextContent.

Definition at line 334 of file AbstractContent.php.

Member Data Documentation

◆ $model_id

string AbstractContent::$model_id

protected

Name of the content model this Content object represents.

Use with CONTENT_MODEL_XXX constants

Since: 1.21

Definition at line 43 of file AbstractContent.php.

Referenced by TextContent\__construct(), and getModel().

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

includes/content/AbstractContent.php

Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addSectionHeader()

◆ checkFormat()

◆ checkModelID()

◆ convert()

◆ equals()

◆ fillParserOutput()

◆ getContentHandler()

◆ getDefaultFormat()

◆ getDeletionUpdates()

◆ getModel()

◆ getParserOutput()

◆ getRedirectChain()

◆ getRedirectTarget()

◆ getSecondaryDataUpdates()

◆ getSection()

◆ getSupportedFormats()

◆ getUltimateRedirectTarget()

◆ isEmpty()

◆ isRedirect()

◆ isSupportedFormat()

◆ isValid()

◆ matchMagicWord()

◆ preloadTransform()

◆ prepareSave()

◆ preSaveTransform()

◆ replaceSection()

◆ serialize()

◆ updateRedirect()

Member Data Documentation

◆ $model_id