Extension:MultimediaViewer

This extension comes with MediaWiki 1.31 and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.
Category:Extensions bundled with MediaWiki 1.31 Category:GPL licensed extensions
MediaWiki extensions manual
MultimediaViewer
Release status: stableCategory:Stable extensions
Implementation User interfaceCategory:User interface extensions, AjaxCategory:Ajax extensions
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.Category:Extensions with release branches compatibility policy
MediaWiki 1.25+Category:Extensions with manual MediaWiki version
PHP 5.4+
License GNU General Public License 2.0 or later
Download Category:Extensions in Wikimedia version control
Example MediaWiki.org
  • $wgMediaViewerUseThumbnailGuessing
  • $wgMediaViewerRecordVirtualViewBeaconURI
  • $wgMediaViewerImageQueryParameter
  • $wgMediaViewerThumbnailBucketSizes
  • $wgMediaViewerEnableByDefault
  • $wgMediaViewerEnableByDefaultForAnonymous
  • $wgMediaViewerExtensions
Quarterly downloads 91 (Ranked 47th)
Public wikis using 1,926 (Ranked 195th)
Translate the MultimediaViewer extension if it is available at translatewiki.net
Issues Open tasks · Report a bug
Category:All extensions

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 your extensions/ 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 file:
    wfLoadExtension( 'MultimediaViewer' );
    
  • Configure as required
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


Vagrant installation:

  • If using Vagrant , install with vagrant roles enable multimediaviewer --provision

Configuration

  • $wgMediaViewerEnableByDefault and $wgMediaViewerEnableByDefaultForAnonymous will determine whether MultimediaViewer is enabled by default for everyone and anonymous users, respectively. They both default to true.
  • $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 UploadWizard need several templates to show data of photos. Save this code in an XML file and import it in your wiki.

See also

Category:Extensions used on Wikimedia#MultimediaViewer Category:Image extensions
Category:Ajax extensions Category:All extensions Category:BeforePageDisplay extensions Category:CategoryPageView extensions Category:Extensions available as Debian packages Category:Extensions bundled with MediaWiki 1.31 Category:Extensions in Wikimedia version control Category:Extensions included in BlueSpice Category:Extensions included in Canasta Category:Extensions included in Fandom Category:Extensions included in Miraheze Category:Extensions included in MyWikis Category:Extensions included in ProWiki Category:Extensions included in Telepedia Category:Extensions included in WikiForge Category:Extensions included in semantic::core Category:Extensions included in wiki.gg Category:Extensions used on Wikimedia Category:Extensions with manual MediaWiki version Category:Extensions with release branches compatibility policy Category:GPL licensed extensions Category:GetPreferences extensions Category:Image extensions Category:MakeGlobalVariablesScript extensions Category:ResourceLoaderGetConfigVars extensions Category:Stable extensions Category:ThumbnailBeforeProduceHTML extensions Category:UserGetDefaultOptions extensions Category:User interface extensions