Erweiterung:MultimediaViewer

This extension comes with MediaWiki 1.31 and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.

shortcut: MV

MediaWiki extensions manual

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)	Mark Holmquist Gergő Tisza Gilles Dubuc
MediaWiki	1.25+
PHP	5.4+
License	GNU General Public License 2.0 or later
Download	Download extension Git [?]: Download Git master browse repository (GitHub) commit history repository contributors (GitHub) code review
Example	MediaWiki.org
Parameters $wgMediaViewerDurationLoggingLoggedinSamplingFactor $wgMediaViewerAttributionLoggingSamplingFactor $wgMediaViewerDimensionLoggingSamplingFactor $wgMediaViewerImageQueryParameter $wgMediaViewerActionLoggingSamplingFactorMap $wgMediaViewerUseThumbnailGuessing $wgMediaViewerNetworkPerformanceSamplingFactor $wgMediaViewerRecordVirtualViewBeaconURI $wgMediaViewerDurationLoggingSamplingFactor $wgMediaViewerEnableByDefault $wgMediaViewerEnableByDefaultForAnonymous $wgMediaViewerExtensions
Hooks used BeforePageDisplay CategoryPageView GetPreferences MakeGlobalVariablesScript ResourceLoaderGetConfigVars ThumbnailBeforeProduceHTML UserGetDefaultOptions
Translate the MultimediaViewer extension if it is available at translatewiki.net
Check usage and version matrix.
Issues	Open tasks · Report a bug

Die Erweiterung MultimediaViewer' gibt dem Benutzer eines Wikis eine andere visuelle Oberfläche, um Bilder in voller oder fast voller Größe in seinem Browser anzuzeigen, ohne dass es zu unerwünschten Seitenaufrufen oder unterbrechenden Seiten kommt.

Installation

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: Manuell installieren.

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 place the file(s) in a directory called MultimediaViewer in your extensions/ folder.
• Add the following code at the bottom of your LocalSettings.php:

  wfLoadExtension( 'MultimediaViewer' );
  

•  Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

To users running MediaWiki 1.26 or earlier:

The instructions above describe the new way of installing this extension using wfLoadExtension(). If you need to install this extension on these earlier versions (MediaWiki 1.26 and earlier), instead of wfLoadExtension( 'MultimediaViewer' );, you need to use:

require_once "$IP/extensions/MultimediaViewer/MultimediaViewer.php";

Konfiguration

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

Verwenden der Erweiterung

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

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.

Vorlagen

Multimedia Viewer and Upload Wizard needs several templates to show data of photos.

Speichern Sie diesen Code als XML-Datei und importieren Sie ihn in Ihr Wiki.

Siehe auch

• Help:Extension:Media Viewer
• Multimedia
• Multimedia/Media Viewer

Ähnliche Erweiterungen

• Extension:FancyBoxThumbs
• Extension:SlimboxThumbs