Jump to content

手册:$wgFooterIcons

From mediawiki.org
This page is a translated version of the page Manual:$wgFooterIcons and the translation is 74% complete.
皮肤: $wgFooterIcons
皮肤页脚图标(icon)的抽象列表
引进版本:1.17.0 (r77741)
移除版本:仍在使用
允许的值:(数组)
默认值:参见下方

细节

你可以向内置的版权区域或 poweredby 区域添加新的图标,或者可以创建一个新的区块。 值得留意的是,在 MonoBook 皮肤中可能需要添加一些定制的 CSS 来确保新区块良好的样式呈现,Vector 和 Modern 则可能不需要特别的 CSS。

$wgFooterIcons 本身是一个“键值对”数组。 键(key)表示一个区块(block)的名称,图标会被包裹在这个区块里。 最终生成的 id 会因皮肤不同而变化:在 Monobook 和 Vector 皮肤中,poweredby 会变成 f-poweredbyico;在 Modern 皮肤中,则会变成 mw_poweredby。 值(value)可以是一个键/值数组,也可以是一个字符串。 在键/值数组中,键是否被皮肤使用要视情况而定,但它可以用来定位某个图标,并在需要时将其移除或替换。 这对禁用扩展设置的图标很有用。 值应当是一个字符串或数组: 如果是字符串,它会被直接作为 HTML 输出,不过某些皮肤可能会忽略它。 数组是推荐的图标格式,数组中会使用以下键:

src
图标使用的图片的绝对 URL。推荐设置,但不是必须的。不过,一些皮肤会忽略没有图像的图标。
srcset
用于 HiDPI display support (高清晰度)显示支持。你可以指定更大尺寸的图标路径。
url
用作包裹文本或图标的 <a> 标签的链接地址。如果未设置,则不会输出 <a>。
alt
图标的文本形式:如果没有设置 src,在像 Modern 这样的皮肤中,会显示此文本代替图片;如果设置了 src,则此值会作为图片的 alt="" 属性使用。 This key is required.
width
height
如果 src 指定的图标不是标准大小,可以用这两个键指定图像的宽高。否则,它们默认为标准的 88×31。

默认值

MediaWiki版本:
1.44
$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",
			"lang" => "en",
		]
	],
];
MediaWiki版本:
1.34 – 1.43
$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版本:
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版本:
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",
		)
	),
);

为站点定制

可以为站点页脚定制并新增图标。 在自定义页脚时,请确保将追加到 $wgFooterIcons 数组中的新项具有唯一的键。

例如:

$wgFooterIcons['poweredby-x'] = [
  'myicon' => [
	"src" => "/path/to/my/image.png",
    // 也可以使用图标源的直链,例如: "http://example.com/my/custom/path/to/MyCustomLogo.png"
	"url" => "http://example.com/",
	"alt" => "一些图片的补充说明文本",
	// 如需支持 HiDPI,可以指定较大版本的图标路径。
	"srcset" =>
		"/path/to/1.5x_version.png 1.5x",
		"/path/to/2x_version.png 2x",
	// 如果你有一个非默认尺寸的图标,还可以自行指定尺寸。
	"height" => "31",
	"width" => "88",
  ]
];

如果你想在旧的 MonoBook 区域显示内容,可以添加到 poweredby 或版权中,或者你可以添加一个全新的图标组。

禁用页脚图标

要禁用页脚图标显示的“Powered by MediaWiki”,请将以下内容添加到您的“LocalSettings.php”文件中:

unset( $wgFooterIcons['poweredby'] );

要禁用在设置了 $wgRightsText 时出现的版权图标占位符,不应该从 $wgFooterIcons 中将其移除,因为这样做在 MediaWiki 1.27、1.30 和 1.31 版本中会导致 PHP Notices。 正确的做法是将 $wgRightsIcon 设置为 null。

$wgRightsIcon = null;