Manuel:$wgContentHandlers

Modèles de contenu et gestionnaires
MediaWiki permet que les types de contenu de page soient autre chose que du code wiki. Il offre une prise en charge intégrée pour JavaScript, CSS, JSON et le texte brut. Les extensions peuvent utiliser le mécanisme du gestionnaire de contenu de MediaWiki pour ajouter de nouveaux modèles de contenu afin d'accepter des formats différents et gérer leur rendu, leur enregistrement ainsi que leurs modifications.
À propos
À propos du gestionnaire de contenu Les gestionnaires de contenu et leur implémentation
Utilisation
Modifier le modèle de contenu d'une page Modifier le modèle de contenu d'un espace de noms Extensions qui utilisent le gestionnaire de contenu Ajouter des modèles de contenu avec une extension Exemples : includes (partie de Examples ) Markdown
Paramètres de configuration
$wgContentHandlers $wgNamespaceContentModels $wgContentHandlerTextFallback $wgContentHandlerUseDB
Support et développement Dernière documentation technique (Git) Phabricator

Gestionnaires de contenu et sauvegarde: $wgContentHandlers
Correspondance des gestionnaires de type de contenu
Introduit dans la version :	1.21.0
Retiré dans la version :	Encore utilisé
Valeurs autorisées :	(tableau de noms de classes PHP)
Valeur par défaut :	(voir ci-dessous)
Autres paramètres : Alphabétique | Par fonction

Détails

Greffons pour la gestion du modèle de contenu des pages. Chaque entrée du tableau fait correspondre une constante d'ID de modèle au nom d'une classe PHP.

Version de MediaWiki :

1.34

Lorsqu'on retire de son utilisation une extension qui gère un modèle de contenu, celui-ci n'est plus pris en charge, ce qui génère des MWUnknownContentModelExceptions. Pour éviter cela, le modèle de contenu en question peut être défini comme traitant le UnknownContentHandler:

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

Ceci permet aux pages qui utilisent le nouveau modèle de contenu pas encore pris en charge, de rester accessibles, même si leur contenu ne peut plus être affiché.

Par ailleurs, si le modèle de contenu en question est un modèle basé sur du texte, il peut être redéfini pour être géré comme du texte brut :

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

Le contenu des pages qui utilisent ce modèle de contenu reste lisible et modifiable, mais perd toute capacité spéciale et la prise en charge du balisage (markup).

Valeurs par défaut

Version de MediaWiki :

≥ 1.41

$wgContentHandlers = [
	// cas habituel
	CONTENT_MODEL_WIKITEXT => [
		'class' => WikitextContentHandler::class,
		'services' => [
			'TitleFactory',
			'ParserFactory',
			'GlobalIdGenerator',
			'LanguageNameUtils',
			'LinkRenderer',
			'MagicWordFactory',
			'ParsoidParserFactory',
		],
	],
	// version muette, pas de mise en valeur de la syntaxe
	CONTENT_MODEL_JAVASCRIPT => JavaScriptContentHandler::class,
	// implémentation simple, à utiliser par les extensions, etc.
	CONTENT_MODEL_JSON => JsonContentHandler::class,
	// version muette, pas de mise en valeur de la syntaxe
	CONTENT_MODEL_CSS => CssContentHandler::class,
	// texte brut, à utiliser par les extensions, etc.
	CONTENT_MODEL_TEXT => TextContentHandler::class,
	// repli pour les modèles inconnus, les imports ou les extensions qui ont été supprimés
	CONTENT_MODEL_UNKNOWN => FallbackContentHandler::class,
];

Version de MediaWiki :

1.40

$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,
];

Versions de MediaWiki :

1.36 – 1.39

$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,
];

Versions de MediaWiki :

1.31 – 1.35

$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,
];

Versions de MediaWiki :

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',
];

Versions de MediaWiki :

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',
);