Base class for content handling. More...

Inherited by MediaWiki\Content\FallbackContentHandler, and MediaWiki\Content\TextContentHandler.

Public Member Functions
	__construct ( $modelId, $formats)
	Constructor, initializing the ContentHandler instance with its model ID and a list of supported formats.

	canBeUsedOn (Title $title)
	Determines whether the content type handled by this ContentHandler can be used for the main slot of the given page.

	createDifferenceEngine (IContextSource $context, $old=0, $new=0, $rcid=0, $refreshCache=false, $unhide=false)
	Factory for creating an appropriate DifferenceEngine for this content model.

	deserializeContentFromJsonArray (array $json)
	Deserializes a Content object of the type supported by this ContentHandler from a JsonCodecable array.

	exportTransform ( $blob, $format=null)
	Applies transformations on export (returns the blob unchanged by default).

	fillParserOutputInternal (Content $content, ContentParseParams $cpoParams, ParserOutput &$output)
	A temporary layer to move AbstractContent::fillParserOutput to ContentHandler::fillParserOutput.

	generateHTMLOnEdit ()
	Whether an edit on the content should trigger an HTML render and ParserCache entry.

	getActionOverrides ()
	Returns overrides for action handlers.

	getAutoDeleteReason (Title $title, &$hasHistory=false)
	Auto-generates a deletion reason.

	getAutosummary (?Content $oldContent=null, ?Content $newContent=null, $flags=0)
	Return an applicable auto-summary if one exists for the given edit.

	getChangeTag (?Content $oldContent=null, ?Content $newContent=null, $flags=0)
	Return an applicable tag if one exists for the given edit or return null.

	getDataForSearchIndex (WikiPage $page, ParserOutput $output, SearchEngine $engine, ?RevisionRecord $revision=null)
	Return fields to be indexed by search engine as representation of this document.

	getDefaultFormat ()
	The format used for serialization/deserialization by default by this ContentHandler.

	getDeletionUpdates (Title $title, $role)
	Returns a list of DeferrableUpdate objects for removing information about content in some secondary data store.

	getFieldsForSearchIndex (SearchEngine $engine)
	Get fields definition for search index.

	getJsonFormat ()
	Allow ContentHandler to chose a non-default format for JSON serialization.

	getModelID ()
	Returns the model id that identifies the content model this ContentHandler can handle.

	getPageLanguage (Title $title, ?Content $content=null)
	Get the language in which the content of the given page is written.

	getPageViewLanguage (Title $title, ?Content $content=null)
	Get the language in which the content of this page is written when viewed by user.

	getParserOutput (Content $content, ContentParseParams $cpoParams)
	Returns a ParserOutput object containing information derived from this content.

	getParserOutputForIndexing (WikiPage $page, ?ParserCache $cache=null, ?RevisionRecord $revision=null)
	Produce page output suitable for indexing.

	getSecondaryDataUpdates (Title $title, Content $content, $role, SlotRenderingProvider $slotOutput)
	Returns a list of DeferrableUpdate objects for recording information about the given Content in some secondary data store.

	getSlotDiffRenderer (IContextSource $context, array $options=[])
	Get an appropriate SlotDiffRenderer for this content model.

	getSupportedFormats ()
	Returns a list of serialization formats supported by the serializeContent() and unserializeContent() methods of this ContentHandler.

	getUndoContent (Content $currentContent, Content $undoContent, Content $undoAfterContent, $undoIsLatest=false)
	Get the Content object that needs to be saved in order to undo all changes between $undo and $undoafter.

	importTransform ( $blob, $format=null)
	Apply import transformation (by default, returns $blob unchanged).

	isParserCacheSupported ()
	Returns true for content models that support caching using the ParserCache mechanism.

	isSupportedFormat ( $format)
	Returns true if $format is a serialization format supported by this ContentHandler, and false otherwise.

	makeEmptyContent ()
	Creates an empty Content object of the type supported by this ContentHandler.

	makeRedirectContent (Title $destination, $text='')
	Creates a new Content object that acts as a redirect to the given page, or null if redirects are not supported by this content model.

	merge3 (Content $oldContent, Content $myContent, Content $yourContent)
	Attempts to merge differences between three versions.

	preloadTransform (Content $content, PreloadTransformParams $pltParams)
	Returns a $content object with preload transformations applied (or the same object if no transformations apply).

	preSaveTransform (Content $content, PreSaveTransformParams $pstParams)
	Returns a $content object with pre-save transformations applied (or the same object if no transformations apply).

	serializeContent (Content $content, $format=null)
	Serializes a Content object of the type supported by this ContentHandler.

	serializeContentToJsonArray (Content $content)
	Serializes a Content object of the type supported by this ContentHandler to an array which is JsonCodecable.

	supportsCategories ()
	Returns true if this content model supports categories.

	supportsDirectApiEditing ()
	Whether or not this content model supports direct editing via ApiEditPage.

	supportsDirectEditing ()
	Return true if this content model supports direct editing, such as via EditPage.

	supportsPreloadContent ()
	If a non-existing page can be created with the contents from another (arbitrary) page being preloaded in the editor, see {.

	supportsRedirects ()
	Returns true if this content model supports redirects.

	supportsSections ()
	Returns true if this content model supports sections.

	unserializeContent ( $blob, $format=null)
	Unserializes a Content object of the type supported by this ContentHandler.

	validateSave (Content $content, ValidationParams $validationParams)
	Validate content for saving it.

Static Public Member Functions
static	getLocalizedName ( $name, ?Language $lang=null)
	Returns the localized name for a given content model.

static	makeContent ( $text, ?Title $title=null, $modelId=null, $format=null)
	Convenience function for creating a Content object from a given textual representation.

Protected Member Functions
	addSearchField (&$fields, SearchEngine $engine, $name, $type)
	Add new field definition to array.

	checkFormat ( $format)
	Convenient for checking whether a format provided as a parameter is actually supported.

	checkModelID ( $model_id)

	createTextSlotDiffRenderer (array $options=[])
	Create a TextSlotDiffRenderer and inject dependencies.

	fillParserOutput (Content $content, ContentParseParams $cpoParams, ParserOutput &$output)
	Fills the provided ParserOutput with information derived from the content.

	getDiffEngineClass ()
	Returns the name of the diff engine to use.

	getSlotDiffRendererInternal (IContextSource $context)
	Return the SlotDiffRenderer appropriate for this content handler.

	getSlotDiffRendererWithOptions (IContextSource $context, $options=[])
	Return the SlotDiffRenderer appropriate for this content handler.

	latestRevision (WikiPage $page)
	Get the latest revision of the given $page, fetching it from the primary if necessary.

Protected Attributes
string	$mModelID

string[]	$mSupportedFormats

Detailed Description

Base class for content handling.

A content handler knows how do deal with a specific type of content on a wiki page. Content is stored in the database in a serialized form (using a serialization format a.k.a. MIME type) and is unserialized into its native PHP representation (the content model), which is wrapped in an instance of the appropriate subclass of Content.

ContentHandler instances are stateless singletons that serve, among other things, as a factory for Content objects. Generally, there is one subclass of ContentHandler and one subclass of Content for every type of content model.

Some content types have a flat model, that is, their native representation is the same as their serialized form. Examples would be JavaScript and CSS code. As of now, this also applies to wikitext (MediaWiki's default content type), but wikitext content may be represented by a DOM or AST structure in the future.

Stability: stable: to extend

Since: 1.21

Author: Daniel Kinzler

Definition at line 76 of file ContentHandler.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Content\ContentHandler::__construct	(		$modelId,
			$formats )

Constructor, initializing the ContentHandler instance with its model ID and a list of supported formats.

Values for the parameters are typically provided as literals by subclass's constructors.

Stability: stable: to call

Parameters

string	$modelId	(use CONTENT_MODEL_XXX constants).
string[]	$formats	List for supported serialization formats (typically as MIME types)

Reimplemented in MediaWiki\Content\FallbackContentHandler, and MediaWiki\Content\TextContentHandler.

Definition at line 163 of file ContentHandler.php.

Member Function Documentation

◆ addSearchField()

MediaWiki\Content\ContentHandler::addSearchField	(	&	$fields,
		SearchEngine	$engine,
			$name,
			$type )

protected

Add new field definition to array.

Parameters

SearchIndexField[]	&$fields
SearchEngine	$engine
string	$name
string	$type

Returns: SearchIndexField[] new field defs

Since: 1.28

Definition at line 1238 of file ContentHandler.php.

References MediaWiki\Search\SearchEngine\makeSearchFieldMapping().

◆ canBeUsedOn()

MediaWiki\Content\ContentHandler::canBeUsedOn ( Title $title )

Determines whether the content type handled by this ContentHandler can be used for the main slot of the given page.

This default implementation always returns true. Subclasses may override this to restrict the use of this content model to specific locations, typically based on the namespace or some other aspect of the title, such as a special suffix (e.g. ".svg" for SVG content).

Note: this calls the ContentHandlerCanBeUsedOn hook which may be used to override which content model can be used where.

Stability: stable: to override

See also: SlotRoleHandler::isAllowedModel

Parameters

Title $title The page's title.

Returns: bool True if content of this kind can be used on the given page, false otherwise.

Definition at line 673 of file ContentHandler.php.

◆ checkFormat()

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

protected

Convenient for checking whether a format provided as a parameter is actually supported.

Parameters

string $format The serialization format to check

Exceptions

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

Definition at line 391 of file ContentHandler.php.

Referenced by MediaWiki\Content\TextContentHandler\serializeContent(), and MediaWiki\Content\TextContentHandler\unserializeContent().

◆ checkModelID()

MediaWiki\Content\ContentHandler::checkModelID ( $model_id )

protected

Since: 1.21

Parameters

string $model_id The model to check

Exceptions

MWException If the provided model ID differs from this ContentHandler

Definition at line 316 of file ContentHandler.php.

Referenced by MediaWiki\Content\TextContentHandler\merge3().

◆ createDifferenceEngine()

MediaWiki\Content\ContentHandler::createDifferenceEngine	(	IContextSource	$context,
			$old = 0,
			$new = 0,
			$rcid = 0,
			$refreshCache = false,
			$unhide = false )

Factory for creating an appropriate DifferenceEngine for this content model.

Since 1.32, this is only used for page-level diffs; to diff two content objects, use getSlotDiffRenderer.

The DifferenceEngine subclass to use is selected in getDiffEngineClass(). The GetDifferenceEngine hook will receive the DifferenceEngine object and can replace or wrap it. (Note that in older versions of MediaWiki the hook documentation instructed extensions to return false from the hook; you should not rely on always being able to decorate the DifferenceEngine instance from the hook. If the owner of the content type wants to decorate the instance, overriding this method is a safer approach.)

Todo: This is page-level functionality so it should not belong to ContentHandler. Move it to a better place once one exists (e.g. PageTypeHandler).

Since: 1.21

Parameters

IContextSource	$context	Context to use, anything else will be ignored.
int	$old	Revision ID we want to show and diff with.
int \| string	$new	Either a revision ID or one of the strings 'cur', 'prev' or 'next'.
int	$rcid	FIXME: Deprecated, no longer used. Defaults to 0.
bool	$refreshCache	If set, refreshes the diff cache. Defaults to false.
bool	$unhide	If set, allow viewing deleted revs. Defaults to false.

Returns: DifferenceEngine

Definition at line 450 of file ContentHandler.php.

◆ createTextSlotDiffRenderer()

MediaWiki\Content\ContentHandler::createTextSlotDiffRenderer ( array $options = [] )

finalprotected

Create a TextSlotDiffRenderer and inject dependencies.

Since: 1.41

Parameters

array $options See getSlotDiffRenderer()

Returns: TextSlotDiffRenderer

Definition at line 535 of file ContentHandler.php.

◆ deserializeContentFromJsonArray()

MediaWiki\Content\ContentHandler::deserializeContentFromJsonArray ( array $json )

Deserializes a Content object of the type supported by this ContentHandler from a JsonCodecable array.

Since: 1.45

Parameters

array $json Serialized form of the content

Returns: Content The Content object created by deserializing $blob

Exceptions

JsonException

See also: ContentJsonCodec

Reimplemented in MediaWiki\Content\WikitextContentHandler.

Definition at line 244 of file ContentHandler.php.

◆ exportTransform()

MediaWiki\Content\ContentHandler::exportTransform	(		$blob,
			$format = null )

Applies transformations on export (returns the blob unchanged by default).

Subclasses may override this to perform transformations such as conversion of legacy formats or filtering of internal meta-data.

Stability: stable: to override

Parameters

string	$blob	The blob to be exported
string \| null	$format	The blob's serialization format

Returns: string

Definition at line 213 of file ContentHandler.php.

◆ fillParserOutput()

MediaWiki\Content\ContentHandler::fillParserOutput	(	Content	$content,
		ContentParseParams	$cpoParams,
		ParserOutput &	$output )

protected

Fills the provided ParserOutput with information derived from the content.

Unless $cpoParams->getGenerateHtml() was false, this includes an HTML representation of the content.

If $cpoParams->getGenerateHtml() is false, and you chose not to generate html, the ParserOutput must have a text of null. If the text of the ParserOutput object is anything other than null (even if ''), it is assumed that you don't support not generating html, and that it is safe to reuse the parser output for calls expecting that html was generated.

Subclasses are expected to override this method.

This placeholder implementation always throws an exception.

Stability: stable: to override

Since: 1.38

Parameters

Content	$content
ContentParseParams	$cpoParams
ParserOutput	&$output	The output object to fill (reference). Most implementations should modify the output object passed in here; if you choose to replace it with a fresh object instead, make sure you call `ParserOutput::resetParseStartTime()` on it.

Reimplemented in MediaWiki\Content\CssContentHandler, MediaWiki\Content\FallbackContentHandler, MediaWiki\Content\JavaScriptContentHandler, MediaWiki\Content\TextContentHandler, MediaWiki\Content\VueContentHandler, MediaWiki\Content\JsonContentHandler, and MediaWiki\Content\WikitextContentHandler.

Definition at line 1642 of file ContentHandler.php.

◆ fillParserOutputInternal()

MediaWiki\Content\ContentHandler::fillParserOutputInternal	(	Content	$content,
		ContentParseParams	$cpoParams,
		ParserOutput &	$output )

A temporary layer to move AbstractContent::fillParserOutput to ContentHandler::fillParserOutput.

Access: internal: only core AbstractContent::fillParserOutput implementations need to call this.

Since: 1.38

Parameters

Content	$content
ContentParseParams	$cpoParams
ParserOutput	&$output	The output object to fill (reference).

Definition at line 1609 of file ContentHandler.php.

◆ generateHTMLOnEdit()

MediaWiki\Content\ContentHandler::generateHTMLOnEdit ( )

Whether an edit on the content should trigger an HTML render and ParserCache entry.

Stability: stable: to override

Since: 1.37

Returns: bool true if edit should trigger an HTML render false otherwise

Definition at line 1170 of file ContentHandler.php.

◆ getActionOverrides()

MediaWiki\Content\ContentHandler::getActionOverrides ( )

Returns overrides for action handlers.

Classes listed here will be used instead of the default one when (and only when) $wgActions[$action] === true. This allows subclasses to override the default action handlers.

Stability: stable: to override

Since: 1.21

Returns: array<string,class-string|callable|false|Action|array> An array mapping action names (typically "view", "edit", "history" etc.) to a specification according to {

See also: ActionFactory::getActionSpec}. Can be the full qualified class name of an Action class, a callable taking ( Article $article, IContextSource $context ) as parameters and returning an Action object, false to disable an action, an actual Action object, or an ObjectFactory specification array (can have 'class', 'services', etc.). An empty array in this default implementation.; Action::factory

Definition at line 419 of file ContentHandler.php.

◆ getAutoDeleteReason()

MediaWiki\Content\ContentHandler::getAutoDeleteReason	(	Title	$title,
		&	$hasHistory = false )

Auto-generates a deletion reason.

Stability: stable: to override

Since: 1.21

Parameters

Title	$title	The page's title
bool	&$hasHistory	Whether the page has a history

Returns: string|false String containing deletion reason or empty string, or boolean false if no revision occurred

Definition at line 927 of file ContentHandler.php.

References MediaWiki\Title\Title\getArticleID(), wfDeprecated(), and wfMessage().

◆ getAutosummary()

MediaWiki\Content\ContentHandler::getAutosummary	(	?Content	$oldContent = null,
		?Content	$newContent = null,
			$flags = 0 )

Return an applicable auto-summary if one exists for the given edit.

Stability: stable: to override

Since: 1.21

Parameters

Content \| null	$oldContent	The previous text of the page.
Content \| null	$newContent	The submitted text of the page.
int	$flags	Bit mask: a bit mask of flags submitted for the edit.

Returns: string An appropriate auto-summary, or an empty string.

Definition at line 802 of file ContentHandler.php.

References wfMessage().

◆ getChangeTag()

MediaWiki\Content\ContentHandler::getChangeTag	(	?Content	$oldContent = null,
		?Content	$newContent = null,
			$flags = 0 )

Return an applicable tag if one exists for the given edit or return null.

Stability: stable: to override

Since: 1.31

Parameters

Content \| null	$oldContent	The previous text of the page.
Content \| null	$newContent	The submitted text of the page.
int	$flags	Bit mask: a bit mask of flags submitted for the edit.

Returns: string|null An appropriate tag, or null.

Definition at line 890 of file ContentHandler.php.

◆ getDataForSearchIndex()

MediaWiki\Content\ContentHandler::getDataForSearchIndex	(	WikiPage	$page,
		ParserOutput	$output,
		SearchEngine	$engine,
		?RevisionRecord	$revision = null )

Return fields to be indexed by search engine as representation of this document.

Overriding class should call parent function or take care of calling the SearchDataForIndex hook.

The $output must be the result of a call to getParserOutputForIndexing() on the same content handler. That method may return ParserOutput without HTML; this base implementation does not rely on the HTML being present, so it is safe to call even by subclasses that override getParserOutputForIndexing() to skip HTML generation. On the other hand, since the default implementation of getParserOutputForIndexing() does generate HTML, subclasses are free to rely on the HTML here if they do not override getParserOutputForIndexing().

Stability: stable: to override

Parameters

WikiPage	$page	Page to index
ParserOutput	$output
SearchEngine	$engine	Search engine for which we are indexing
RevisionRecord \| null	$revision	Revision content to fetch if provided or use the latest revision from WikiPage::getRevisionRecord() if not

Returns: array Map of name=>value for fields, an empty array is returned if the latest revision cannot be retrieved.

Since: 1.28

Reimplemented in MediaWiki\Content\TextContentHandler, MediaWiki\Content\FileContentHandler, and MediaWiki\Content\WikitextContentHandler.

Definition at line 1269 of file ContentHandler.php.

References MediaWiki\Page\WikiPage\getId(), and MediaWiki\Page\WikiPage\getRevisionRecord().

◆ getDefaultFormat()

MediaWiki\Content\ContentHandler::getDefaultFormat ( )

The format used for serialization/deserialization by default by this ContentHandler.

This default implementation will return the first element of the array of formats that was passed to the constructor.

Stability: stable: to override

Since: 1.21

Returns: string The name of the default serialization format as a MIME type

Definition at line 348 of file ContentHandler.php.

Referenced by MediaWiki\Content\TextContentHandler\merge3().

◆ getDeletionUpdates()

MediaWiki\Content\ContentHandler::getDeletionUpdates	(	Title	$title,
			$role )

Returns a list of DeferrableUpdate objects for removing information about content in some secondary data store.

This is used when a page is deleted, and also when a slot is removed from a page.

Application logic should not call this method directly. Instead, it should call WikiPage::getSecondaryDataUpdates().

Note: Implementations must not return a LinksDeletionUpdate instance. Instead, a LinksDeletionUpdate is created by the calling code in WikiPage. This is in contrast to the old getDeletionUpdates method defined by AbstractContent, which returned a LinksUpdate.; Implementations should not rely on the page's current content, but rather the current state of the secondary data store.

Stability: stable: to override

Parameters

Title	$title	The title of the page to supply the updates for
string	$role	The role (slot) in which the content is being used. Which updates are performed should generally not depend on the role the content has, but the DeferrableUpdates themselves may need to know the role, to track to which slot the data refers, and to avoid overwriting data of the same kind from another slot.

Returns: DeferrableUpdate[] A list of DeferrableUpdate objects for putting information about this content object somewhere. The default implementation returns an empty array.

Since: 1.32

Definition at line 1445 of file ContentHandler.php.

◆ getDiffEngineClass()

MediaWiki\Content\ContentHandler::getDiffEngineClass ( )

protected

Returns the name of the diff engine to use.

Stability: stable: to override

Since: 1.21

Returns: class-string<DifferenceEngine>

Definition at line 689 of file ContentHandler.php.

◆ getFieldsForSearchIndex()

MediaWiki\Content\ContentHandler::getFieldsForSearchIndex ( SearchEngine $engine )

Get fields definition for search index.

Todo: Expose title, redirect, namespace, text, source_text, text_bytes field mappings here. (see T142670 and T143409)

Stability: stable: to override

Parameters

SearchEngine $engine

Returns: SearchIndexField[] List of fields this content handler can provide.

Since: 1.28

Reimplemented in MediaWiki\Content\FileContentHandler, MediaWiki\Content\TextContentHandler, and MediaWiki\Content\WikitextContentHandler.

Definition at line 1197 of file ContentHandler.php.

References MediaWiki\Search\SearchEngine\makeSearchFieldMapping().

◆ getJsonFormat()

MediaWiki\Content\ContentHandler::getJsonFormat ( )

Allow ContentHandler to chose a non-default format for JSON serialization.

In most cases will return the same as ::getDefaultFormat().

Definition at line 358 of file ContentHandler.php.

◆ getLocalizedName()

static MediaWiki\Content\ContentHandler::getLocalizedName	(		$name,
		?Language	$lang = null )

static

Returns the localized name for a given content model.

Model names are localized using system messages. Message keys have the form content-model-$name, where $name is getContentModelName( $id ).

Parameters

string	$name	The content model ID, as given by a CONTENT_MODEL_XXX constant or returned by Content::getModel() or SlotRecord::getModel().
Language \| null	$lang	The language to parse the message in (since 1.26)

Returns: string The content model's localized name.

Definition at line 126 of file ContentHandler.php.

References wfMessage().

◆ getModelID()

MediaWiki\Content\ContentHandler::getModelID ( )

Returns the model id that identifies the content model this ContentHandler can handle.

Use with the CONTENT_MODEL_XXX constants.

Since: 1.21

Returns: string The model ID

Definition at line 307 of file ContentHandler.php.

Referenced by MediaWiki\Content\FallbackContentHandler\unserializeContent().

◆ getPageLanguage()

MediaWiki\Content\ContentHandler::getPageLanguage	(	Title	$title,
		?Content	$content = null )

Get the language in which the content of the given page is written.

This default implementation just returns the content language (except for pages in the MediaWiki namespace)

Note that the page's language is not cacheable, since it may in some cases depend on user settings.

Also note that the page language may or may not depend on the actual content of the page, that is, this method may load the content in order to determine the language.

Stability: stable: to override

Since: 1.21

Parameters

Title	$title	The page to determine the language for.
Content \| null	$content	The page's content, if you have it handy, to avoid reloading it.

Returns: Language

Reimplemented in MediaWiki\Content\CodeContentHandler.

Definition at line 596 of file ContentHandler.php.

References MediaWiki\Title\Title\getText(), MediaWiki\Title\Title\inNamespace(), and NS_MEDIAWIKI.

Referenced by MediaWiki\Content\TextContentHandler\getDataForSearchIndex().

◆ getPageViewLanguage()

MediaWiki\Content\ContentHandler::getPageViewLanguage	(	Title	$title,
		?Content	$content = null )

Get the language in which the content of this page is written when viewed by user.

Defaults to $this->getPageLanguage(), but if the user specified a preferred variant, the variant will be used.

This default implementation just returns $this->getPageLanguage( $title, $content ) unless the user specified a preferred variant.

Note that the pages view language is not cacheable, since it depends on user settings.

Also note that the page language may or may not depend on the actual content of the page, that is, this method may load the content in order to determine the language.

Stability: stable: to override

Deprecated: since 1.42 Use ParserOutput::getLanguage instead. See also OutputPage::getContLangForJS.

Since: 1.21

Parameters

Title	$title	The page to determine the language for.
Content \| null	$content	The page's content, if you have it handy, to avoid reloading it.

Returns: Language The page's language for viewing

Reimplemented in MediaWiki\Content\CodeContentHandler.

Definition at line 637 of file ContentHandler.php.

References MediaWiki\Title\Title\getNamespace(), and NS_MEDIAWIKI.

◆ getParserOutput()

MediaWiki\Content\ContentHandler::getParserOutput	(	Content	$content,
		ContentParseParams	$cpoParams )

Returns a ParserOutput object containing information derived from this content.

Most importantly, unless $cpoParams->getGenerateHtml was false, the return value contains an HTML representation of the content.

Subclasses that want to control the parser output may override fillParserOutput() instead.

Since: 1.38

Parameters

Content	$content
ContentParseParams	$cpoParams

Returns: ParserOutput Containing information derived from this content.

Definition at line 1536 of file ContentHandler.php.

References MediaWiki\Content\Renderer\ContentParseParams\getGenerateHtml(), MediaWiki\Content\Renderer\ContentParseParams\getPage(), MediaWiki\Content\Renderer\ContentParseParams\getParserOptions(), MediaWiki\Content\Content\getRedirectTarget(), and MediaWiki\Content\Renderer\ContentParseParams\getRevId().

◆ getParserOutputForIndexing()

MediaWiki\Content\ContentHandler::getParserOutputForIndexing	(	WikiPage	$page,
		?ParserCache	$cache = null,
		?RevisionRecord	$revision = null )

Produce page output suitable for indexing.

Typically used with getDataForSearchIndex().

Specific content handlers may override it if they need different content handling.

The default implementation returns output with HTML, but callers should not rely on this, and subclasses may override this method and skip HTML generation if it is not needed for indexing. (In that case, they should not attempt to store the output in the $cache.)

Stability: stable: to override

Parameters

WikiPage	$page
ParserCache \| null	$cache	deprecated since 1.38 and won't have any effect
RevisionRecord \| null	$revision

Returns: ParserOutput|null null when the ParserOutput cannot be obtained

See also: ParserOutputAccess::getParserOutput() for failure modes

Definition at line 1331 of file ContentHandler.php.

References MediaWiki\Page\WikiPage\makeParserOptions().

◆ getSecondaryDataUpdates()

MediaWiki\Content\ContentHandler::getSecondaryDataUpdates	(	Title	$title,
		Content	$content,
			$role,
		SlotRenderingProvider	$slotOutput )

Returns a list of DeferrableUpdate objects for recording information about the given Content in some secondary data store.

Application logic should not call this method directly. Instead, it should call DerivedPageDataUpdater::getSecondaryDataUpdates().

Note: Implementations must not return a LinksUpdate instance. Instead, a LinksUpdate is created by the calling code in DerivedPageDataUpdater, on the combined ParserOutput of all slots, not for each slot individually. This is in contrast to the old getSecondaryDataUpdates method defined by AbstractContent, which returned a LinksUpdate.; Implementations should not call $content->getParserOutput, they should call $slotOutput->getSlotRendering( $role, false ) instead if they need to access a ParserOutput of $content. This allows existing ParserOutput objects to be re-used, while avoiding creating a ParserOutput when none is needed.

Stability: stable: to override

Parameters

Title	$title	The title of the page to supply the updates for
Content	$content	The content to generate data updates for.
string	$role	The role (slot) in which the content is being used. Which updates are performed should generally not depend on the role the content has, but the DeferrableUpdates themselves may need to know the role, to track to which slot the data refers, and to avoid overwriting data of the same kind from another slot.
SlotRenderingProvider	$slotOutput	A provider that can be used to gain access to a ParserOutput of $content by calling $slotOutput->getSlotParserOutput( $role, false ).

Returns: DeferrableUpdate[] A list of DeferrableUpdate objects for putting information about this content object somewhere. The default implementation returns an empty array.

Since: 1.32

Definition at line 1406 of file ContentHandler.php.

◆ getSlotDiffRenderer()

MediaWiki\Content\ContentHandler::getSlotDiffRenderer	(	IContextSource	$context,
		array	$options = [] )

final

Get an appropriate SlotDiffRenderer for this content model.

Stability: stable: to override

Since: 1.32

Parameters

IContextSource	$context
array	$options	An associative array of options passed to the SlotDiffRenderer: diff-type: (string) The text diff format contentLanguage: (string) The language code of the content language, to be passed to the TextDiffer constructor. This is ignored if a TextDiffer object is provided. textDiffer: (TextDiffer) A TextDiffer object to use for text comparison.

Returns: SlotDiffRenderer

Definition at line 477 of file ContentHandler.php.

◆ getSlotDiffRendererInternal()

MediaWiki\Content\ContentHandler::getSlotDiffRendererInternal ( IContextSource $context )

protected

Return the SlotDiffRenderer appropriate for this content handler.

Deprecated: since 1.35; use getSlotDiffRendererWithOptions instead Emitting deprecation warnings since 1.41.

Parameters

IContextSource $context

Returns: SlotDiffRenderer|null

Definition at line 504 of file ContentHandler.php.

◆ getSlotDiffRendererWithOptions()

MediaWiki\Content\ContentHandler::getSlotDiffRendererWithOptions	(	IContextSource	$context,
			$options = [] )

protected

Return the SlotDiffRenderer appropriate for this content handler.

Stability: stable: to override

Parameters

IContextSource	$context
array	$options	See getSlotDiffRenderer()

Returns: SlotDiffRenderer

Reimplemented in MediaWiki\Content\FallbackContentHandler.

Definition at line 517 of file ContentHandler.php.

References wfDeprecated().

◆ getSupportedFormats()

MediaWiki\Content\ContentHandler::getSupportedFormats ( )

Returns a list of serialization formats supported by the serializeContent() and unserializeContent() methods of this ContentHandler.

Stability: stable: to override

Since: 1.21

Returns: string[] List of serialization formats as MIME type like strings

Definition at line 333 of file ContentHandler.php.

◆ getUndoContent()

MediaWiki\Content\ContentHandler::getUndoContent	(	Content	$currentContent,
		Content	$undoContent,
		Content	$undoAfterContent,
			$undoIsLatest = false )

Get the Content object that needs to be saved in order to undo all changes between $undo and $undoafter.

Stability: stable: to override

Since: 1.21; 1.32 accepts Content objects for all parameters instead of Revision objects. Passing Revision objects is deprecated.; 1.37 only accepts Content objects

Parameters

Content	$currentContent	The current text
Content	$undoContent	The content of the revision to undo
Content	$undoAfterContent	Must be from an earlier revision than $undo
bool	$undoIsLatest	Set true if $undo is from the current revision (since 1.32)

Returns: Content|false Content on success, false on failure

Definition at line 1048 of file ContentHandler.php.

References MediaWiki\Content\Content\equals(), and MediaWiki\Content\Content\getModel().

◆ importTransform()

MediaWiki\Content\ContentHandler::importTransform	(		$blob,
			$format = null )

Apply import transformation (by default, returns $blob unchanged).

This gives subclasses an opportunity to transform data blobs on import.

Stability: stable: to override

Since: 1.24

Parameters

string	$blob
string \| null	$format

Returns: string

Definition at line 264 of file ContentHandler.php.

◆ isParserCacheSupported()

MediaWiki\Content\ContentHandler::isParserCacheSupported ( )

Returns true for content models that support caching using the ParserCache mechanism.

See WikiPage::shouldCheckParserCache().

Stability: stable: to override

Since: 1.21

Returns: bool Always false.

Reimplemented in MediaWiki\Content\WikitextContentHandler.

Definition at line 1089 of file ContentHandler.php.

◆ isSupportedFormat()

MediaWiki\Content\ContentHandler::isSupportedFormat ( $format )

Returns true if $format is a serialization format supported by this ContentHandler, and false otherwise.

Note that if $format is null, this method always returns true, because null means "use the default format".

Stability: stable: to override

Since: 1.21

Parameters

string $format The serialization format to check

Returns: bool

Definition at line 376 of file ContentHandler.php.

◆ latestRevision()

MediaWiki\Content\ContentHandler::latestRevision ( WikiPage $page )

protected

Get the latest revision of the given $page, fetching it from the primary if necessary.

Parameters

WikiPage $page

Returns: RevisionRecord

Since: 1.36 (previously private)

Definition at line 1357 of file ContentHandler.php.

References MediaWiki\Page\WikiPage\getRevisionRecord(), MediaWiki\Page\WikiPage\getTitle(), and MediaWiki\Page\WikiPage\loadPageData().

◆ makeContent()

static MediaWiki\Content\ContentHandler::makeContent	(		$text,
		?Title	$title = null,
			$modelId = null,
			$format = null )

static

Convenience function for creating a Content object from a given textual representation.

$text will be deserialized into a Content object of the model specified by $modelId (or, if that is not given, $title->getContentModel()) using the given format.

Since: 1.21

Parameters

string	$text	The textual representation, will be unserialized to create the Content object
Title \| null	$title	The title of the page this text belongs to. Required if $modelId is not provided.
string \| null	$modelId	The model to deserialize to. If not provided, $title->getContentModel() is used.
string \| null	$format	The format to use for deserialization. If not given, the model's default format is used.

Exceptions

MWContentSerializationException
MWUnknownContentModelException

Returns: Content A Content object representing the text.

Definition at line 102 of file ContentHandler.php.

References MediaWiki\MediaWikiServices\getInstance().

◆ makeEmptyContent()

MediaWiki\Content\ContentHandler::makeEmptyContent ( )

abstract

Creates an empty Content object of the type supported by this ContentHandler.

Stability: stable: to override

Since: 1.21

Returns: Content

Reimplemented in MediaWiki\Content\FallbackContentHandler, MediaWiki\Content\JsonContentHandler, MediaWiki\Content\TextContentHandler, and MediaWiki\Content\VueContentHandler.

◆ makeRedirectContent()

MediaWiki\Content\ContentHandler::makeRedirectContent	(	Title	$destination,
			$text = '' )

Creates a new Content object that acts as a redirect to the given page, or null if redirects are not supported by this content model.

This default implementation always returns null. Subclasses supporting redirects must override this method.

Note that subclasses that override this method to return a Content object should also override supportsRedirects() to return true.

Stability: stable: to override

Since: 1.21

Parameters

Title	$destination	The page to redirect to.
string	$text	Text to include in the redirect, if possible.

Returns: Content|null Always null.

Reimplemented in MediaWiki\Content\CssContentHandler, MediaWiki\Content\JavaScriptContentHandler, and MediaWiki\Content\WikitextContentHandler.

Definition at line 296 of file ContentHandler.php.

◆ merge3()

MediaWiki\Content\ContentHandler::merge3	(	Content	$oldContent,
		Content	$myContent,
		Content	$yourContent )

Attempts to merge differences between three versions.

Returns a new Content object for a clean merge and false for failure or a conflict.

This default implementation always returns false.

Stability: stable: to override

Since: 1.21

Parameters

Content	$oldContent	The page's previous content.
Content	$myContent	One of the page's conflicting contents.
Content	$yourContent	One of the page's conflicting contents.

Returns: Content|false Always false.

Reimplemented in MediaWiki\Content\TextContentHandler.

Definition at line 708 of file ContentHandler.php.

◆ preloadTransform()

MediaWiki\Content\ContentHandler::preloadTransform	(	Content	$content,
		PreloadTransformParams	$pltParams )

Returns a $content object with preload transformations applied (or the same object if no transformations apply).

Note: Not stable to call other then from ContentHandler hierarchy. Callers need to use ContentTransformer::preLoadTransform.

Stability: stable: to override

Since: 1.37

Parameters

Content	$content
PreloadTransformParams	$pltParams

Returns: Content

Reimplemented in MediaWiki\Content\WikitextContentHandler.

Definition at line 1484 of file ContentHandler.php.

◆ preSaveTransform()

MediaWiki\Content\ContentHandler::preSaveTransform	(	Content	$content,
		PreSaveTransformParams	$pstParams )

Returns a $content object with pre-save transformations applied (or the same object if no transformations apply).

Note: Not stable to call other then from ContentHandler hierarchy. Callers need to use ContentTransformer::preSaveTransform.

Stability: stable: to override

Since: 1.37

Parameters

Content	$content
PreSaveTransformParams	$pstParams

Returns: Content

Reimplemented in MediaWiki\Content\CssContentHandler, MediaWiki\Content\JavaScriptContentHandler, MediaWiki\Content\JsonContentHandler, MediaWiki\Content\TextContentHandler, and MediaWiki\Content\WikitextContentHandler.

Definition at line 1463 of file ContentHandler.php.

◆ serializeContent()

MediaWiki\Content\ContentHandler::serializeContent	(	Content	$content,
			$format = null )

abstract

Serializes a Content object of the type supported by this ContentHandler.

Stability: stable: to override

Since: 1.21

Parameters

Content	$content	The Content object to serialize
string \| null	$format	The desired serialization format

Returns: string Serialized form of the content

Reimplemented in MediaWiki\Content\FallbackContentHandler, MediaWiki\Content\TextContentHandler, and MediaWiki\Content\WikitextContentHandler.

◆ serializeContentToJsonArray()

MediaWiki\Content\ContentHandler::serializeContentToJsonArray ( Content $content )

Serializes a Content object of the type supported by this ContentHandler to an array which is JsonCodecable.

Since: 1.45

Parameters

Content $content The Content object to serialize

Returns: array An array of JsonCodecable content

Reimplemented in MediaWiki\Content\WikitextContentHandler.

Definition at line 192 of file ContentHandler.php.

◆ supportsCategories()

MediaWiki\Content\ContentHandler::supportsCategories ( )

Returns true if this content model supports categories.

The default implementation returns true.

Stability: stable: to override

Returns: bool Always true.

Definition at line 1116 of file ContentHandler.php.

◆ supportsDirectApiEditing()

MediaWiki\Content\ContentHandler::supportsDirectApiEditing ( )

Whether or not this content model supports direct editing via ApiEditPage.

Stability: stable: to override

Returns: bool Default is false, and true for TextContent and derivatives.

Definition at line 1181 of file ContentHandler.php.

◆ supportsDirectEditing()

MediaWiki\Content\ContentHandler::supportsDirectEditing ( )

Return true if this content model supports direct editing, such as via EditPage.

This should return true for TextContent and its derivatives, and return false for structured data content.

Stability: stable: to override

Returns: bool Default is false.

Reimplemented in MediaWiki\Content\FallbackContentHandler, and MediaWiki\Content\TextContentHandler.

Definition at line 1144 of file ContentHandler.php.

◆ supportsPreloadContent()

MediaWiki\Content\ContentHandler::supportsPreloadContent ( )

If a non-existing page can be created with the contents from another (arbitrary) page being preloaded in the editor, see {.

See also: EditPage::getContentObject}. Only makes sense together with {; supportsDirectEditing}.

Stability: stable: to override

Since: 1.39

Returns: bool

Reimplemented in MediaWiki\Content\JsonContentHandler, and MediaWiki\Content\WikitextContentHandler.

Definition at line 1158 of file ContentHandler.php.

◆ supportsRedirects()

MediaWiki\Content\ContentHandler::supportsRedirects ( )

Returns true if this content model supports redirects.

This default implementation returns false.

Content models that return true here should also implement ContentHandler::makeRedirectContent to return a Content object.

Stability: stable: to override

Returns: bool Always false.

Reimplemented in MediaWiki\Content\CssContentHandler, MediaWiki\Content\JavaScriptContentHandler, and MediaWiki\Content\WikitextContentHandler.

Definition at line 1131 of file ContentHandler.php.

◆ supportsSections()

MediaWiki\Content\ContentHandler::supportsSections ( )

Returns true if this content model supports sections.

This default implementation returns false.

Content models that return true here should also implement Content::getSection, Content::replaceSection, etc. to handle sections.

Stability: stable: to override

Returns: bool Always false.

Reimplemented in MediaWiki\Content\WikitextContentHandler.

Definition at line 1104 of file ContentHandler.php.

◆ unserializeContent()

MediaWiki\Content\ContentHandler::unserializeContent	(		$blob,
			$format = null )

abstract

Unserializes a Content object of the type supported by this ContentHandler.

Stability: stable: to override

Since: 1.21

Parameters

string	$blob	Serialized form of the content
string \| null	$format	The format used for serialization

Returns: Content The Content object created by deserializing $blob

Exceptions

MWContentSerializationException

See also: ContentJsonCodec

Reimplemented in MediaWiki\Content\FallbackContentHandler, and MediaWiki\Content\TextContentHandler.

◆ validateSave()

MediaWiki\Content\ContentHandler::validateSave	(	Content	$content,
		ValidationParams	$validationParams )

Validate content for saving it.

This may be used to check the content's consistency with global state. This function should NOT write any information to the database.

Note that this method will usually be called inside the same transaction bracket that will be used to save the new revision, so the revision passed in is probably unsaved (has no id) and might belong to unsaved page.

Since: 1.38

Stability: stable: to override

Parameters

Content	$content
ValidationParams	$validationParams

Returns: StatusValue A status object indicating if content can be saved in the given revision.

Reimplemented in MediaWiki\Content\JsonContentHandler, and MediaWiki\Content\VueContentHandler.

Definition at line 1509 of file ContentHandler.php.

References MediaWiki\Content\Content\isValid().

Member Data Documentation

◆ $mModelID

string MediaWiki\Content\ContentHandler::$mModelID

protected

Definition at line 145 of file ContentHandler.php.

◆ $mSupportedFormats

string [] MediaWiki\Content\ContentHandler::$mSupportedFormats

protected

Definition at line 150 of file ContentHandler.php.

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

includes/Content/ContentHandler.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

◆ __construct()

Member Function Documentation

◆ addSearchField()

◆ canBeUsedOn()

◆ checkFormat()

◆ checkModelID()

◆ createDifferenceEngine()

◆ createTextSlotDiffRenderer()

◆ deserializeContentFromJsonArray()

◆ exportTransform()

◆ fillParserOutput()

◆ fillParserOutputInternal()

◆ generateHTMLOnEdit()

◆ getActionOverrides()

◆ getAutoDeleteReason()

◆ getAutosummary()

◆ getChangeTag()

◆ getDataForSearchIndex()

◆ getDefaultFormat()

◆ getDeletionUpdates()

◆ getDiffEngineClass()

◆ getFieldsForSearchIndex()

◆ getJsonFormat()

◆ getLocalizedName()

◆ getModelID()

◆ getPageLanguage()

◆ getPageViewLanguage()

◆ getParserOutput()

◆ getParserOutputForIndexing()

◆ getSecondaryDataUpdates()

◆ getSlotDiffRenderer()

◆ getSlotDiffRendererInternal()

◆ getSlotDiffRendererWithOptions()

◆ getSupportedFormats()

◆ getUndoContent()

◆ importTransform()

◆ isParserCacheSupported()

◆ isSupportedFormat()

◆ latestRevision()

◆ makeContent()

◆ makeEmptyContent()

◆ makeRedirectContent()

◆ merge3()

◆ preloadTransform()

◆ preSaveTransform()

◆ serializeContent()

◆ serializeContentToJsonArray()

◆ supportsCategories()

◆ supportsDirectApiEditing()

◆ supportsDirectEditing()

◆ supportsPreloadContent()

◆ supportsRedirects()

◆ supportsSections()

◆ unserializeContent()

◆ validateSave()

Member Data Documentation

◆ $mModelID

◆ $mSupportedFormats