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 | 221 (Ranked 50th) |
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.
Installation[edit]
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 place the file(s) in a directory called
MultimediaViewer
in yourextensions/
folder. - Add the following code at the bottom of your
LocalSettings.php
: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[edit]
$wgMediaViewerIsInBeta
will register a preference with BetaFeatures if set to "true"$wgMediaViewerEnableByDefault
and$wgMediaViewerEnableByDefaultForAnonymous
will determine whether MMV is enabled by default for everyone and for anonymous users, respectively. They both default totrue
.$wgDefaultUserOptions[ 'multimediaviewer-enable' ] = 1;
can be used as a replacement for$wgMediaViewerEnableByDefault
.$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[edit]
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.
Templates[edit]
MultimediaViewer and UploadWizard need several templates to show data of photos. Just save this code in a xml file and import it in your wiki.
See also[edit]
![]() | 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 packages and/or wiki farms: This is not an authoritative list. Some wiki farms/hosts may contain this extension even if they are not listed here. Always check with your wiki farms/hosts or bundle to confirm. |
- Extensions bundled with MediaWiki 1.31
- Stable extensions
- User interface extensions
- Ajax extensions
- GPL licensed extensions
- Extensions in Wikimedia version control
- BeforePageDisplay extensions
- CategoryPageView extensions
- GetPreferences extensions
- MakeGlobalVariablesScript extensions
- ResourceLoaderGetConfigVars extensions
- ThumbnailBeforeProduceHTML extensions
- UserGetDefaultOptions extensions
- All extensions
- Extensions used on Wikimedia
- Extensions included in BlueSpice
- Extensions included in Canasta
- Extensions available as Debian packages
- Extensions included in Fandom
- Extensions included in Miraheze
- Extensions included in MyWikis
- Extensions included in ProWiki
- Extensions included in semantic::core
- Extensions included in wiki.gg
- Extensions included in WikiForge
- Extensions included in Telepedia
- Image extensions