Issue tracker: #MediaWiki-extensions-MultimediaViewer
shortcut: MV

Extension:MultimediaViewer

From Linux Web Expert

<translate> This {{<tvar name=1>#if:|{{{type}}}</tvar>|extension}} [[<tvar name=mwversion>Special:MyLanguage/MediaWiki 1.31#Bundled extensions</tvar>|comes with MediaWiki <tvar name=mwversion2>1.31</tvar>]] and above.</translate> <translate> Thus you do not have to download it again.</translate> <translate> However, you still need to follow the other instructions provided.</translate>
MediaWiki extensions manual
File:OOjs UI icon advanced-invert.svg
MultimediaViewer
Release status: stable
File:Screenshot of MultimediaViewer extension 2014-04-21.png
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
<translate> Download extension</translate>
<translate> Git</translate> [?]:
Example MediaWiki.org
Parameters
  • $wgMediaViewerUseThumbnailGuessing
  • $wgMediaViewerRecordVirtualViewBeaconURI
  • $wgMediaViewerImageQueryParameter
  • $wgMediaViewerEnableByDefault
  • $wgMediaViewerEnableByDefaultForAnonymous
  • $wgMediaViewerExtensions
Hooks used
Quarterly downloads Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
Public wikis using Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin').
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

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.

  • <translate> [[<tvar name=2>Special:ExtensionDistributor/MultimediaViewer</tvar>|Download]] and move the extracted <tvar name=name>MultimediaViewer</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
    <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/MultimediaViewer
  • <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate> 
    wfLoadExtension( 'MultimediaViewer' );
  • Configure as required
  • File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>


<translate> Vagrant installation:</translate>

  • <translate> If using <tvar name=vagrant>Vagrant </tvar>, install with <tvar name=code>vagrant roles enable multimediaviewer --provision</tvar></translate>

Configuration

  • $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 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

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

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

Retrieved from "https://www.linuxwebexpert.com/wiki/index.php?title=Extension:MultimediaViewer&oldid=12765"