Help:Extension:Media Viewer



Welcome to the help page for about-mv>Special:MyLanguage/Extension:Media Viewer/About|Media Viewer, a new multimedia browser for Wikimedia sites.

This page includes frequently asked questions about key features of this project.

What is Media Viewer?
Media Viewer is a new multimedia browser that aims to improve the viewing experience on Wikipedia, Commons and MediaWiki sites. It lets you view images in larger size, with useful information about their authors, license terms and other metadata. It also offers a number of tools for sharing, embedding and downloading media files.

This tool was developed by the Wikimedia Foundation's multimedia>Special:MyLanguage/Multimedia|new multimedia team. To learn more about Media Viewer, read below or visit about-mv>Special:MyLanguage/Extension:Media Viewer/About|this product page on MediaWiki.org.

How can I find the Media Viewer?
Media Viewer can be opened by clicking on any image on any Wikimedia site with the exception of logged-in users on Wikimedia Commons. Media Viewer can also be opened by clicking "Expand View" below the image on a File page.

Why Media Viewer?
The purpose of this tool is to:
 * Provide a richer multimedia experience
 * Display images in larger size, right where you are
 * Reduce confusion when users click on thumbnails

Media Viewer was created to provide a better viewing experience for readers and casual editors, our primary target users for this tool. It also includes a few features that invite them to download, share, embed and edit these files: over time, we hope these features can encourage them to contribute more to Wikipedia, Commons and other Wikimedia projects.

How does Media Viewer work?
When you click on a thumbnail in an article, a large version of the image is shown, for a more immersive experience. Media Viewer fills your browser window with a ‘light box view’, right over the page where you clicked.

From here, you can access a number of features:
 * view more information
 * view images in full-screen
 * enlarge original images in full resolution
 * browse through collections of images
 * share, embed or download an image
 * learn more about an image and its license
 * go to the file page to view or edit file details
 * close Media Viewer
 * disable (or enable) Media Viewer

Read below to learn more about these features.

How can I bypass Media Viewer?
If you need to bypass Media Viewer to access its file description page directly, simply press one of these keys when clicking on a thumbnail:
 * shift-click - opens the page in a new window
 * command-click - opens the page in a new tab
 * control-click - shows a menu of options

How can I turn off this feature?


To disable Media Viewer, click on the 'cogs' icon at the top right corner of any image in Media Viewer, below the full-screen control (see screenshot). Then click on "Disable Media Viewer". From now on, images will no longer open in Media Viewer: clicking on thumbnails will take you to the file description page on Wikimedia Commons or other file repository. This Disable feature works for registered users (using a site preference), as well as unregistered or 'anonymous' users (using a file stored locally on your computer).

Note that this Disable feature only works on the site where you activate it: disabling Media Viewer on Wikimedia Commons will not disable it on your home Wikipedia or other sister projects.

If you are a registered user, you can also disable Media Viewer in your "Preferences": select the "Appearance" section, and uncheck this option under "Files":  '[  ] ’. Once you click "Save", images will no longer open in Media Viewer for your account on that site.

If you change your mind and wish to re-enable Media Viewer, follow the instructions below.

How can I re-enable this feature?


If you have turned off Media Viewer and wish to re-enable it, visit any file description page on the site where you wish to use this tool. Then click on the 'cogs' icon next to the "Open in Media Viewer" button below that image: this will open it in Media Viewer, with the Enable panel open (see screenshot). Now click on "Enable Media Viewer". This Enable feature works for registered users (using a site preference), as well as unregistered or 'anonymous' users (using a file stored locally on your computer).

Note that this Enable feature only works on the site where you activate it: enabling Media Viewer on Wikimedia Commons will not enable it on your home Wikipedia or other sister projects.

If you are a registered user, you can also re-enable Media Viewer in your "Preferences": select the "Appearance" section, and check this option under "Files":  '[  ] ’. Once you click "Save", images will open in Media Viewer again for your account on that site.

How can I view an image in Media Viewer without enabling this feature?
If you have turned off this feature but wish to view an image in Media Viewer without re-enabling the tool permanently, visit its file description page. Then click on the "Open in Media Viewer" button below that image: this will open it in Media Viewer, but only for that image at that time.

Note that you can sometimes open an image in Media Viewer without enabling that feature by clicking on a link that includes the Media Viewer parameters at the end of the URL (e.g.: '#mediaviewer/File:foo.jpg').

How can I close Media Viewer?


You can close Media Viewer in a couple different ways:
 * click on the ‘X’ button at the top right of the Media Viewer panel (see thumbnail to the right)
 * press the ‘escape’ key on your keyboard

In some cases, you can also click on the ‘Back’ button on your browser to go back to the page where a Media Viewer image was linked.

How can I view more information?


Media Viewer shows basic information on the image you are viewing, right at the bottom of the screen. This includes the file name, the author and/or source, as well as license information.

For more information, simply scroll down to see a ‘metadata panel’ that includes: image description, who uploaded this file, when it was created or uploaded -- as well as links to Media Viewer information, such as this help page. (You can also click the arrow icon, or the top or down arrow keys on your keyboard to see this panel.)

If you would like even more information, click on the big blue 'More details' button, which lets you view or edit the file description page on Wikimedia Commons or other file repository.

How can I browse through a collection of images?


To browse through all the images in a collection, you can use the Next and Previous arrow buttons, which appear to the left and right of the image in Media Viewer (see thumbnail to the right).

A collection can include all the images in an article, a gallery or a category page. You can also use the left and right arrow keys on your keyboard for this feature.

How can I view an image in full-screen?


To see an image in full screen, click on the full screen button at the top right of the Media Viewer panel (its icon features two opposing arrows - see thumbnail to the right).

This will show a large image across your entire screen, not just the browser window. This full-screen view is completely uncluttered, so you can focus exclusively on the image, with no other distractions. In this mode, you only see the controls, the file name and the author/source/license if you hover over the image.

To exit full screen mode, you can click on the same button to return to the light box view — or select the close ‘X’ button to exit Media Viewer.

How can I enlarge an image?


To enlarge an image, simply click on it. (As a reminder, your cursor turns into a magnifier icon when you hover over an image.)

This will open the original image in its largest size, on Wikimedia Commons or the file repository site where it was first uploaded.

You can then use your browser zoom feature to examine details of the image, or right-click it to use this file in a variety of ways. In this view, the Media Viewer controls disappear completely, so you can interact the image directly.

To view the image in Media Viewer again, simply click the 'back' button in your browser.

How can I view images in different sizes?
To view images in different sizes, click on the ‘Download’ button (the down arrow icon at the lower right corner of the screen). This opens the ‘Download' panel, with the original image size pre-selected.

To pick a different size, click the green down arrow button and select the size that best fits your needs (e.g. Small, Medium or Large).

Then click on 'View in browser' below the green button to open the file at that size, in a separate tab.

How can I download an image?
To download an image, click on the ‘Download’ button (the down arrow icon at the lower right corner of the screen). This opens the ‘Download' panel, with the original size pre-selected. Click on the green button to download that original file, using your browser’s tools.

To download an image in a different size, click the green down arrow, where you can pick the size that best fits your needs (e.g. Small, Medium or Large). Then click the green button again to download that image size. You can also preview any of these sizes, before you download: click on 'View in browser' below the green button to open the file at the selected size.

Please check the license terms of a file before downloading it for your use, to confirm that your use is covered. Also, please include all required attribution and license credits to comply with those terms: these credits are now included in the Download panel, under 'You must attribute the author'. Click on that label to get the full credits, which you can copy and paste in either plain text or HTML.

How can I share an image?


To share images you find in Media Viewer, click on the ‘Share / Embed’ button (the curved arrow icon at the lower right corner of the screen - see thumbnail to the right). The 'Share' tab is shown first, and includes show a link to the selected image, which you can copy and paste to share it with your community. Note that for now, this link will open the image in Media Viewer on its file repository page (e.g. Commons), not on the page where you found it.

How can I embed an image on another page?
To use an image on another wiki page or on other web sites, click on the ‘Share / Embed’ button (the curved arrow icon at the lower right corner of the screen - see icon to the right). Then click on the 'Embed' tab. This will show the code needed to display the selected image, which you can copy and paste into your page’s code.

To add an image on a wiki page, select ‘WikiText’. To include it on a standard web page, select ‘HTML'. The required attribution and license info is included in the HTML code, along with corresponding links.

A size selector lets you pick the size that best fits your page. Note that you can also change the width or height of an image in the code itself.

Please check the license terms of a file before embedding it on a page, to confirm that this use is covered. Also, please include all required credits and links to comply with those terms.

How can I tell if an image can be re-used and what its license terms are?
Many of the images you find in Media Viewer can be re-used freely, as long as you provide attribution and you comply with their license terms. For example, some images are licensed under Creative Commons terms (e.g. CC-BY or CC-BY-SA). Others are public domain or some other form of free content licensing.

To find out what these license terms mean, simply click on the license link next to the image title. In some cases, it will show you the license details on the Creative Commons site. In other cases, it will show the license in in the metadata panel -- or it will go to the file description page on the repository site, where you can learn more.

If an image has special licensing terms or requires special credits or permissions, a ‘view terms’ link will be added next to the image title. Clicking it will show the permissions details and special requests from the author or source.

How can I edit or discuss an image?
To edit, curate or discuss an image, you need to go to its file description page on Wikimedia Commons or other file repository.

You can do this by clicking on the big blue ‘More details’ button, at the lower right corner of the screen.

A site icon in the 'More details' button shows whether it links to Wikimedia Commons or another file repository (indicated with a 'W' logo).

How can I link to an image from wikitext?
To link to an image so that it opens in Media Viewer, you can use this wikitext code:

How can I disable Media Viewer for unrelated images?
Sometimes, Media Viewer displays images that are confusing or not suitable for viewing with this tool. If necessary, editors can prevent these images from appearing in Media Viewer, using one of the methods below.

(please only use this method to mark elements in articles that are considered not to be part of the proper content of the article: annotations, maintenance templates, navigation links, media controls, etc.)
 * For images contained in 'metadata' content that is not related to the page's topic (e.g. Template:Ambox icons): you can disable Media Viewer for these files by adding this "metadata" class around their image tag:

(please only use this method to mark images that cannot be viewed effectively in Media Viewer because important details are hard to view with this tool; this method is intended for special cases, not for widespread use with images that can be viewed well in Media Viewer.)
 * For other images that are not 'metadata' files, but do not display properly in Media Viewer (e.g. maps or diagrams with unreadable labels, small icons, flags): you can disable Media Viewer for these files by adding this "noviewer" class inside their image tag:

Which platforms does Media Viewer support?
For this first release, Media Viewer now works on most modern web browsers for desktop computers: Chrome, Firefox and Safari's latest stable versions -- as well as Internet Explorer versions 9 and above. At this time, Media Viewer does not work on IE8 and below, and it is disabled for mobile devices. In future releases, we plan to provide a mobile version of Media Viewer, as well as wider browser support on desktop platforms.

Which file formats does Media Viewer support?
For this first release, Media Viewer only supports the most widely used image file formats (e.g.: JPEG, GIF, PNG, TIFF, SVG). In future releases, we will add support for PDF, audio, video and other file formats.

How can I report a technical issue?
We welcome bug reports from our community. If you find a technical issue, please [//bugzilla.wikimedia.org/enter_bug.cgi?product=MediaWiki%20extensions&component=MultimediaViewer file a bug here on Bugzilla].

However, we appreciate that Bugzilla isn't the easiest system to use; you can also post your report on this discussion page, with a screenshot and information on your browser and operating system :).

Before reporting a bug, check first that this issue is not already on [//bugzilla.wikimedia.org/buglist.cgi?resolution=---&component=MultimediaViewer this list of known bugs]. In case it’s already been fixed, you may also want to test it on this test page on MediaWiki.org -- where new features are released a week before the rest of the wikis.

How can I discuss new features for this tool?
We would like to know what you think of Media Viewer and invite you to participate on this discussion page.

Tens of thousands of users around the world helped test Media Viewer during its development. Here is an overview of the feedback they have kindly given us to help improve this tool. Many of their suggestions are now being implemented, as part of our [https://wikimedia.mingle.thoughtworks.com/projects/multimedia/cards/grid?aggregate_property%5Bcolumn%5D=story+points&aggregate_property%5Brow%5D=story+points&aggregate_type%5Bcolumn%5D=sum&aggregate_type%5Brow%5D=sum&color_by=type&filters%5B%5D=%5BType%5D%5Bis%5D%5BStory%5D&filters%5B%5D=%5BType%5D%5Bis%5D%5BBug%5D&filters%5B%5D=%5BType%5D%5Bis%5D%5BTech+debt%5D&filters%5B%5D=%5BType%5D%5Bis%5D%5BScope+Increase+%28UNPLANNED%29%5D&filters%5B%5D=%5BType%5D%5Bis%5D%5BTeam+Meetings%5D&filters%5B%5D=%5BSprint%5D%5Bis%5D%5B%28Current+sprint%29%5D&group_by%5Blane%5D=status&group_by%5Brow%5D=blocked&lanes=Ready+for+Development%2CIn+Development%2CReviewed%5C%2C+Awaiting+Improvements%2CAwaiting+Code+Review%2CReviewed%5C%2C+Awaiting+Other+Input%2CReady+for+Testing%2CIn+Testing%2CReady+for+Signoff%2CAccepted%2CIn+Analysis&style=grid&tab=Current+cycle current cycle plan].

Where can I find technical information about Media Viewer?
For more technical information about this tool, visit these two extension pages: MultimediaViewer and CommonsMetadata on MediaWiki.org.

How was Media Viewer tested and released?
Media Viewer was tested extensively for over seven months by tens of thousands of beta users around the world, starting in November 2013, as part of the Beta Features program. This allowed users to enable Media Viewer long before it was released on their sites, by clicking on the small 'Beta' link next to 'Preferences' in their personal menu.

We also conducted rigorous usability studies throughout development, such as this recent usability test -- and ran extensive user surveys with over 18,000 responses in 8 different languages. Additional community suggestions were collected through this widely promoted community consultation on many large wikis around the world, as well as as our regular talk page.

After addressing key issues identified by our testers, Media Viewer v0.2 was gradually released between April and June 2014. Local deployments took place on different sites every week, through the middle of June, 2014, when this feature was enabled by default on all wikis hosted by the Wikimedia Foundation. We are now doing another round of improvements based on more recent user feedback, as outlined below.

For more information, check out this release page.

What new features are being planned for Media Viewer?
The Wikimedia Foundation's multimedia team is testing and developing a range of new improvements, based on usability research and community feedback.

Based on this research and feedback, the multimedia team has identified a set of new improvements, which can be previewed in this prototype.

Here are the improvements we plan to make in September and October 2014, to make Media Viewer easier to use by readers and casual editors, our primary target users for this tool.

To that end, we created a new 'minimal design' including these features:
 * a more prominent button linking to the File: page
 * an easier way to enlarge images
 * clearer icons for Download and Share
 * an easier way to disable the tool for personal use
 * image captions right below the image

To learn more about other planned development for Media Viewer, visit this Improvements page, where our team will post regular updates on our next development cycle.

To prepare for future releases, we would love to hear which of these features seem most important to you. If you have any suggestions for improving this tool, please let us know on this discussion page.