Extension:MultimediaViewer（多媒体查看器）

MediaWiki扩展手册

MultimediaViewer 发行状态： 稳定版
实现	用户界面, Ajax
描述	提供给那些在页面上点击缩略图的用户更好的体验
作者	Mark Holmquist Gergő Tisza Gilles Dubuc
兼容性政策	快照跟随MediaWiki发布。 master分支不向后兼容。
MediaWiki	1.25+
PHP	5.4+
参数 $wgMediaViewerThumbnailBucketSizes $wgMediaViewerMobileBeta $wgMediaViewerRecordVirtualViewBeaconURI $wgMediaViewerEnableByDefault $wgMediaViewerDownloadSizes $wgMediaViewerBetaFeature $wgMediaViewerExcludedImageSelectors $wgMediaViewerMobileCarousel $wgMediaViewerEnableByDefaultForAnonymous $wgMediaViewerExtensions
使用的函数钩 BeforePageDisplay CategoryPageView GetBetaFeaturePreferences GetDoubleUnderscoreIDs GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars ThumbnailBeforeProduceHTML UserGetDefaultOptions
许可证	GNU General Public License 2.0 or later
下載	下載扩展 Git [?]: 浏览存储库 (Phabricator · GitHub) Gerrit代码复核 Git提交日誌 下載原始碼（tarball壓縮）
示例	MediaWiki.org
前往translatewiki.net翻譯MultimediaViewer扩展
問題	开启的任务 · 报告错误

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

安装

您还可以考虑安装Extension:共享资源元数据 。虽然这不是个硬性要求，但是沒有它，你就無法在顯示圖像詳細資訊的方框中獲得太多資訊。

在第三方維基上，即使你只使用本地上傳的圖片，也需要 CommonsMetadata 透過包含文件資訊的模板來填入方格中的資訊。

此扩展随附于MediaWiki 1.31及更新版本，因此您無需下載它。 但其余的配置的指示仍须依循執行。

• 下载文件，并解压MultimediaViewer文件夹到extensions/目录中。
  开发者和代码贡献人员应改从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安装

配置

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

强制下载

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

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

圖片瀏覽

圖片瀏覽功能僅在行動版介面中提供以下兩個元件：

Carousel	Detail view

前者顯示在文章頁面的頂端，後者則是在點擊文章中的任何圖片後才會載入。

您可以透過以下組態旗標啟用這些元件：

• $wgMediaViewerMobileCarousel = true; (輪播圖)
• $wgMediaViewerMobileBeta = true; （詳細視圖）

若要在桌面裝置上體驗行動版介面，您有以下2種選擇：

• 在您的網路瀏覽器中啟用行動裝置模擬功能
• 在您正在瀏覽的網址後面加上 ?useformat=mobile

使用情境測試

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

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

模板

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

参阅

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