手册:$wgFooterIcons
| 皮肤: $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;