Extension:MultimediaViewer
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 | 161 (Ranked 36th) |
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
[edit]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 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
[edit]$wgMediaViewerEnableByDefault
and$wgMediaViewerEnableByDefaultForAnonymous
will determine whether MultimediaViewer 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
[edit]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
[edit]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
[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 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. |
- 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 Telepedia
- Extensions included in wiki.gg
- Extensions included in WikiForge
- Image extensions