Руководство: $wgFooterIcons

From mediawiki.org
This page is a translated version of the page Manual:$wgFooterIcons and the translation is 97% complete.
Outdated translations are marked like this.
Темы оформления: $wgFooterIcons
Абстрактный список иконок нижнего колонтитула для скинов. Он заменяет старый код copyrightico и poweredbyico, на который до MediaWiki 1.27 можно было повлиять с помощью $wgCopyrightIcon
Введено в версии:1.17.0 (r77741)
Удалено в версии:всё ещё используется
Допустимые значения:(множество)
Значение по умолчанию:см. ниже

Подробности

Вы можете добавить новые значки к встроенным функциям защиты авторских прав или источника, или вы можете создать новый блок. Однако обратите внимание, что вам может потребоваться добавить некоторый собственный CSS, чтобы получить хороший стиль новых блоков в monobook; vector и modern должны работать без специального CSS.

Сам $wgFooterIcons представляет собой массив ключ / значение. Ключ - это имя блока, в который будут заключены значки. Окончательный идентификатор зависит от скина; Monobook и Vector превратится powerby в f-poweredbyico, а Modern превратится в mw_poweredby. Значение представляет собой либо массив значков «ключ-значение», либо строку. В массиве ключ/значение ключ может использоваться или не использоваться оболочкой, но его можно использовать для поиска значка и его отмены или изменения значка, если это необходимо. Это полезно для отключения значков, установленных расширениями. Значение должно быть строкой или массивом. Если это строка, она будет выводиться напрямую как html, однако некоторые скины могут игнорировать её. Массив - предпочтительный формат значка, используются следующие ключи:

src
Абсолютный URL-адрес изображения для значка. Это рекомендуется, но не обязательно, однако некоторые скины игнорируют значки без изображения.
srcset
Используется за HiDPI display support . Вы можете указать пути к более крупным версиям значка.
url
URL-адрес для использования в <a> вокруг текста или значка, если не установлен <a>, выводиться не будет.
alt
Это текстовая форма значка, она будет отображаться без изображения в темах оформления, например Modern, если src не задана, и в противном случае будет использоваться как alt = "" для изображения. Этот ключ обязателен.
width
height
Если значок, указанный src, не имеет стандартного размера, вы можете указать размер изображения для использования с этими ключами. В противном случае они по умолчанию будут иметь стандартный 88x31.

Значение по умолчанию

Версия MediaWiki:
1.34
$wgFooterIcons = [
	"copyright" => [
		"copyright" => [], // заполнитель для встроенного значка авторских прав
	],
	"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['poweredby']['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",
];

Вы можете добавить в poweredby или/ copyright, если хотите, чтобы что-то отображалось в старых областях MonoBook, или вы можете добавить новую группу значков.

Отключить значки

Чтобы отключить значок нижнего колонтитула, показывающий, что страница "Powered by MediaWiki", добавьте следующую строку в файл "LocalSettings.php":

unset( $wgFooterIcons['poweredby'] );

Чтобы отключить заполнитель нижнего колонтитула для значка авторского права, который появляется при установке $wgRightsText , вы не должны сбрасывать его с $wgFooterIcons, поскольку это вызывает уведомления PHP как минимум в версиях MW 1.27, 1.30 и 1.31. Вместо этого просто установите для $wgRightsIcon значение null.

$wgRightsIcon = null;