Open main menu

Manual:$wgContentHandlers

Other languages:
English • ‎español • ‎magyar • ‎polski • ‎čeština • ‎日本語
Output: $wgContentHandlers
Mapping of content type handlers
Introduced in version:1.21.0
Removed in version:still in use
Allowed values:(Array of content model ID constants)
Default value:(see below)

DetailsEdit

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

MediaWiki version: 1.34

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 valueEdit

MediaWiki version: 1.31
$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,
];
MediaWiki versions: 1.24 – 1.30
$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',
];
MediaWiki versions: 1.21 – 1.23
$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',
);