Extension:SlimboxThumbs

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

Release status: beta

SlimboxThumbs.png
Implementation User interface
Description Displays full-size images with Slimbox 2 when clicking on thumbnails.
Author(s) Vitaliy Filippov, David Raison, Jeroen De Dauw
Latest version 2013-02-25 (2013-02-25)
MediaWiki 1.13+
PHP 5.2+
License GPL 3.0 or later
Download Template:WikimediaDownload/gerritonly
Example http://yourcmc.ru/wiki/WINNIE
Hooks used
BeforePageDisplay

Translate the SlimboxThumbs extension if it is available at translatewiki.net

Check usage and version matrix; code metrics

Issues:

Open tasks · Report a bug

SlimboxThumbs incorporates Christophe Beyl's fullsize image viewer Slimbox 2 into MediaWiki's thumbnails and image galleries. Stable enough to use in production (but marked as beta for some evaluation period).

When a user clicks on a thumbnailed image or an image in a gallery, the page darkens and the image is displayed full-size "on top of" the page. A caption below the image includes the image's title and a link to its description page, along with the caption on the thumbnail, if any. Clicking anywhere off the image returns everything to normal.

SlimboxThumbs displays a lightbox for an image on the page if:

  • It is a thumbnail, and not already a full-sized image.
  • It is linked to an image page (File:Something.jpg). If the thumbnail is linked to a random URL or not linked to anything, there will be no lightbox - the idea is to have a way of cancelling lightbox for some images. Also you can link the thumbnail to another image's page, and this another image will be shown in the lightbox.

Such thumbnails, including images in galleries, are treated as being part of a slideshow, and have "previous" and "next" images. If an image is bigger than 90% of current viewport size, a respective thumbnail is shown using thumb.php.

Thanks to Alexander for creating the original Lightbox 2 version of this extension, yet the code isn't related to it anymore in any way.

This is a rewritten version of this extension which was discontinued by its original author, David Raison. Should work with MediaWiki 1.13 or a later one.

Setup[edit | edit source]

Download[edit | edit source]

The code now lives in Git. See "download" link in top of this page. Or:

git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/SlimboxThumbs

Installation[edit | edit source]

Place the SlimboxThumbs directory within the main MediaWiki 'extensions' directory. Then, in the file LocalSettings.php in the main MediaWiki directory, add the following line:

include_once("$IP/extensions/SlimboxThumbs/SlimboxThumbs.php");

Customization[edit | edit source]

To speed up the animation, edit slimbox/js/slimbox2.js as follows:

overlayFadeDuration:1
resizeDuration:1
imageFadeDuration:1
captionAnimationDuration:1

Release Notes[edit | edit source]

New version (by Vitaliy Filippov) changelog:

  • 2013-02-25 - Fixed compatibility with older MediaWikis down to 1.13 - was broken 2013-01-10 when the foreign repository support was introduced.
  • 2013-02-18 - Fixed duplicate lightboxes for images inserted as [[Image:Image.jpg|thumb]].
  • 2013-01-10 - Now compatible with foreign repositories.
  • 2012-10-18 - Fixed compatibility with MediaWiki 1.16.
  • 2012-09-17 - Fixed several bugs (which caused the lightbox to not work fully or partially sometimes). Can be treated as stable by now.
  • 2011-12-30 - Extension rewritten using JS instead of regexp voodoo, should work with any MediaWiki 1.13+, including 1.16 and later.

Changelog of the old version:

  • 0.0.5 - Fixed bug where pictures wouldn't be adequately resized if other image-links would be on the same page.
  • 0.1 - Included copy of Slilmbox, stylized code, added internationalization file, added settings file, renamed functions to follow MW convention and fixed several minor issues.

Dev[edit | edit source]

Bugs[edit | edit source]

  • If there are multiple galleries on one page, they are treated as being part of one big slideshow.
  • (NOT CHECKED IN NEW VERSION) This extensions conflicts with the GuMaxDD skin, resulting in the skins's DropDown menu not working.

Todo[edit | edit source]

  • (What for?) Use jquery's fancybox instead of slimbox
  • Change resize width & height on window.resize()

Troubleshooting[edit | edit source]

As always, try purging, refreshing (Ctrl-F5), etc. if it doesn't work.

See also[edit | edit source]