Jump to content

Manual:$wgFooterIcons

From mediawiki.org
(Redirected from $wgFooterIcons)
Skins: $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
Introduced in version:1.17.0 (r77741)
Removed in version:Still in use
Allowed values:(array)
Default value:see below

Details

[edit]

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.

Default value

[edit]
MediaWiki version:
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",
		]
	],
];
MediaWiki versions:
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",
		]
	],
];
MediaWiki versions:
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",
		)
	),
);

Site customization

[edit]

Sites can customize and add new icons to the footer.

$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" => "Some text here...",
	// 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.

Disable icons

[edit]

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. Instead, just set $wgRightsIcon to null.

$wgRightsIcon = null;