Jump to content

Manuel:$wgValidSkinNames

From mediawiki.org
This page is a translated version of the page Manual:$wgValidSkinNames and the translation is 100% complete.
Extensions: $wgValidSkinNames
Liste de noms d'habillage valides. Est utilisé par les habillages pour dire à MediaWiki qu'ils sont disponibles.
Introduit dans la version :1.7.0 (r15226)
Retiré dans la version :Encore utilisé
Valeurs autorisées :(tableau de noms de skins en miniscules par : soit ObjectFactory specifications; soit une valeur de caractères qui est le nom de classe PHP quand annexé avec Skin)
Valeur par défaut :[]

Détails

Tableau avec des informations sur les noms d'habillages valides. En option, les habillages peuvent être utilisées pour dire à MediaWiki qu'elles sont disponibles.

Cette variable peut être utilisée pour enregistrer un skin, mais elle ne devrait pas être. Les habillages peuvent également être enregistrés dynamiquement, en utilisant les méthodes de la SkinFactory, à savoir SkinFactory::register(). Cela signifie qu'il n'y a aucune garantie que $wgValidSkinNames actuellement soit une liste complète d'habillages installés!
  • La clé doit être le nom de l'habillage en minuscules. Généralement, cela devrait être le même que le nom du dossier de base des habillages skin/ qui contient les skins css, les ressources, etc.
  • Avant MediaWiki 1.45, la valeur devrait être un identifiant qui quand ajouté après "Skin" devient le nom de classe de la classe implémentée par votre skin. i.e. Si la classe de votre skin est "SkinFooBar" la valeur dans le tableau devrait être $wgValidSkinNames['foobar'] = 'FooBar';.
  • Depuis MediaWiki 1.35, la valeur peut être une spécification pour ObjectFactory . Le vieux format, où la valeur est un identifiant qui quand ajouté après "Skin" devient le nom de la classe implémentée par votre skin, est toujours supporté.
  • Avant MediaWiki 1.18 la valeur était un nom d'affichage et le nom de la classe était déterminé en exécutant ucfirst sur l'identifiant du skin en minuscules. i.e. For $wgValidSkinNames['foobar'] = 'FooBar'; it would try to load the "SkinFooBar" class. Ceci causait des problèmes avec notre AutoChargement variant au cas par cas tandis que les classes PHP ne changeant pas au cas par cas.

Les habillages par défaut seront ajoutés ultérieurement, par SkinFactory::getSkinNames(). Utilisez SkinFactory::getSkinNames() comme un accesseur si vous voulez avoir accès à la liste complète.

Exemples

Dans MediaWiki 1.35, la valeur est une spécification de ObjectFactory . Ceci permet au nom du skin d'être découplé (par exemple avec les espaces de noms de la classe PHP) du nom de la classe PHP correspondante.

Version de MediaWiki :
1.35

Ancien format de style de chargement PHP :

$wgValidSkinNames["foobarskin"] = [
	"displayname" => "FooBarSkin",
	"class" => "MediaWiki\\Skins\\FooBar\\FooBarSkin"
];

format 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"
					]
				}
			]
		}
	}