Jump to content

Manual:$wgFooterIcons

From mediawiki.org
This page is a translated version of the page Manual:$wgFooterIcons and the translation is 25% complete.
Outdated translations are marked like this.
Temas: $wgFooterIcons
Abstract list of footer icons for skins. It replaces the old copyrightico and poweredbyico code, which until MediaWiki 1.27 could be influenced with $wgCopyrightIcon
Introduzida na versão:1.17.0 (r77741)
Removida na versão:ainda em uso
Valores permitidos:(array)
Valor por omissão:ver em baixo

Detalhes

You can add new icons to the built in copyright or poweredby, or you can create a new block. Though note that you may need to add some custom CSS to get good styling of new blocks in MonoBook; Vector and Modern should work without any special CSS.

$wgFooterIcons itself is a key/value array. The key is the name of a block that the icons will be wrapped in. The final id varies by skin; Monobook and Vector will turn poweredby into f-poweredbyico while Modern turns it into mw_poweredby. The value is either key/value array of icons or a string. In the key/value array the key may or may not be used by the skin but it can be used to find the icon and unset it or change the icon if needed. This is useful for disabling icons that are set by extensions. The value should be either a string or an array. If it is a string it will be output directly as html, however some skins may choose to ignore it. An array is the preferred format for the icon, the following keys are used:

src
An absolute url to the image to use for the icon, this is recommended but not required, however some skins will ignore icons without an image
srcset
Used for HiDPI display support . You can specify paths to larger versions of the icon.
url
The url to use in the <a> around the text or icon, if not set an <a> will not be outputted.
alt
This is the text form of the icon, it will be displayed without an image in skins like Modern if src is not set, and will otherwise be used as the alt="" for the image. This key is required.
width
height
If the icon specified by src is not of the standard size you can specify the size of image to use with these keys. Otherwise they will default to the standard 88x31.

Valor predefinido

Versão MediaWiki:
1.34
$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" => "https://www.mediawiki.org/",
			"alt" => "Powered by MediaWiki",
		]
	],
];
Versões do 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",
		]
	],
];
Versões do 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",
		)
	),
);

Personalização do site

Os sites podem personalizar e adicionar novos ícones no rodapé.

$wgFooterIcons['poweredby']['myicon'] = [
	"src" => "/path/to/my/image.png",
    // you may also use a direct path to the source, e.g. "http://example.com/my/custom/path/to/MyCustomLogo.png"
	"url" => "http://example.com/",
	"alt" => "Algum texto aqui...",
	// For HiDPI support, you can specify paths to larger versions of the icon.
	"srcset" =>
		"/path/to/1.5x_version.png 1.5x",
		"/path/to/2x_version.png 2x",
	// If you have a non-default sized icon you can specify the size yourself.
	"height" => "31",
	"width" => "88",
];

You can add to the poweredby or/ copyright if you want stuff to show up in the old MonoBook areas, or you can add a brand new group of icons.

Desativar ícones

To disable footer icon showing the page is "Powered by MediaWiki" add the following line to your "LocalSettings.php" file:

unset( $wgFooterIcons['poweredby'] );

To disable footer placeholder for the copyright icon which appears when $wgRightsText is set, you should not unset it from $wgFooterIcons as this causes PHP Notices in at-least MW versions 1.27, 1.30, and 1.31. Em vez de, basta definir $RightsIcon para null.

$wgRightsIcon = null;