Extension:SlimboxThumbs

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
OOjs UI icon advanced.svg
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 2014-04-01 (2017-10-30)
MediaWiki 1.23+
PHP 5.3+
License GNU General Public License 3.0 or later
Download
Translate the SlimboxThumbs extension if it is available at translatewiki.net
Check usage and version matrix.
Issues Open tasks · Report a bug

The SlimboxThumbs extension incorporates Christophe Beyl's fullsize image viewer Slimbox 2 into MediaWiki's thumbnails and image galleries.

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 LightboxThumbs 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.

Installation[edit]

  • Download and place the file(s) in a directory called SlimboxThumbs in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    require_once "$IP/extensions/SlimboxThumbs/SlimboxThumbs.php";
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

Customization[edit]

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

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

Issues[edit]

  • If there are multiple galleries on one page, they are treated as being part of one big slideshow.

Troubleshooting[edit]

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

See also[edit]