Extension:MultimediaViewer/zh

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安装版本的指令.

之后分别做两件事： 和.

选项二：手动安装.

First, consider installing Extension:BetaFeatures. 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 Extension:CommonsMetadata - it's not a hard requirement, but without it you won't get very much information in your lightboxes.

配置
If neither  nor   are set, MMV will be turned on for all users!
 * will register a preference with BetaFeatures if set to "true"
 * and  will determine whether MMV is enabled  by default for everyone and for anonymous users, respectively. They both default to true.
 * 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  query parameter, the  -header must be set to. This can be achieved in Apache and compatible servers using mod_rewrite and mod_headers in a  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.

参见

 * 多媒体
 * 多媒体/媒体查看器