Extension:Theme

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

Theme Stav rozšíření: stabilní
Implementace	Vzhled
Popis	Umožňuje použití motivů vzhledů
Autoři	Ryan Schmidt Jack Phoenix Samantha Nguyen
Nejnovější verze	2.5.1
MediaWiki	1.43+
Parametry $wgDefaultTheme, $wgSkipThemes
Použité háčky (hooks) BeforePageDisplay GetPreferences OutputPageBodyAttributes ResourceLoaderGetConfigVars
Licence	Volné dílo
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
Příklad	ShoutWiki
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 .

Jako součást rozšíření Theme

Pro MonoBook

• dark
• pink
• stellarbook

Pro Vector (2010)

• dark
• dark-grey
• deepsea (odstraněno od 1.39 06bbbfd)

Součástí samotných vzhledů

Bouquet

• forgetmenot
• pinkdogwood
• tigerlily

Dusk

• green

Gamepress

• red (výchozí)
• blue
• green
• orange

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 the key below to list the available theme names. Here's how Gamepress does that (see Gamepress' skin.json file's master version for details):

• attributes.Theme.Modules in manifest version 2
• ThemeModules in manifest version 1

manifest version 2	manifest version 1
{ "attributes": { "Theme": { "Modules": [ "gamepress": [ "blue", "green", "orange" ] ] } } }	{ "ThemeModules": { "gamepress": [ "blue", "green", "orange" ] } }

Licence

Hlavní soubor PHP je licencován s PD licencí, zatímco některé soubory šablony nemusí být