MediaWiki
REL1_24
|
A content handler knows how do deal with a specific type of content on a wiki page. More...
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 on 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). | |
getActionOverrides () | |
Returns overrides for action handlers. | |
getAutoDeleteReason (Title $title, &$hasHistory) | |
Auto-generates a deletion reason. | |
getAutosummary (Content $oldContent=null, Content $newContent=null, $flags) | |
Return an applicable auto-summary if one exists for the given edit. | |
getDefaultFormat () | |
The format used for serialization/deserialization by default by this ContentHandler. | |
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. | |
getSupportedFormats () | |
Returns a list of serialization formats supported by the serializeContent() and unserializeContent() methods of this ContentHandler. | |
getUndoContent (Revision $current, Revision $undo, Revision $undoafter) | |
Get the Content object that needs to be saved in order to undo all revisions between $undo and $undoafter. | |
importTransform ($blob, $format=null) | |
Apply import transformation (per 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. | |
makeParserOptions ($context) | |
Get parser options suitable for rendering and caching the article. | |
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. | |
serializeContent (Content $content, $format=null) | |
Serializes a Content object of the type supported by this ContentHandler. | |
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. | |
Static Public Member Functions | |
static | deprecated ($func, $version, $component=false) |
Logs a deprecation warning, visible if $wgDevelopmentWarnings, but only if self::$enableDeprecationWarnings is set to true. | |
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) |
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. | |
static | runLegacyHooks ($event, $args=array(), $warn=null) |
Call a legacy hook that uses text instead of Content objects. | |
Protected Member Functions | |
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. | |
Protected Attributes | |
string | $mModelID |
string[] | $mSupportedFormats |
Static Protected Attributes | |
static | $enableDeprecationWarnings = false |
Switch for enabling deprecation warnings. | |
static | $handlers |
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.
Definition at line 55 of file ContentHandler.php.
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.
string | $modelId | (use CONTENT_MODEL_XXX constants). |
string[] | $formats List for supported serialization formats (typically as MIME types) |
Reimplemented in TextContentHandler.
Definition at line 410 of file ContentHandler.php.
ContentHandler::canBeUsedOn | ( | Title $ | title | ) |
Determines whether the content type handled by this ContentHandler can be used on 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).
Title | $title | The page's title. |
Definition at line 717 of file ContentHandler.php.
ContentHandler::checkFormat | ( | $ | format | ) | [protected] |
Convenient for checking whether a format provided as a parameter is actually supported.
string | $format | The serialization format to check |
MWException | If the format is not supported by this content handler. |
Definition at line 587 of file ContentHandler.php.
Referenced by TextContentHandler\serializeContent(), and TextContentHandler\unserializeContent().
ContentHandler::checkModelID | ( | $ | model_id | ) | [protected] |
string | $model_id | The model to check |
MWException | If the model ID is not the ID of the content model supported by this ContentHandler. |
Definition at line 523 of file ContentHandler.php.
Referenced by TextContentHandler\merge3().
ContentHandler::createDifferenceEngine | ( | IContextSource $ | context, |
$ | old = 0 , |
||
$ | new = 0 , |
||
$ | rcid = 0 , |
||
$ | refreshCache = false , |
||
$ | unhide = false |
||
) |
Factory for creating an appropriate DifferenceEngine for this content model.
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. |
Definition at line 624 of file ContentHandler.php.
static ContentHandler::deprecated | ( | $ | func, |
$ | version, | ||
$ | component = false |
||
) | [static] |
Logs a deprecation warning, visible if $wgDevelopmentWarnings, but only if self::$enableDeprecationWarnings is set to true.
string | $func | The name of the deprecated function |
string | $version | The version since the method is deprecated. Usually 1.21 for ContentHandler related stuff. |
string | bool | $component | : Component to which the function belongs. If false, it is assumed the function is in MediaWiki core. |
Definition at line 1064 of file ContentHandler.php.
Referenced by DifferenceEngine\generateTextDiffBody(), and WikiPage\getTimestamp().
ContentHandler::exportTransform | ( | $ | blob, |
$ | format = null |
||
) |
Applies transformations on export (returns the blob unchanged per default).
Subclasses may override this to perform transformations such as conversion of legacy formats or filtering of internal meta-data.
string | $blob | The blob to be exported |
string | null | $format | The blob's serialization format |
Definition at line 441 of file ContentHandler.php.
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.
Definition at line 606 of file ContentHandler.php.
static ContentHandler::getAllContentFormats | ( | ) | [static] |
Definition at line 376 of file ContentHandler.php.
References array(), as, getForModelID(), and global.
Referenced by ApiEditPage\getAllowedParams(), and ApiQueryRevisions\getAllowedParams().
ContentHandler::getAutoDeleteReason | ( | Title $ | title, |
&$ | hasHistory | ||
) |
Auto-generates a deletion reason.
Title | $title | The page's title |
bool | &$hasHistory | Whether the page has a history |
Definition at line 847 of file ContentHandler.php.
ContentHandler::getAutosummary | ( | Content $ | oldContent = null , |
Content $ | newContent = null , |
||
$ | flags | ||
) |
Return an applicable auto-summary if one exists for the given edit.
Content | $oldContent | The previous text of the page. |
Content | $newContent | The submitted text of the page. |
int | $flags | Bit mask: a bit mask of flags submitted for the edit. |
Definition at line 765 of file ContentHandler.php.
static ContentHandler::getContentModels | ( | ) | [static] |
Definition at line 370 of file ContentHandler.php.
References global.
Referenced by ApiEditPage\getAllowedParams().
static ContentHandler::getContentText | ( | Content $ | content = null | ) | [static] |
Convenience function for getting flat text from a Content object.
This should only be used in the context of backwards compatibility with code that is not yet able to handle Content objects!
If $content is null, this method returns the empty string.
If $content is an instance of TextContent, this method returns the flat text as returned by $content->getNativeData().
If $content is not a TextContent object, the behavior of this method depends on the global $wgContentHandlerTextFallback:
Content | $content |
MWException | If the content is not an instance of TextContent and wgContentHandlerTextFallback was set to 'fail'. |
Definition at line 94 of file ContentHandler.php.
References $content, global, and wfDebugLog().
Referenced by EditPageTest\assertEdit(), ContentHandlerTest\testGetContentText_NonTextContent_fail(), ContentHandlerTest\testGetContentText_NonTextContent_ignore(), ContentHandlerTest\testGetContentText_NonTextContent_serialize(), ContentHandlerTest\testGetContentText_Null(), and ContentHandlerTest\testGetContentText_TextContent().
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.
Definition at line 555 of file ContentHandler.php.
Referenced by TextContentHandler\merge3().
static ContentHandler::getDefaultModelFor | ( | Title $ | title | ) | [static] |
Returns the name of the default content model to be used for the page with the given title.
Note: There should rarely be need to call this method directly. To determine the actual content model for a given page, use Title::getContentModel().
Which model is to be used by default for the page is determined based on several factors:
If none of the above applies, the wikitext model is used.
Note: this is used by, and may thus not use, Title::getContentModel()
Title | $title |
Definition at line 193 of file ContentHandler.php.
References $ext, array(), Title\getNamespace(), MWNamespace\getNamespaceContentModel(), Title\getText(), and wfRunHooks().
Referenced by ContentHandlerTest\testGetDefaultModelFor(), and WikiPageTest\testIsCountable().
ContentHandler::getDiffEngineClass | ( | ) | [protected] |
Returns the name of the diff engine to use.
Definition at line 732 of file ContentHandler.php.
static ContentHandler::getForContent | ( | Content $ | content | ) | [static] |
Returns the appropriate ContentHandler singleton for the given Content object.
Content | $content |
Definition at line 275 of file ContentHandler.php.
References getForModelID(), and Content\getModel().
static ContentHandler::getForModelID | ( | $ | modelId | ) | [static] |
Returns the ContentHandler singleton for the given model ID.
Use the CONTENT_MODEL_XXX constants to identify the desired content model.
ContentHandler singletons are taken from the global $wgContentHandlers array. Keys in that array are model names, the values are either ContentHandler singleton objects, or strings specifying the appropriate subclass of ContentHandler.
If a class name is encountered when looking up the singleton for a given model name, the class is instantiated and the class name is replaced by the resulting singleton in $wgContentHandlers.
If no ContentHandler is defined for the desired $modelId, the ContentHandler may be provided by the ContentHandlerForModelID hook. If no ContentHandler can be determined, an MWException is raised.
string | $modelId | The ID of the content model for which to get a handler. Use CONTENT_MODEL_XXX constants. |
MWException | If no handler is known for the model ID. |
Definition at line 311 of file ContentHandler.php.
References $handlers, array(), empty, global, wfDebugLog(), and wfRunHooks().
Referenced by TextContent\convert(), ApiEditPage\execute(), ApiQueryRevisions\extractRowInfo(), getAllContentFormats(), getForContent(), getForTitle(), makeContent(), and WikitextContentHandlerTest\setUp().
static ContentHandler::getForTitle | ( | Title $ | title | ) | [static] |
Returns the appropriate ContentHandler singleton for the given title.
Title | $title |
Definition at line 259 of file ContentHandler.php.
References Title\getContentModel(), and getForModelID().
Referenced by CleanupSpam\cleanupArticle(), FeedUtils\formatDiffRow(), ContentHandlerTest\testGetForTitle(), and ContentHandlerTest\testGetPageLanguage().
static ContentHandler::getLocalizedName | ( | $ | name | ) | [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 ).
string | $name | The content model ID, as given by a CONTENT_MODEL_XXX constant or returned by Revision::getContentModel(). |
MWException | If the model ID isn't known. |
Definition at line 360 of file ContentHandler.php.
References $key, $name, and wfMessage().
Referenced by EditPage\initialiseForm(), InfoAction\pageInfo(), and ContentHandlerTest\testGetLocalizedName().
Returns the model id that identifies the content model this ContentHandler can handle.
Use with the CONTENT_MODEL_XXX constants.
Definition at line 511 of file ContentHandler.php.
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 $wgContLang (except for pages in the MediaWiki namespace)
Note that the pages 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.
Title | $title | The page to determine the language for. |
Content | $content | The page's content, if you have it handy, to avoid reloading it. |
Reimplemented in CodeContentHandler.
Definition at line 651 of file ContentHandler.php.
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.
Title | $title | The page to determine the language for. |
Content | $content | The page's content, if you have it handy, to avoid reloading it. |
Reimplemented in CodeContentHandler.
Definition at line 686 of file ContentHandler.php.
Returns a list of serialization formats supported by the serializeContent() and unserializeContent() methods of this ContentHandler.
Definition at line 540 of file ContentHandler.php.
ContentHandler::getUndoContent | ( | Revision $ | current, |
Revision $ | undo, | ||
Revision $ | undoafter | ||
) |
Get the Content object that needs to be saved in order to undo all revisions between $undo and $undoafter.
Revisions must belong to the same page, must exist and must not be deleted.
Revision | $current | The current text |
Revision | $undo | The revision to undo |
Revision | $undoafter | Must be an earlier revision than $undo |
Definition at line 952 of file ContentHandler.php.
ContentHandler::importTransform | ( | $ | blob, |
$ | format = null |
||
) |
Apply import transformation (per default, returns $blob unchanged).
This gives subclasses an opportunity to transform data blobs on import.
string | $blob | |
string | null | $format |
Definition at line 468 of file ContentHandler.php.
Returns true for content models that support caching using the ParserCache mechanism.
See WikiPage::isParserCacheUsed().
Reimplemented in WikitextContentHandler.
Definition at line 1021 of file ContentHandler.php.
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".
string | $format | The serialization format to check |
Definition at line 572 of file ContentHandler.php.
static 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.
string | $text | The textual representation, will be unserialized to create the Content object |
Title | $title | The title of the page this text belongs to. Required if $modelId is not provided. |
string | $modelId | The model to deserialize to. If not provided, $title->getContentModel() is used. |
string | $format | The format to use for deserialization. If not given, the model's default format is used. |
MWException | If model ID or format is not supported or if the text can not be unserialized using the format. |
Definition at line 144 of file ContentHandler.php.
References $title, and getForModelID().
Referenced by ParserTest\addArticle(), EditPageTest\assertEdit(), WikiPageTest\createPage(), RevisionStorageTest\createPage(), DifferenceEngineTest\doEdits(), ApiEditPage\execute(), ImportSiteScripts\execute(), EditCLI\execute(), ApiQueryRevisions\extractRowInfo(), MessageCacheTest\makePage(), RevisionTest\newTestRevision(), RevisionTest\testConstructWithContent(), TextContentTest\testDeletionUpdates(), WikiPageTest\testDoEditContent(), WikiPageTest\testDoQuickEditContent(), ApiEditPageTest\testEditSection(), ContentHandlerTest\testGetAutosummary(), TextContentTest\testGetParserOutput(), WikitextContentTest\testGetSecondaryDataUpdates(), ContentHandlerTest\testMakeContent(), and RefreshLinksPartitionTest\testRefreshLinks().
ContentHandler::makeEmptyContent | ( | ) | [abstract] |
Creates an empty Content object of the type supported by this ContentHandler.
Reimplemented in RevisionTestModifyableContentHandler, DummyContentHandlerForTesting, and TextContentHandler.
ContentHandler::makeParserOptions | ( | $ | context | ) |
Get parser options suitable for rendering and caching the article.
IContextSource | User | string | $context | One of the following:
|
MWException |
Definition at line 994 of file ContentHandler.php.
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.
Title | $destination | The page to redirect to. |
string | $text | Text to include in the redirect, if possible. |
Reimplemented in WikitextContentHandler.
Definition at line 499 of file ContentHandler.php.
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.
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. |
Reimplemented in TextContentHandler.
Definition at line 750 of file ContentHandler.php.
static ContentHandler::runLegacyHooks | ( | $ | event, |
$ | args = array() , |
||
$ | warn = null |
||
) | [static] |
Call a legacy hook that uses text instead of Content objects.
Will log a warning when a matching hook function is registered. If the textual representation of the content is changed by the hook function, a new Content object is constructed from the new text.
string | $event | Event name |
array | $args | Parameters passed to hook functions |
bool | $warn | Whether to log a warning. Default to self::$enableDeprecationWarnings. May be set to false for testing. |
Definition at line 1087 of file ContentHandler.php.
Referenced by EditPage\newSectionSummary(), Article\showCssOrJsPage(), EditPage\showTosSummary(), and ContentHandlerTest\testRunLegacyHooks().
ContentHandler::serializeContent | ( | Content $ | content, |
$ | format = null |
||
) | [abstract] |
Serializes a Content object of the type supported by this ContentHandler.
Content | $content | The Content object to serialize |
string | $format | The desired serialization format |
Reimplemented in DummyContentHandlerForTesting, and TextContentHandler.
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.
Reimplemented in WikitextContentHandler.
Definition at line 1047 of file ContentHandler.php.
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..
Reimplemented in WikitextContentHandler.
Definition at line 1034 of file ContentHandler.php.
ContentHandler::unserializeContent | ( | $ | blob, |
$ | format = null |
||
) | [abstract] |
Unserializes a Content object of the type supported by this ContentHandler.
string | $blob | Serialized form of the content |
string | $format | The format used for serialization |
Reimplemented in RevisionTestModifyableContentHandler, DummyContentHandlerForTesting, and TextContentHandler.
ContentHandler::$enableDeprecationWarnings = false [static, protected] |
Switch for enabling deprecation warnings.
Used by ContentHandler::deprecated() and ContentHandler::runLegacyHooks().
Once the ContentHandler code has settled in a bit, this should be set to true to make extensions etc. show warnings when using deprecated functions and hooks.
Definition at line 63 of file ContentHandler.php.
ContentHandler::$handlers [static, protected] |
Definition at line 284 of file ContentHandler.php.
Referenced by getForModelID().
string ContentHandler::$mModelID [protected] |
Definition at line 395 of file ContentHandler.php.
string [] ContentHandler::$mSupportedFormats [protected] |
Definition at line 399 of file ContentHandler.php.