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 |
|
|
| Quarterly downloads | 169 (Ranked 34th) |
| 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
MultimediaViewerfolder 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 file:
wfLoadExtension( 'MultimediaViewer' );
- Configure as required
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
$wgMediaViewerEnableByDefaultand$wgMediaViewerEnableByDefaultForAnonymouswill determine whether MultimediaViewer is enabled by default for everyone and anonymous users, respectively. They both default totrue.$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 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
| 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: This is not an authoritative list. Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |