手册:$wgUseInstantCommons

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Manual:$wgUseInstantCommons and the translation is 41% complete.

Other languages:
Deutsch • ‎English • ‎Nederlands • ‎español • ‎français • ‎magyar • ‎polski • ‎русский • ‎中文 • ‎日本語
共享上传: $wgUseInstantCommons
Enable InstantCommons, i.e. the use of Wikimedia Commons as a shared repository
引进版本:1.16.0 (r58652)
移除版本:仍在使用
允许的值:(boolean)
默认值:false

用法

将以下内容添加到LocalSettings.php 以启用InstantCommons:

$wgUseInstantCommons = true;

详情

Setting this configuration parameter to true enables InstantCommons, which allows to automatically use in the local wiki images hosted in Wikimedia Commons.

This configuration parameter's setting is a shorthand for the following setting to $wgForeignFileRepos :

$wgForeignFileRepos[] = [
	'class' => 'ForeignAPIRepo',
	'name' => 'wikimediacommons',
	'apibase' => 'https://commons.wikimedia.org/w/api.php',
	'url' => 'https://upload.wikimedia.org/wikipedia/commons',
	'thumbUrl' => 'https://upload.wikimedia.org/wikipedia/commons/thumb',
	'hashLevels' => 2,
	'transformVia404' => true,
	'fetchDescription' => true,
	'descriptionCacheExpiry' => 43200,
	'apiThumbCacheExpiry' => 0,
];

注释

Enabling this configuration parameter does not avoid any usage of disk space on the server running the local wiki. Until MediaWiki 1.26, this setting did indeed generate thumbs on the local disk for caching purposes. In case the dimensions of the original file on Wikimedia Commons are exceeded when embedding the file on a page in the local wiki, the file will in its original size be put onto the local disk.

Since MediaWiki 1.27, $wgUseInstantCommons hotlinks images from Commons by default instead of downloading originals and thumbnailing them locally. This allows wikis to save on CPU and bandwidth while reducing time to first byte for pages, even without a thumbnail handler. 有关调整的配置参数$wgForeignFileRepos,请参见文档。

参见