扩展:多媒体查看器

此扩展已绑定在MediaWiki 1.31及以上版本 因此您不需要再次下载。 然而，您仍需要跟随提供的其他指示。

MediaWiki擴充功能手冊

MultimediaViewer 发布状态： 稳定版
实现	用户界面, Ajax
描述	Provides a better experience to users when they click on thumbnails in a page
作者	Mark Holmquist Gergő Tisza Gilles Dubuc
MediaWiki	1.25+
PHP	5.4+
许可协议	GNU通用公眾授權條款2.0或更新版本
下载	下载扩展 Git [?]: 下载Git主线 浏览存储库 (GitHub) 提交历史 repository contributors (GitHub) 代码复核
例子	MediaWiki.org
参数 $wgMediaViewerDurationLoggingLoggedinSamplingFactor $wgMediaViewerAttributionLoggingSamplingFactor $wgMediaViewerDimensionLoggingSamplingFactor $wgMediaViewerImageQueryParameter $wgMediaViewerActionLoggingSamplingFactorMap $wgMediaViewerUseThumbnailGuessing $wgMediaViewerNetworkPerformanceSamplingFactor $wgMediaViewerRecordVirtualViewBeaconURI $wgMediaViewerDurationLoggingSamplingFactor $wgMediaViewerEnableByDefault $wgMediaViewerEnableByDefaultForAnonymous $wgMediaViewerExtensions
使用的钩子 BeforePageDisplay CategoryPageView GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars ThumbnailBeforeProduceHTML UserGetDefaultOptions
翻譯MultimediaViewer擴充功能如在translatewiki.net可用
检查使用和版本矩阵。
问题	尚未完成的工作 · 回報錯誤

The MultimediaViewer extension gives the user of a wiki a different interface for viewing full-size, or nearly full-size, images in their browser without extraneous page loads or confusing interstitial pages.

安装

选项一：使用Vagrant。参见MediaWiki-Vagrant 页面以了解通过Vagrant虚拟机系统获取MediaWiki安装版本的指令。

之后分别做两件事：vagrant enable-role multimediaviewer和vagrant provision。

选项二：手动安装。

First, consider installing 扩展:测试功能 . It may be helpful to hide the media viewer feature behind a preference. If you don't install this, it will be enabled everywhere. MultimediaViewer uses the GetBetaFeaturePreferences hook, which is created and run from BetaFeatures, to register this preference.

You'll also likely want to download 扩展:共享资源元数据 - it's not a hard requirement, but without it you won't get very much information in your lightboxes.

• 下载文件，并将其放置在您extensions/文件夹中的MultimediaViewer目录内。
• 将下列代码放置在您的LocalSettings.php的底部：

  wfLoadExtension( 'MultimediaViewer' );
  

•  完成 – 在您的wiki上导航至Special:Version，以验证扩展已成功安装。

致使用MediaWiki 1.26或更早版本的用户：

上面的说明介绍的是安装此扩展的新方法，它使用wfLoadExtension()。 如果您需要在早期版本（MediaWiki 1.26和更早版本）中安装此扩展，而不是wfLoadExtension( 'MultimediaViewer' );，您需要使用：

require_once "$IP/extensions/MultimediaViewer/MultimediaViewer.php";

配置

• $wgMediaViewerIsInBeta will register a preference with BetaFeatures if set to "true"

• $wgMediaViewerEnableByDefault and $wgMediaViewerEnableByDefaultForAnonymous will determine whether MMV is enabled by default for everyone and for anonymous users, respectively. They both default to true. $wgDefaultUserOptions['multimediaviewer-enable'] = 1; can be used as a replacement for $wgMediaViewerEnableByDefault.

• $wgMediaViewerUseThumbnailGuessing will improve performance when enabled, but can be fragile depending on how the wiki is set up (it will probably work fine if you use a 404 handler).

强制下载

To ensure files are offered for download and not viewed in the user's browser following a click on the Download … button, the server has to be configured, except when using vagrant:

If the requested URL to an image directory contains the download query parameter, the Content-Disposition-header must be set to attachment.

This can be achieved in Apache and compatible servers using mod_rewrite and mod_headers in a .htaccess file.

亮面配置可参见此处。

使用扩展

First thing, before testing, is to make sure you're logged in and you have the preference enabled: Log in to the wiki and go to Special:Preferences, then visit the "Beta features" tab and check the appropriate box.

Next, go to a page that has a thumbnail on it. Try clicking on the image or on the "expand" icon near it. The lightbox should pop up and give you a bigger view of the image.

If you'd prefer, there's an exported test environment that you can use via Special:Import to quickly set up a suitable testing environment.

通过用户脚本扩展

If you want to add functionality, you'll have to dig around in the classes and change the functionality pretty manually. We'll work on making this a nicer experience, but given the class and method hierarchy we've built, we think it's not terribly difficult right now.

HOWEVER, you should avoid doing this too much. If things change internally, then your code might break in unexpected ways, and you (and your users) will be surprised. Don't let that happen, and wait for a more stable way to extend the product.

例子参见/Extension:Metadata。

模板

多媒体查看器和上传向导需要多个模板来显示照片数据。 直接将此代码保存为xml文件，并导入至您的wiki即可。

参见

• Help:扩展:媒体查看器
• Multimedia
• 多媒体/媒体查看器/调查
• Extension:SlimboxThumbs