From MediaWiki.org
Jump to: navigation, search
MediaWiki extensions manualManual:Extensions
Crystal Clear app error.png

Release status:Extension status unstable

ImplementationTemplate:Extension#type Skin, User interface
DescriptionTemplate:Extension#description Displays full-size images with Lightbox 2 when clicking on thumbnails.
Author(s)Template:Extension#username Alxndrtalk
Latest versionTemplate:Extension#version (3 Aug 2010)
MediaWikiTemplate:Extension#mediawiki 1.11-1.13, 1.15, 1.16
LicenseTemplate:Extension#license CC BY-NC 3
Download from GitHub
ExampleTemplate:Extension#example http://chrishecker.com/Sandbox/Gallery

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

Check usage and version matrix.

LightboxThumbs incorporates Lokesh Dhakar's fullsize image viewer Lightbox 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.

Images in galleries are treated as being part of a slideshow, and have "previous" and "next" images.


  • Very large images may take over your screen! That is, it doesn't do any resizing.
  • If there are multiple galleries on one page, they are treated as being part of one big slideshow.
  • May not work with images that have slashes in the name.

Caveat ūsor[edit]

This was originally developed on an installation of 1.11 with an old custom skin and a bunch of extensions and a lot of general hackery. Unforeseen behavior is a very real possibility.

That said, let me know and I'll try to help fix anything that goes wrong.


Thanks to Piotr, Timmy, and Georges for helping me debug and test new versions of v0.1.3.

Thanks to Kinsey Moore, Rgoodermote, and Michael Markert for taking the ball and running to create v0.1.4, with bug fixes and tweaks to get it working in MW 1.16.


  1. Get a copy of LightboxThumbs.php and save into your extensions/ directory. The newest version is always here, but if you're using an older (<1.16) version of MW, look at these:
    • MW 1.11 to 1.15(ish?): Try v0.1.3
    • MW <1.10: Try v0.1.2 and cross your fingers
  2. Download Lokesh Dhakar's Lightbox 2 and place somewhere on your server.
  3. Rename lightbox2 directory to lightbox and move to the extensions directory.*
  4. Edit lightbox.js: change fileLoadingImage and fileBottomNavCloseImage so they're indicating where the images actually are.*
  5. Edit LocalSettings.php to add:
$lightboxThumbsFilesDir = '/w/extensions/lightbox';

* Note: Please make sure that the js and image files can be read.

See also[edit]