Release status: stable
|Implementation||User interface, Ajax|
|Description||Provides a better experience to users when they click on thumbnails in a page|
|Compatibility policy||Snapshots releases along with MediaWiki. Master is not backward compatible.|
|License||GNU General Public License 2.0 or later|
|Quarterly downloads||222 (Ranked 35th)|
|Public wikis using||1,926 (Ranked 195th)|
|Translate the MultimediaViewer extension if it is available at translatewiki.net|
|Issues||Open tasks · Report a bug|
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.
First, consider installing Extension:BetaFeatures. It may be helpful to hide the media viewer feature behind a preference. If you do not install this, it will be enabled everywhere.
You will also likely want to download Extension:CommonsMetadata. It is not a hard requirement, but without it you will not get very much information into the boxes showing details about the images.
- Download and move the extracted
MultimediaViewerfolder to your
Developers and code contributors should install the extension from Git instead, using:
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MultimediaViewer
- Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'MultimediaViewer' );
- Configure as required
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
- If using Vagrant, install with
vagrant roles enable multimediaviewer --provision
$wgMediaViewerIsInBetawill register a preference with BetaFeatures if set to "true"
$wgMediaViewerEnableByDefaultForAnonymouswill determine whether MMV is enabled by default for everyone and for anonymous users, respectively. They both default to
$wgMediaViewerUseThumbnailGuessingwill 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).
- Forced download
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
This can be achieved in Apache and compatible servers using mod_rewrite and mod_headers in a
Varnish configuration can look like this.
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.
|This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.|
|This extension is included in the following wiki farms/hosts and/or packages:|