Content handler for JSON text. More...

Inherits MediaWiki\Content\CodeContentHandler.

Collaboration diagram for MediaWiki\Content\JsonContentHandler:

[legend]

Public Member Functions

__construct (string $modelId=CONTENT_MODEL_JSON, ?ParsoidParserFactory $parsoidParserFactory=null, ?TitleFactory $titleFactory=null)

makeEmptyContent ()

Creates an empty TextContent object.

Since: 1.21

Returns: Content A new TextContent object with empty text.

preSaveTransform (Content $content, PreSaveTransformParams $pstParams)

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

supportsPreloadContent ()

Enables EditPage's preload feature on .json pages as well as for extensions like MassMessage that subclass {.

validateSave (Content $content, ValidationParams $validationParams)

Public Member Functions inherited from MediaWiki\Content\CodeContentHandler

getPageLanguage (Title $title, ?Content $content=null)

Returns the English language, because code is English, and should be handled as such.

getPageViewLanguage (Title $title, ?Content $content=null)

Returns the English language, because code is English, and should be handled as such.

Public Member Functions inherited from MediaWiki\Content\TextContentHandler

__construct ( $modelId=CONTENT_MODEL_TEXT, $formats=[CONTENT_FORMAT_TEXT])

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)

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

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

merge3 (Content $oldContent, Content $myContent, Content $yourContent)

Attempts to merge differences between three versions.

serializeContent (Content $content, $format=null)

Returns the content's text as-is.

supportsDirectEditing ()

unserializeContent ( $text, $format=null)

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

Public Member Functions inherited from 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.

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.

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.

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.

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.

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.

preloadTransform (Content $content, PreloadTransformParams $pltParams)

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

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.

supportsRedirects ()

Returns true if this content model supports redirects.

supportsSections ()

Returns true if this content model supports sections.

Protected Member Functions
	fillParserOutput (Content $content, ContentParseParams $cpoParams, ParserOutput &$parserOutput)
	Set the HTML and add the appropriate styles.

	getContentClass ()

Protected Member Functions inherited from MediaWiki\Content\ContentHandler
	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.

	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.

Additional Inherited Members
Static Public Member Functions inherited from MediaWiki\Content\ContentHandler
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 Attributes inherited from MediaWiki\Content\ContentHandler
string	$mModelID

string[]	$mSupportedFormats

Detailed Description

Content handler for JSON text.

Useful for maintaining JSON that can be viewed and edited directly by users.

Stability: stable: to extend

Since: 1.24

Author: Ori Livneh ori@w.nosp@m.ikim.nosp@m.edia..nosp@m.org; Kunal Mehta legok.nosp@m.tm@g.nosp@m.mail..nosp@m.com

Definition at line 28 of file JsonContentHandler.php.

Constructor & Destructor Documentation

◆ __construct()

MediaWiki\Content\JsonContentHandler::__construct	(	string	$modelId = CONTENT_MODEL_JSON,
		?ParsoidParserFactory	$parsoidParserFactory = null,
		?TitleFactory	$titleFactory = null )