Příručka:$wgContentHandlers

Modely obsahu a obslužné programy
MediaWiki umožňuje, aby stránka mohla mít jiný typ obsahu než wikitext. V základu má vestavěnou podporu pro JavaScript, CSS, JSON a prostý text. Rozšíření mohou pomocí mechanismu ContentHandler MediaWiki přidávat nové modely obsahu pro přijímání různých formátů a řízení toho, jak jsou vykreslovány, ukládány a upravovány.
O projektu
O aplikaci ContentHandler Obslužné programy pro obsah a jejich implementace
Použití
Změna modelu obsahu stránky Změna modelu obsahu jmenného prostoru Rozšíření pomocí ContentHandler Přidávání modelů obsahu s rozšířením Příklady: includes (část Examples ) Markdown
Nastavení konfigurace
$wgContentHandlers $wgNamespaceContentModels $wgContentHandlerTextFallback $wgContentHandlerUseDB
Podpora a vývoj Poslední technická dokumentace (Git) Phabricator

Obslužné nástroje a úložiště obsahu: $wgContentHandlers
Mapování modelů obsahu stránek
Zavedeno od verze:	1.21.0
Odstraněno od verze:	stále se používá
Povolené hodnoty:	(pole názvů tříd PHP)
Výchozí hodnota:	(viz níže)
Další nastavení: Podle abecedy | Podle funkce

Podrobnosti

Doplňky pro stránku zacházení s modelem obsahu. Každá položka v poli mapuje konstantu ID modelu na název třídy PHP.

Verze MediaWiki:

1.34

Když zrušíte nasazení rozšíření, které poskytuje manipulaci s modelem obsahu, tento model obsahu přestane být podporován, což povede k výjimkám MWUnknownContentModelExceptions. Abyste tomu zabránili, lze daný model obsahu definovat tak, aby používal UnknownContentHandler:

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

To umožňuje, aby stránky, které používají nový model nepodporovaného obsahu, byly stále přístupné, i když jejich obsah již nelze zobrazovat.

Alternativně, pokud je dotyčným modelem obsahu textový model, lze jej předefinovat tak, aby se s ním zacházelo jako s prostým textem:

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

Obsah stránek, které používají tento model obsahu, zůstává čitelný a upravitelný, ale ztrácí veškeré speciální schopnosti a podporu značkování.

Výchozí hodnota

Verze MediaWiki:

≥ 1.41

$wgContentHandlers = [
	// běžně používáno
	CONTENT_MODEL_WIKITEXT => [
		'class' => WikitextContentHandler::class,
		'services' => [
			'TitleFactory',
			'ParserFactory',
			'GlobalIdGenerator',
			'LanguageNameUtils',
			'LinkRenderer',
			'MagicWordFactory',
			'ParsoidParserFactory',
		],
	],
	// špatná verze, žádné zvýraznění syntaxe
	CONTENT_MODEL_JAVASCRIPT => JavaScriptContentHandler::class,
	// jednoduché provedení, pro použití v rozšířeních atd.
	CONTENT_MODEL_JSON => JsonContentHandler::class,
	// špatná verze, žádné zvýraznění syntaxe
	CONTENT_MODEL_CSS => CssContentHandler::class,
	// prostý text (pro použití v rozšířeních apod.)
	CONTENT_MODEL_TEXT => TextContentHandler::class,
	// záložní pro neznámé modely, z importů nebo rozšíření, které byly odstraněny
	CONTENT_MODEL_UNKNOWN => FallbackContentHandler::class,
];

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

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

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

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

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