Příručka:$wgValidSkinNames
Rozšíření: $wgValidSkinNames | |
---|---|
Seznam platných názvů vzhledů. Vzhledy mohou volitelně použít tuto proměnnou k tomu, aby MediaWiki sdělily, že jsou dostupné. |
|
Zavedeno od verze: | 1.7.0 (r15226) |
Odstraněno od verze: | stále se používá |
Povolené hodnoty: | (pole malých názvů vzhledů buď: specifikace ObjectFactory ; nebo hodnota řetězce, což je název třídy PHP, když je připojen ke vzhledu) |
Výchozí hodnota: | [] |
Další nastavení: Podle abecedy | Podle funkce |
Podrobnosti
Pole s informacemi o platných názvech vzhledů. Volitelně mohou být použity vzhledy k tomu, aby MediaWiki sdělily, že jsou dostupné.
Tuto proměnnou lze použít k registraci vzhledu, ale nemusí být. Vzhledy lze registrovat i dynamicky, pomocí metod SkinFactory, konkrétně
SkinFactory::register()
. To znamená, že neexistuje žádná záruka, že $wgValidSkinNames
je ve skutečnosti kompletní seznam nainstalovaných vzhledů!- Klíčem by mělo být id vzhledu ve všech malých písmenech. Obecně by to mělo být stejné jako název základní složky uvnitř vzhledů/, která obsahuje vzhledy css, zdroje atd...
- Před MediaWiki 1.35 by hodnotou měl být identifikátor, který se po předponě "Skin" stane názvem třídy implementované vaším vzhledem. tj. Pokud je název třídy vašeho vzhledu "SkinFooBar", hodnota v poli by měla být
$wgValidSkinNames['foobar'] = 'FooBar';
- Od MediaWiki 1.35 může být hodnotou specifikace ObjectFactory . Starý formát, kde je hodnotou identifikátor, který se po předponě "Skin" stane názvem třídy implementované vaším vzhledem, je stále podporován.
- Před MediaWiki 1.18 byla hodnota nouzový zobrazovaný název a název třídy byl určen spuštěním ucfirst na malém id vzhledu. tj. pro
$wgValidSkinNames['foobar'] = 'FooBar';
by se pokusil načíst třídu "SkinFoobar". To způsobilo problémy s naším AutoLoaderem, který rozlišoval malá a velká písmena, přestože názvy tříd PHP nerozlišovaly malá a velká písmena.
Výchozí vzhledy budou přidány později pomocí SkinFactory::getSkinNames()
.
Pokud chcete mít přístup k úplnému seznamu, použijte SkinFactory::getSkinNames()
jako přístupový objekt.
Příklady
Od MediaWiki 1.35 je hodnota specifikací ObjectFactory . To umožňuje oddělit název vzhledu (jako je jmenný prostor třídy PHP) od základního názvu třídy PHP.
Verze MediaWiki: | ≥ 1.35 |
Starý formát stylu načítání PHP:
$wgValidSkinNames["foobarskin"] = [
"displayname" => "FooBarSkin",
"class" => "MediaWiki\\Skins\\FooBar\\FooBarSkin"
];
Formát skin.json :
"ValidSkinNames": {
"foobarskin": {
"class": "SkinMustache",
"args": [
{
"@name": "key used for useskin=",
"name": "foorbarskin",
"@scripts": "List of ResourceLoader modules to be loaded",
"scripts": [
"skins.foo.js"
],
"@styles": "List of ResourceLoader style modules to be loaded",
"styles": [
"skins.foo.styles"
],
"@messages": "For skins that use SkinMustache, this will create translated template variables",
"messages": [
"foo-key"
]
}
]
}
}