Extension:MultimediaViewer

此扩展随附于MediaWiki 1.31及更高版本。 因此您无需另外下载。 但是，您仍需遵循此页面提供的其他使用说明。

MediaWiki扩展手册

MultimediaViewer 发行状态： 稳定版
实现	用户界面, Ajax
描述	给那些在页面上点击缩略图的用户提供更好的体验
作者	Mark Holmquist Gergő Tisza Gilles Dubuc
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
MediaWiki	1.25+
PHP	5.4+
许可协议	GNU通用公眾授權條款2.0或更新版本
下載	下載扩展 Git [?]: 下载Git master 浏览存储库 (Phabricator · GitHub) 提交历史 存储库貢獻者 (GitHub) 代码复核
示例	MediaWiki.org
参数 $wgMediaViewerUseThumbnailGuessing $wgMediaViewerRecordVirtualViewBeaconURI $wgMediaViewerImageQueryParameter $wgMediaViewerEnableByDefault $wgMediaViewerEnableByDefaultForAnonymous $wgMediaViewerExtensions
使用的函数钩 BeforePageDisplay CategoryPageView GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars ThumbnailBeforeProduceHTML UserGetDefaultOptions
季度下載量	219 (Ranked 33rd)
正在使用的公开wiki数	1,926 (Ranked 195th)
前往translatewiki.net翻譯MultimediaViewer扩展
問題	开启的任务 · 报告错误

多媒体查看器在不需要在浏览器中加载外部页面、或是令人困扰的中间页的情况下，给那些想浏览全尺寸、或是接近全尺寸图片的用户们带来了不一样的体验。

安裝

首先，有时我们可能不需要多媒体查看器，考虑到这种情况，您可以安装Extension:BetaFeatures 。如果您不安装Extension:BetaFeatures ，多媒体查看器则在任何地方都会被启用。

您还可以考虑安装扩展:共享资源元数据 。虽然这不是个硬性要求，但是扩展:共享资源元数据 可以在浏览图片时提供更多有关信息。

• 下载文件，并将其放置在您extensions/文件夹中的MultimediaViewer目录内。
  开发者和代码贡献人员应从Git安装扩展，输入：cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MultimediaViewer
• 将下列代码放置在您的LocalSettings.php 的底部：

  wfLoadExtension( 'MultimediaViewer' );
  

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

使用Vagrant安装：

• 如果使用Vagrant ，请通过vagrant roles enable multimediaviewer --provision安装

配置

• 若要启用测试功能，请将$wgMediaViewerIsInBeta设置为true。
• $wgMediaViewerEnableByDefault决定是否默认将多媒体查看器启用给所有人，而$wgMediaViewerEnableByDefaultForAnonymous则决定是否启用给匿名用户。 它们的默认值均为true。
• $wgMediaViewerUseThumbnailGuessing可以改进多媒体查看器的首选项。但由于您Wiki站点的本地设置，它有可能不太稳定。不过，使用404处理器或许可以解决这个问题。

强制下载

为了确保在单击下载...按钮后能提供文件以供下载，而不是在用户的浏览器中弹出一个新标签页，必须配置服务器，除非使用vagrant：

如果被请求至一个图像目录的URL包含了查询参数download，那么Content-Disposition必须被设置为attachment。 这可在Apache、或是在.htaccess文件中使用mod_rewrite和mod_headers的可兼容的服务器中实现。 亮面配置可参见此处。

用户测试

在测试之前，首先要确保您已登录并启用了首选项：登录您的Wiki站点并转到参数设置，然后在“测试功能”选项卡中选中相应的选框。

接下来，前往一个存在缩略图的页面。尝试单击图像或它附近的“展开”图标。这时多媒体查看器应该会弹出，并为您提供更大的图像视图。

如果您愿意，有一串“导出的测试环境”代码可以让您通过Special:导入页面来快速建立一个可用的测试环境。

模板

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

参见

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