Extension:MultimediaViewer

From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manual
Crystal Clear action run.png
MultimediaViewer

Release status: stable

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) Mark Holmquist (MarkTraceurtalk)
Latest version 0.2.0 (2013-11-20)
MediaWiki 1.23+
PHP 5.3+
Database changes No
License GPLv2+
Download
Example MediaWiki.org
Namespace main
Parameters
  • $wgEnableMediaViewerForLoggedInUsersOnly
  • $wgMediaViewerIsInBeta
Hooks used
GetBetaFeaturePreferences

BeforePageDisplay
CategoryPageView
ResourceLoaderGetConfigVars

Translate the MultimediaViewer extension if possible

Check usage and version matrix; code metrics
Bugs: list open list all report

The MultimediaViewer extension gives the user of a wiki a slightly nicer interface for viewing full-size, or nearly full-size, images in their browser without extraneous page loads or confusing interstitial pages.

Installation[edit | edit source]

Option A: use Vagrant. See the MediaWiki-Vagrant page for instructions to get a MediaWiki installation going with a Vagrant virtual machine system.

Then do vagrant enable-role multimediaviewer and then vagrant provision.

Option B: install manually.

First, consider installing Extension:BetaFeatures. It may be helpful to hide the media viewer feature behind a preference. If you don't install this, it will be enabled everywhere. MultimediaViewer uses the GetBetaFeaturePreferences hook, which is created and run from BetaFeatures, to register this preference.

You'll also likely want to download Extension:CommonsMetadata - it's not a hard requirement, but without it you won't get very much information in your lightboxes.

  • Download and extract the files in a directory called MultimediaViewer in your extensions/ folder. If you're a developer and this extension is in a Git repository, then instead you should clone the repository.
  • Add the following code at the bottom of your LocalSettings.php:
require_once( "$IP/extensions/MultimediaViewer/MultimediaViewer.php" );
  • Done! Navigate to "Special:Version" on your wiki to verify that the extension is successfully installed.

Configuration[edit | edit source]

There are two configuration variables that are relevant for MultimediaViewer - $wgMediaViewerIsInBeta, which will register a preference with BetaFeatures if set to true, and $wgEnableMediaViewerForLoggedInUsersOnly, which will turn MMV on for only logged-in users if set to true. If neither are set, MMV will be turned on for all users!

Using the extension[edit | edit source]

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.

Extending with user scripts[edit | edit source]

If you want to add functionality, you'll have to dig around in the classes and change the functionality pretty manually. We'll work on making this a nicer experience, but given the class and method hierarchy we've built, we think it's not terribly difficult right now.

HOWEVER, you should avoid doing this too much. If things change internally, then your code might break in unexpected ways, and you (and your users) will be surprised. Don't let that happen, and wait for a more stable way to extend the product.

See Extension:Metadata for an example.

See also[edit | edit source]