Příručka k rozšířením MediaWiki

Theme Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Vzhled Category:Skin extensions/cs
Popis	Umožňuje použití motivů vzhledů
Autoři	Ryan Schmidt Jack Phoenix Samantha Nguyen
Nejnovější verze	2.5.1
MediaWiki	1.43+Category:Extensions with manual MediaWiki version
Licence	Volné dílo (Hlavní soubor PHP je licencován s PD licencí, zatímco některé soubory šablony nemusí být)
Stáhnout	Stáhněte si rozšíření Git [?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs
Příklad	ShoutWiki
Parametry $wgDefaultTheme, $wgSkipThemes
Použité háčky (hooks) BeforePageDisplay Category:BeforePageDisplay extensions/cs GetPreferences Category:GetPreferences extensions/cs OutputPageBodyAttributes Category:OutputPageBodyAttributes extensions/cs ResourceLoaderGetConfigVars Category:ResourceLoaderGetConfigVars extensions/cs
Čtvrtletní stahování	10 (Ranked 88th)
Veřejné wiki používající rozšíření	1,212 (Ranked 229th)
Přeložte rozšíření Theme, používá-li lokalizaci z translatewiki.net
Problémy	Otevřené úkoly · Nahlásit chybu

Rozšíření Theme umožňuje načítání šablon (přednastavený CSS pro změnu vzhledu). Uživatelé si mohou určit preferované téma jeho nastavením ve svých preferencích. Proměnnou $wgDefaultTheme lze použít k ovládání šablony, která se používá na celém webu, a parametr usetheme=X je akceptován u žádosti o změnu šablony pro každé načtení stránky.

Toto rozšíření napsal(a) Skizzerz pro ShoutWiki.

Instalace

• Stáhněte soubor/y a vložte je do adresáře pojmenovaného Theme ve vaší složce extensions/.
  Vývojáři a přispěvatelé kódu by si místo toho měli nainstalovat rozšíření from Git pomocí:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Theme
• Na konec vašeho souboru LocalSettings.php přidejte následující kód:

  wfLoadExtension( 'Theme' );
  

• Dokončeno – Přejděte na stránku Special:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.

Parametry

• $wgDefaultTheme - určuje, které téma se zobrazí ve výchozím nastavení, když uživatelé navštíví vaši wiki.
• $wgSkipThemes - (k dispozici od verze rozšíření 2.5, červenec 2024) umožňuje správcům systému zakázat určité motivy. Pokud byste chtěli například zakázat motivy StellarBook MonoBook a tmavý Vector, nastavili byste to takto:

$wgSkipThemes = [
	'monobook' => [
		'stellarbook' => true
	],
	'vector' => [
		'dark' => true
	]
];

Dostupné motivy

Certain skins, like Bouquet , Dusk or Gamepress include themes as a part of the skin; themes can then be activated once the Theme extension is installed on your wiki.

Jiné vzhledy, především ty, které spravují vývojáři Wikimedia Foundation pro použití na webových stránkách Wikimedia Foundation, jako je Wikipedie atd., neobsahují šablony. Jejich šablony jsou místo toho umístěny jako součást rozšíření Theme. Currently these kind of skins include MonoBook and Vector .

Přidávání motivů

To add a new theme for a core skin (such as Modern or Vector), create a directory called skinname (i.e. vector) under $IP /extensions/Theme, place the CSS file(s) there and register the new theme in Theme/extension.json file, under ResourceModules object.

To add a new theme for a custom skin, register a module for each theme in the skin's main setup file (skin.json). The naming convention is themeloader.skins.skinname-in-lowercase.themename-in-lowercase; for example, the module name of the AutumnLeaf theme for the BlueCloud skin would be themeloader.skins.bluecloud.autumnleaf.

You also need to define a top-level key called ThemeModules to list the available theme names. Here's how Gamepress does that (see Gamepress' skin.json file's master version for details):

	"ThemeModules": {
		"gamepress": [ "blue", "green", "orange" ]
	},

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích: Miraheze Category:Extensions included in Miraheze/cs ShoutWiki Category:Extensions included in ShoutWiki/cs WikiForgeCategory:Extensions included in WikiForge/cs Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.