Content handler for File: files TODO: this handler s not used directly now, but instead manually called by WikitextHandler. More...

Inheritance diagram for FileContentHandler:

[legend]

Collaboration diagram for FileContentHandler:

[legend]

Public Member Functions
	getDataForSearchIndex (WikiPage $page, ParserOutput $parserOutput, SearchEngine $engine)
	Return fields to be indexed by search engine as representation of this document.

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

Public Member Functions inherited from WikitextContentHandler
	__construct ( $modelId=CONTENT_MODEL_WIKITEXT)

	isParserCacheSupported ()
	Returns true, because wikitext supports caching using the ParserCache mechanism.

	makeRedirectContent (Title $destination, $text='')
	Returns a WikitextContent object representing a redirect to the given destination page.

	preloadTransform (Content $content, PreloadTransformParams $pltParams)
	Returns a Content object with preload transformations applied (or this 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)
	Returns the content's text as-is.

	supportsRedirects ()
	Returns true because wikitext supports redirects.

	supportsSections ()
	Returns true because wikitext supports sections.

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

	makeEmptyContent ()
	Creates an empty TextContent object.

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

	supportsDirectEditing ()

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

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

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

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

	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.

	getParserOutputForIndexing (WikiPage $page, ParserCache $cache=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 (per default, returns $blob unchanged).

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

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

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

Additional Inherited Members
Static Public Member Functions inherited from ContentHandler
static	cleanupHandlersCache ()

static	getAllContentFormats ()

static	getContentModels ()

static	getContentText (Content $content=null)
	Convenience function for getting flat text from a Content object.

static	getDefaultModelFor (Title $title)
	Returns the name of the default content model to be used for the page with the given title.

static	getForContent (Content $content)
	Returns the appropriate ContentHandler singleton for the given Content object.

static	getForModelID ( $modelId)
	Returns the ContentHandler singleton for the given model ID.

static	getForTitle (Title $title)
	Returns the appropriate ContentHandler singleton for the given title.

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 inherited from WikitextContentHandler
	getContentClass ()
	Returns the name of the associated Content class, to be used when creating new objects.

	getFileHandler ()

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

	callDeprecatedContentPLT (Content $content, PreloadTransformParams $params)
	If provided content overrides deprecated Content::preloadTransform, call it and return.

	callDeprecatedContentPST (Content $content, PreSaveTransformParams $params)
	Provided content overrides deprecated Content::preSaveTransform, call it and return.

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

	checkModelID ( $model_id)

	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.

	shouldCallDeprecatedContentTransformMethod (Content $content, $params)
	Check if we need to provide content overrides deprecated Content method.

Protected Attributes inherited from ContentHandler
string	$mModelID

string[]	$mSupportedFormats

Detailed Description

Content handler for File: files TODO: this handler s not used directly now, but instead manually called by WikitextHandler.

This should be fixed in the future.

Definition at line 11 of file FileContentHandler.php.

Member Function Documentation

◆ getDataForSearchIndex()

FileContentHandler::getDataForSearchIndex	(	WikiPage	$page,
		ParserOutput	$output,
		SearchEngine	$engine
	)

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