Base class for all Content objects. More...

Inherits MediaWiki\Content\Content, and JsonCodecable.

Inherited by MediaWiki\Content\FallbackContent, and MediaWiki\Content\TextContent.

Collaboration diagram for MediaWiki\Content\AbstractContent:

[legend]

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 ()

	getModel ()

	getNativeData ()

	getRedirectTarget ()
	Subclasses that implement redirects should override this.

	getSection ( $sectionId)

	getSupportedFormats ()

	isEmpty ()

	isRedirect ()

	isSupportedFormat ( $format)

	isValid ()

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

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

	serialize ( $format=null)

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

Public Member Functions inherited from MediaWiki\Content\Content
	copy ()
	Create a copy of this Content object.

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

	getTextForSearchIndex ()

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

	getWikitextForTransclusion ()

	isCountable ( $hasLinks=null)
	Whether this content may count towards a "real" wiki page.

Static Public Member Functions
static	jsonClassCodec (JsonCodecInterface $codec, ContainerInterface $serviceContainer)

Protected Member Functions
	checkFormat ( $format)
	Helper for subclasses.

	checkModelID ( $modelId)
	Helper for subclasses.

	equalsInternal (Content $that)
	Helper for AbstractContent::equals.

	getContentHandlerFactory ()

Protected Attributes
string	$model_id

Detailed Description

Base class for all Content objects.

Refer to Content for more information.

Stability: stable: to extend

Since: 1.21

Definition at line 28 of file AbstractContent.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Content\AbstractContent::__construct ( $modelId = null )

Stability: stable: to call

Since: 1.21

Parameters

string | null $modelId One of the CONTENT_MODEL_XXX constants.

Reimplemented in MediaWiki\Content\WikitextContent.

Definition at line 40 of file AbstractContent.php.

Member Function Documentation

◆ addSectionHeader()

MediaWiki\Content\AbstractContent::addSectionHeader ( $header )

Stability: stable: to override

See also: Content::addSectionHeader

Since: 1.21

Parameters

string $header

Returns: Content $this

Implements MediaWiki\Content\Content.

Reimplemented in MediaWiki\Content\WikitextContent.

Definition at line 290 of file AbstractContent.php.

◆ checkFormat()

MediaWiki\Content\AbstractContent::checkFormat ( $format )

protected

Helper for subclasses.

Since: 1.21

Parameters

string $format The serialization format to check.

Exceptions

MWException If the format is not supported by this Content object

Definition at line 120 of file AbstractContent.php.

◆ checkModelID()

MediaWiki\Content\AbstractContent::checkModelID ( $modelId )

protected

Helper for subclasses.

Since: 1.21

Parameters

string $modelId The model to check

Exceptions

MWException If the provided model ID differs from this Content object

Definition at line 60 of file AbstractContent.php.

Referenced by MediaWiki\Content\TextContent\diff().

◆ convert()

MediaWiki\Content\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.

Stability: stable: to override

See also: Content::convert()

Parameters

string	$toModel
string	$lossy

Returns: Content|false

Implements MediaWiki\Content\Content.

Reimplemented in MediaWiki\Content\FallbackContent, and MediaWiki\Content\TextContent.

Definition at line 318 of file AbstractContent.php.

References MediaWiki\MediaWikiServices\getInstance().

◆ equals()

MediaWiki\Content\AbstractContent::equals ( ?Content $that = null )

See also: Content::equals

Stability: stable: to override

Since: 1.21

Parameters

Content | null $that

Returns: bool

Implements MediaWiki\Content\Content.

Definition at line 180 of file AbstractContent.php.

Referenced by MediaWiki\Content\CssContent\getRedirectTarget().

◆ equalsInternal()

MediaWiki\Content\AbstractContent::equalsInternal ( Content $that )

protected

Helper for AbstractContent::equals.

Note: Do not call this method directly, call Content::equals() instead.

This method can be overwritten by subclasses that only need to implement custom equality checks, with the rest of the Content::equals contract taken care of by AbstractContent::equals.

This default implementation compares Content::serialize of each object.

If you override this method, you can safely assume that $that is an instance of the same class as the current Content object. This is ensured by AbstractContent::equals.