Jump to content

Manuel:$wgFooterIcons

From mediawiki.org
This page is a translated version of the page Manual:$wgFooterIcons and the translation is 100% complete.
Habillages: $wgFooterIcons
Liste résumée des icônes de pied de page pour les habillages. Remplace les anciens codes copyrightico et poweredbyico, qui jusqu'à MediaWiki 1.27 pouvaient être confondus avec $wgCopyrightIcon
Introduit dans la version :1.17.0 (r77741)
Retiré dans la version :Encore utilisé
Valeurs autorisées :(tableau)
Valeur par défaut :voir ci-dessous

Détails

Vous pouvez ajouter à la construction, de nouvelles icônes pour le copyright ou pour poweredby, ou vous pouvez créer un nouveau bloc. Notez cependant que vous pouvez avoir besoin d'ajouter des CSS personnalisés pour obtenir une mise en page correcte de ces nouveaux blocs dans MonoBook; Vector et Modern devraient fonctionner sans CSS spécial.

$wgFooterIcons lui-même est un tableau de clé/valeur. La clé est le nom d'un bloc qui contient les icônes. L'ID final dépend de l'habillage; Monobook et Vector transformeront poweredby en f-poweredbyico alors que Modern le transformera en mw_poweredby. La valeur est soit un tableau de clé/valeur d'icônes ou une chaîne. Dans le tableau clé/valeur, la clé peut ou non être utilisée par l'habillage, mais elle peut être utilisée pour retrouver l'icône et l'annuler ou la remplacer si nécessaire. Cela est utile pour désactiver les icônes qui sont définies par des extensions. La valeur doit être soit une chaîne, soit un tableau. Si c'est une chaîne, elle sera écrite directement comme du HTML; cependant, certains habillages peuvent choisir de l'ignorer. Un tableau est le format préféré pour l'icône, les clés suivantes sont utilisées :

src
URL absolue vers l'image à utiliser pour l'icône; cela est recommandé mais non requis; cependant, certains habillages ignoreront des icônes sans image
srcset
Utilisé pour HiDPI display support . Vous pouvez préciser le chemin des versions plus grandes de l'icône.
url
URL à utiliser dans le <a> autour du texte ou de l'icône; s'il n'est pas défini, le <a> ne sera émis.
alt
C'est la forme textuelle de l'icône; elle sera affichée sans image dans les habillages tels que Modern si src n'est pas défini, et sera sinon utilisé comme le alt="" de l'image. Cette clé est requise.
width
height
Si l'icône spécifiée par src n'est pas de la taille standard, vous pouvez spécifier la taille de l'image à utiliser avec ces clés. Sinon, elles seront par défaut au standard 88 x 31.

Valeur par défaut

Version de MediaWiki :
1.34
$wgFooterIcons = [
	"copyright" => [
		"copyright" => [], // substitut pour l'icône de copyright intégrée
	],
	"poweredby" => [
		"mediawiki" => [
			// Defaults to point at
			// "$wgResourceBasePath/resources/assets/poweredby_mediawiki_88x31.png"
			// plus srcset for 1.5x, 2x resolution variants.
			"src" => null,
			"url" => "https://www.mediawiki.org/",
			"alt" => "Powered by MediaWiki",
		]
	],
];
Versions de MediaWiki :
1.19 – 1.33
$wgFooterIcons = [
	"copyright" => [
		"copyright" => [],
        // placeholder for the built in copyright icon
	],
	"poweredby" => [
		"mediawiki" => [
			// Defaults to point at
			// "$wgResourceBasePath/resources/assets/poweredby_mediawiki_88x31.png"
			// plus srcset for 1.5x, 2x resolution variants.
			"src" => null,
			"url" => "//www.mediawiki.org/",
			"alt" => "Powered by MediaWiki",
		]
	],
];
Versions de MediaWiki :
1.17 – 1.18
$wgFooterIcons = array(
	"copyright" => array(
		"copyright" => array(), // placeholder for the built in copyright icon
	),
	"poweredby" => array(
		"mediawiki" => array(
			"src" => null, // Defaults to "$wgStylePath/common/images/poweredby_mediawiki_88x31.png"
			"url" => "https://www.mediawiki.org/",
			"alt" => "Powered by MediaWiki",
		)
	),
);

Personnalisation du site

Les sites peuvent personnaliser et ajouter de nouvelles icônes à leur pied de page.

$wgFooterIcons['poweredby']['myicon'] = [
	"src" => "/path/to/my/image.png",
    // vous pouvez aussi utiliser directement le chemin vers la source, par exemple "http://example.com/my/custom/path/to/MyCustomLogo.png"
	"url" => "http://example.com/",
	"alt" => "Texte ici...",
	// Pour le support HiDPI, vous pouvez préciser le chemin des versions plus grandes de l'icône.
	"srcset" =>
		"/path/to/1.5x_version.png 1.5x",
		"/path/to/2x_version.png 2x",
	// Vous pouvez préciser la taille vous-même, lorsque la taille de votre icône n'est pas la taille par défaut.
	"height" => "31",
	"width" => "88",
];

Vous pouvez ajouter dans 'poweredby' ou dans 'copyright' si vous souhaitez que le contenu apparaisse dans les anciennes zones de Monobook, ou vous pouvez ajouter un nouveau groupe d'icônes.

Désactivation des icônes

Pour ne pas que l'icône du pied de page affiche que la page est « Powered by MediaWiki », ajoutez la ligne suivante à votre fichier LocalSettings.php :

unset( $wgFooterIcons['poweredby'] );

Pour éviter que la zone du pied de page n'affiche l'icône de copyright quand $wgRightsText est défini, il ne faut pas le supprimer de $wgFooterIcons car cela affiche des notes PHP dans les versions MW 1.27, 1.30, et 1.31 au moins. A la place, mettez simplement $wgRightsIcon à null.

$wgRightsIcon = null;