Extension:MultimediaViewer
![]() Release status: stable |
|
---|---|
![]() |
|
Implementation | User interface, Ajax |
Description | Provides a better experience to users when they click on thumbnails in a page |
Author(s) | |
Compatibility policy | Snapshots releases along with MediaWiki. Master is not backward compatible. |
MediaWiki | 1.25+ |
PHP | 5.4+ |
License | GNU General Public License 2.0 or later |
Download | |
Example | MediaWiki.org |
Parameters
|
|
Hooks used
|
|
Quarterly downloads | 167 (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 wiki users a different interface for viewing full-size or nearly full-size images in their browser without extraneous page loads or confusing interstitial pages.
Installation
You will also likely want to download Extension:CommonsMetadata
. It is not a hard requirement, but without it, you will not get much information in the boxes showing details about the images.On third-party wikis, even if you only use locally uploaded images, you need CommonsMetatada to populate the information in the boxes via a template holding information about the files.)
- Download and move the extracted
MultimediaViewer
folder to yourextensions/
directory.
Developers and code contributors should install the extension from Git instead, using:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MultimediaViewer - Add the following code at the bottom of your LocalSettings.php
wfLoadExtension( 'MultimediaViewer' );
file: - Configure as required
Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Vagrant installation:
- If using Vagrant
vagrant roles enable multimediaviewer --provision
, install with
Configuration
$wgMediaViewerEnableByDefault
and$wgMediaViewerEnableByDefaultForAnonymous
will determine whether MMV is enabled by default for everyone and anonymous users, respectively. They both default totrue
.$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).
- 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 attachment
.
This can be achieved in Apache and compatible servers using mod_rewrite and mod_headers in a .htaccess
file.
Varnish configuration can look like this.
Usage testing
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 set up a suitable testing environment quickly.
Templates
MultimediaViewer and UploadWizardcode in an XML file and import it in your wiki.
need several templates to show data of photos. Just save thisSee also
- Help:Extension:Media Viewer
- Multimedia/Media Viewer
- Extension:SlimboxThumbs
![]() | This extension is included in the following wiki farms/hosts and/or packages:
|