This plugin hasn’t been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

WP-Slimbox2 Plugin


A WordPress implementation of the stellar Slimbox2 script by Christophe Beyls (an enhanced clone of the Lightbox script) which utilizes the jQuery library to create an impressive image overlay with slide-out effects.

Almost, if not all, options are configurable from the administration panel. For more on the settings and what they do check out the Slimbox2 page.

Support forums are generously hosted by Ryan Hellyer of PixoPoint, here.

Recent Changes in v1.1.3.1:
1. Changed index.php to UTF-8 without BOM encoding to resolve issues for some users.
Recent Changes in v1.1.3:
1. Updated to Slimbox 2.05 to support WordPress 3.6
2. Removed unnecessary xfarbtastic.css


Thanks to the following for help with the development of this plugin:

  • Christophe Beyls – Creator of the Slimbox2 Javascript
  • George McGinley Smith – Creator of the jQuery Easing Plugin Javascript
  • Steven Wittens – Creator of the jQuery Farbtastic colorpicker Javascript
  • Ryan Hellyer – For spurring my interest in WordPress plugins by welcoming my assistance on his Multi-level Navigation plugin and for hosting our support forums.
  • Spi for code suggestion to autogroup items by post.
  • nv1962 – Suggestion to implement localization and Spanish/Español and Dutch/Nederlandse translations.
  • Laws for German/Deutsch localization.
  • monodistortion for CSS tweaks to prevent tiling of images.
  • Jandry for the French/Français translation.
  • Serhat Yolaçan for the Turkish/Türkçe translation.
  • Marcis G. for the Belarusian/Беларускі translation.
  • easespot for the Chinese/中文 translation and FunDo for additional assistance.
  • Marcelo for the Brazilian Portuguese/Português brasileiro translation.
  • Giacomo for the Italian/Italiano translation.
  • Nata Strazda of Web Hub for the Lithuanian/Lietuviškai translation.
  • ackie00h for the Japanese/日本語 translation.
  • nafanyabr for the Russian/русский язык translation.
  • shachi for the Traditional Chinese/繁體中文 translation.
  • Zareiff, for various Next/Previous/Close translation images when not provided by translators.
  • Anyone else I forgot to mention who’s made a suggestion or provided me with ideas.


  • Administration interface in WordPress 2.7
  • Overlay effect.


After you’ve downloaded and extracted the files:

  1. Upload the complete WP-Slimbox2 folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Visit the “WP-Slimbox2” page in your WordPress options menu to configure any advanced settings.
  4. Manually add the rel="lightbox" attribute to any link tag to activate the lightbox or rel="lightbox-imagesetname" for an image set, using the title attribute to store a caption. Alternatively you may use the autoload option to automatically prepare links to images and additionally enable picasaweb and flickr integration to easily utilize their albums.


Does Slimbox2 support the lightbox effect on pages and videos?

No. As stated in the script creators FAQ, Slimbox was designed to display images only, to be simple and to have the smallest code.

What kind of grouping does autoload utilize?

Autoload has been modified to group all images in a WordPress post if the theme places posts inside a div with class=”post”. If the images are instead on a page they will all be grouped together. If you want individual group sets it is recommend you instead manually insert ‘rel=”lightbox-groupname”‘ inside your hyperlinks to specify your groups.

Why do I need WordPress 2.8+?

The Javascript requires jQuery 1.3+ which wasn’t included in WordPress until 2.8. If you’re using something to override the included jQuery with a newer version (a feature I may add at a later date) it should be compatible from 2.1+ since I believe that was when wp_enqueue_script() was implemented.

Why can’t the plugin do X, Y or Z?

Either the Javascript doesn’t support it, or I haven’t gotten around to adding it.

Why can’t the plugin resize images?

Please see this excerpt from the FAQ by the creator of Slimbox, Christophe Beyls

Why isn’t the plugin in my language? Could I contribute a translation?

I only know English, but as of v.0.9.4 the plugin supports localization using PO and MO files, just like WordPress.
A copy of the POT file to use in your translations can be found in the languages directory as wp-slimbox2.pot.
If you’re willing to provide a translation I’d be more than happy to include it. The NEXT, PREV, and Close buttons can be translated as well.
If you’ve translated the plugin or would like to find out more please let me know by posting on our support forums.

Why should I use this plugin?

You want Lightbox or Slimbox effects using the jQuery library, and don’t want any sort of “ad”.
You want complete control over all the javascript settings from the admin page.

What if I have other questions that haven’t been answered?

Please try our support forums, and read the Slimbox creator’s FAQ.

Contributors & Developers

“WP-Slimbox2 Plugin” is open source software. The following people have contributed to this plugin.


“WP-Slimbox2 Plugin” has been translated into 1 locale. Thank you to the translators for their contributions.

Translate “WP-Slimbox2 Plugin” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog – Aug-28-2013

  • Changed index.php to UTF-8 without BOM encoding to resolve issues for some users.

1.1.3 – Aug-24-2013

  • Updated to Slimbox 2.05 to support WordPress 3.6
  • Removed unnecessary xfarbtastic.css

1.1.2 – Mar-24-2012

  • Utilizes built in Farbtastic javascripts.
  • Consolidated load_farbtastic and keypress.js
  • Moved CSS files to css folder.

1.1.1 – Feb-22-2012

  • Fix to resolve failures experienced by some users in v1.1.

1.1 – Jan-31-2012

  • Extensive re-write including several minor fixes to eliminate PHP warnings and errors.
  • Ability to use rel="nolightbox" to exclude an image.
  • Ability to customize image link URLs by simply placing ‘/DESIRED URL/’ in front of the caption.
  • Grouping of Flickr, Picasa and other images combined. Autoload groups by selector, lightbox groups by rel.
  • Removal of WPlize in favor of built in option arrays.
  • Fix for settings initialization issues.
  • Option sanitization.
  • Addition of Traditional Chinese/繁體中文 translation.
  • Removed localization tracking. – Jan-25-2012

  • Addition of Russian/русский язык translation. – Dec-18-2011

  • Addition of Brazilian Portuguese/Português brasileiro translation.
  • Addition of Italian/Italiano translation.
  • Addition of Lithuanian/Lietuviškai translation.
  • Addition of Japanese/日本語 translation.
  • Removal of encodeURI() to eliminate issues with images having spaces. – May-04-2010

  • Fix for defaults in new installs. – May-03-2010

  • Forgot to commit one of the RTL specific changes.

1.0.3 – May-02-2010

  • Updated to Version 2.0.4 of Slimbox.
  • Added encodeURI to autoload script to automatically fix URLs containing invalid characters.
  • All “fixed” CSS moved to static CSS files, addition of RTL specific CSS.
  • Addition of Belarusian/Беларускі Translation.
  • Addition of Chinese/中文 Translation.
  • Update of Spanish/Español and Dutch/Nederlandse Translations.
  • Update of German/Deutsch Translation.
  • Addition of Localization Tracking (see FAQ for details).
  • Minor fixes/tweaks.

1.0.2 – Jan-21-2010

  • Fixed IE Javascript issue.
  • Fixed potential XSS vulnerability and rare inability to update.
  • Addition of Turkish/Türkçe Translation.
  • Update of French/Français Translation.

1.0.1 – Jan-20-2010

  • To accomodate some installs the global options variable was removed.
  • To repair a small issue regarding selectors, .closest was used instead of .parents, bumping the jQuery requirement to 1.3, in turn bumping the WP requirement to 2.8. (If you insist on using an older version of WP, you can either manually upgrade jQuery, or switch back to using .parents, and specifically choose the selector value you want to use).

1.0 Beta – Jan-19-2010

  • Addition of options to select caption source, render the caption as a hyperlink to the image, control autoload grouping element, and disable the effect on mobile phones.
  • Initialization is now encapsulated within a function (usable in Infinite Scroll plugin, etc)
  • All Javascript is now static, no more dynamic files.
  • All Javascript and CSS compressed using YUI Compressor.

0.9.7 Beta – Apr-21-2009

  • Addition of farbtastic overlay color select.
  • Automatic key code recognition.
  • Addition of French/Français and Dutch/Nederlandse languages.
  • Options transferred to WPlize class, less database calls.
  • Flickr and Picasaweb images now properly load Slimbox settings.
  • Minor typographical corrections.

0.9.6 Beta – Feb-19-2009

  • Added rudimentary German/Deutsch translation – thanks Laws
  • Tiling Next/Prev Links in Safari Fix – thanks monodistortion
  • Switch from wp-blog-header to wp-load, may resolve issue on certain servers that fail to properly serve dynamic JS and CSS

0.9.5 Beta – Feb-01-2009

  • Added minor IE6 fix to prevent tiling of next and previous images in a unique scenario.
  • Español/Spanish language typo correction.
  • Updated to Slimbox 2.02 (and adjusted version # accordingly, see Slimbox website for more details)
  • Support for RTL languages added (proper image progression and button display)
  • Caching/compression reenabled on javascript – cache for one year, or until version change which occurs on option update.
  • Support options on autoloaded image files (ie .jpg?w=400 now is properly detected) Beta – Jan-24-2009

  • Removed caching of autload script, for real this time.

0.9.4 Beta – Jan-24-2009

  • Localization support implemented. Currently only Español/Spanish provided. See FAQ to contribute other languages. Removed caching of autload script, at least for now.

0.9.3 Beta – Jan-14-2009

  • Flickr and Picasaweb Integration, Slimbox 2.01, maintenance mode, autogrouping by post/page, compression and caching Beta – Jan-08-2009

  • Bug fix. Autoload wasn’t loading options. – v0.9.2.3 Beta – Jan-07-2009

  • Emergency Admin for minor overlay opacity setting error Beta – Jan-07-2009

  • Emergency JS Fix

0.9.2 Beta – Jan-07-2009

  • Addition of option to change the overlay color

0.9.1 Beta – Jan-06-2009

  • Addition of option to enable automatically applying to all image links (png,jpg,gif)

0.9 Beta: Intial release – Jan-05-2008