Manual:$wgContentHandlers/zh

<translate> Content Models and Handlers</translate>
<translate> MediaWiki allows for page content types other than wikitext.</translate> <translate> It offers built-in support for JavaScript, CSS, JSON and plain text.</translate> <translate> Extensions can use MediaWiki's ContentHandler mechanism to add new content models for accepting different formats and controlling how they are rendered, stored and edited.</translate>
File:OOjs UI icon information.svg <translate> About</translate>
<translate> About the ContentHandler</translate> <translate> Content handlers and their implementation</translate>
File:Wrench font awesome.svg <translate> Usage</translate>
<translate> Changing the content model of a page</translate> <translate> Changing the content model of a namespace</translate> <translate> Extensions using the ContentHandler</translate> <translate> Adding content models with an extension</translate> <translate> Examples:</translate> includes (<translate> part of <tvar
File:OOjs UI icon advanced.svg <translate> Configuration settings</translate>
$wgContentHandlers $wgNamespaceContentModels $wgContentHandlerTextFallback $wgContentHandlerUseDB
<translate> Support and development</translate> File:Git-logo.svg <translate> Latest technical documentation (Git)</translate> File:Wikimedia Phabricator logo.svg Phabricator
· <span style="" title="<translate nowrap> Edit this template</translate>"><translate> e</translate>

<translate> Content handlers and storage</translate>: $wgContentHandlers
Mapping of content type handlers
<translate> Introduced in version:</translate>	1.21.0
<translate> Removed in version:</translate>	<translate> still in use</translate>
<translate> Allowed values:</translate>	(array of PHP class names)
<translate> Default value:</translate>	（参见下方）
<translate> Other settings:</translate> <translate> Alphabetical</translate> | <translate> By function</translate>

Details

Plugins for page content model handling. Each entry in the array maps a model ID constant to a PHP class name.

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.34</tvar> is unsupported version</translate>">

1.34

<translate> MediaWiki version:</translate>

When undeploying an extension that provides handling for a content model, that content model becomes unsupported, leading to MWUnknownContentModelExceptions to be raised. To avoid this, the content model in question can be defined to use the UnknownContentHandler:

$wgContentHandlers['foo-bar'] = 'UnknownContentHandler';

This allows pages that use the new unsupported content model to still be accessible, even though their content can no longer be shown.

Alternatively, if the content model in question is a text based model, it can be re-defined to be handled as plain text:

$wgContentHandlers['foo-bar'] = 'TextContentHandler';

The content of pages that use this content model remain readable and editable, but lose any special capabilities and markup support.

Default value

<td class="mw-version-versionbox" title="<translate nowrap> The latest stable version is <tvar name=1>1.41</tvar></translate>">

<translate> ≥</translate> 1.41

<translate> MediaWiki version:</translate>

$wgContentHandlers = [
	// the usual case
	CONTENT_MODEL_WIKITEXT => [
		'class' => WikitextContentHandler::class,
		'services' => [
			'TitleFactory',
			'ParserFactory',
			'GlobalIdGenerator',
			'LanguageNameUtils',
			'LinkRenderer',
			'MagicWordFactory',
			'ParsoidParserFactory',
		],
	],
	// dumb version, no syntax highlighting
	CONTENT_MODEL_JAVASCRIPT => JavaScriptContentHandler::class,
	// simple implementation, for use by extensions, etc.
	CONTENT_MODEL_JSON => JsonContentHandler::class,
	// dumb version, no syntax highlighting
	CONTENT_MODEL_CSS => CssContentHandler::class,
	// plain text, for use by extensions, etc.
	CONTENT_MODEL_TEXT => TextContentHandler::class,
	// fallback for unknown models, from imports or extensions that were removed
	CONTENT_MODEL_UNKNOWN => FallbackContentHandler::class,
];

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.40</tvar> is legacy version</translate>">

1.40

<translate> MediaWiki version:</translate>

$wgContentHandlers = [
	// the usual case
	CONTENT_MODEL_WIKITEXT => [
		'class' => WikitextContentHandler::class,
		'services' => [
			'TitleFactory',
			'ParserFactory',
			'GlobalIdGenerator',
			'LanguageNameUtils',
			'MagicWordFactory',
		],
	],
	// dumb version, no syntax highlighting
	CONTENT_MODEL_JAVASCRIPT => JavaScriptContentHandler::class,
	// simple implementation, for use by extensions, etc.
	CONTENT_MODEL_JSON => JsonContentHandler::class,
	// dumb version, no syntax highlighting
	CONTENT_MODEL_CSS => CssContentHandler::class,
	// plain text, for use by extensions, etc.
	CONTENT_MODEL_TEXT => TextContentHandler::class,
	// fallback for unknown models, from imports or extensions that were removed
	CONTENT_MODEL_UNKNOWN => FallbackContentHandler::class,
];

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.39</tvar> is legacy version</translate>">

1.36 – 1.39

<translate> MediaWiki versions:</translate>

$wgContentHandlers = [
	// the usual case
	CONTENT_MODEL_WIKITEXT => WikitextContentHandler::class,
	// dumb version, no syntax highlighting
	CONTENT_MODEL_JAVASCRIPT => JavaScriptContentHandler::class,
	// simple implementation, for use by extensions, etc.
	CONTENT_MODEL_JSON => JsonContentHandler::class,
	// dumb version, no syntax highlighting
	CONTENT_MODEL_CSS => CssContentHandler::class,
	// plain text, for use by extensions, etc.
	CONTENT_MODEL_TEXT => TextContentHandler::class,
	// fallback for unknown models, from imports or extensions that were removed
	CONTENT_MODEL_UNKNOWN => FallbackContentHandler::class,
];

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.35</tvar> is unsupported version</translate>">

1.31 – 1.35

<translate> MediaWiki versions:</translate>

$wgContentHandlers = [
	// the usual case
	CONTENT_MODEL_WIKITEXT => WikitextContentHandler::class,
	// dumb version, no syntax highlighting
	CONTENT_MODEL_JAVASCRIPT => JavaScriptContentHandler::class,
	// simple implementation, for use by extensions, etc.
	CONTENT_MODEL_JSON => JsonContentHandler::class,
	// dumb version, no syntax highlighting
	CONTENT_MODEL_CSS => CssContentHandler::class,
	// plain text, for use by extensions, etc.
	CONTENT_MODEL_TEXT => TextContentHandler::class,
];

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.30</tvar> is unsupported version</translate>">

1.24 – 1.30

<translate> MediaWiki versions:</translate>

$wgContentHandlers = [
	// the usual case
	CONTENT_MODEL_WIKITEXT => 'WikitextContentHandler',
	// dumb version, no syntax highlighting
	CONTENT_MODEL_JAVASCRIPT => 'JavaScriptContentHandler',
	// simple implementation, for use by extensions, etc.
	CONTENT_MODEL_JSON => 'JsonContentHandler',
	// dumb version, no syntax highlighting
	CONTENT_MODEL_CSS => 'CssContentHandler',
	// plain text, for use by extensions, etc.
	CONTENT_MODEL_TEXT => 'TextContentHandler',
];

<td class="mw-version-versionbox" title="<translate nowrap> MediaWiki <tvar name=1>1.23</tvar> is unsupported version</translate>">

1.21 – 1.23

<translate> MediaWiki versions:</translate>

$wgContentHandlers = array(
	// the usual case
	CONTENT_MODEL_WIKITEXT => 'WikitextContentHandler',
	// dumb version, no syntax highlighting
	CONTENT_MODEL_JAVASCRIPT => 'JavaScriptContentHandler',
	// dumb version, no syntax highlighting
	CONTENT_MODEL_CSS => 'CssContentHandler',
	// plain text, for use by extensions etc
	CONTENT_MODEL_TEXT => 'TextContentHandler',
);