Simple Lightbox

The highly customizable lightbox for WordPress

Beta Time! Simple Lightbox 2.0 Beta is here.  Grab the latest version and start testing!

Simple Lightbox is a free plugin for WordPress that lets you add a very simple and customizable lightbox image viewer (Javascript-based popup image viewer) to your WordPress website.  It also supports themes to allow the best possible integration with your site’s theme.

Features

  • Supports links in Widgets (New)
  • Supports Image Attachment links
  • Display image metadata (caption, description, etc.) in lightbox
  • Automatically activate links (no manual coding required)
  • Keyboard Navigation
  • Link Validation (optional)
  • User-customizable skin (template) support
  • Enable Lightbox depending on Page Type (Home, Pages, Archive, etc.)
  • Group image links (play as a slideshow)
  • Group image links by Post (e.g. separate slideshow for each post on home page)
  • Group gallery links separately from the rest of the links in a post
  • UI/Animation Customization
  • Slideshow Customization
  • Backwards-compatibility with legacy lightbox links

Installation

  • Install and activate Simple Lightbox on your site (help)

Usage

  1. Insert links to images into your post (WordPress Documentation)

That’s it! The image will be displayed in a lightbox viewer automatically.

Need a bit more help? Simple Lightbox for Noobs: The Beginner’s Guide to Using SLB.

Notes

  • Images are displayed at their original size to maintain optimum image quality.  Resizing images to their desired display size prior to uploading is recommended.
  • You can manually add rel="slb_off" to any image links that you do not want to be displayed in a lightbox

Support

Found a bug or otherwise experiencing an issue with Simple Lightbox?  Report the issue here.

Details

Version:
1.6.3.1
License:
GPL v2

Requirements

  • WordPress 3.3.2+
    • SLB has the same minimum requirements as WordPress itself.
    • SLB requires the jQuery library officially included with WordPress.  If any other version is loaded (manually or by other plugins/themes), SLB may not function properly.
  • Verify that your site's theme uses the following template tags (standard in any professional theme)
    • wp_head()
    • wp_footer()
    • the_content()

Download

Version History

1.6.3.1

  • Fix: Backward compatibility restored (Backward Genius)

1.6.3

  • Optimize: Improved lightbox overlay display

1.6.2

  • Update: Rebuild JS code
  • Optimize: Improved compatibility with PHP 5+
  • Optimize: Improved utility code
  • Fix: Some elements can overlap lightbox
  • Fix: Slideshow not automatically starting (Laurence of Autoplay)

1.6.1

  • Optimize: Handle repeated initializations of lightbox on client-side
  • Fix: Localization not properly loaded (Mustafa Lingo)

1.6

  • Add: Widget support
  • Add: WordPress 3.3 support
  • Add: Localization support
  • Add: Option to group gallery links separately (supports WordPress & NextGen galleries)
  • Add: Upgrade notice
  • Optimize: WP 3.3 compatibility
  • Optimize: Improved compatibility with URI case-sensitivity
  • Optimize: Activation processing
  • Optimize: Image grouping
  • Optimize: Image metadata loading performance
  • Optimize: File loading
  • Optimize: Improved safeguards against interference by bugs in other plugins
  • Optimize: Link processing performance
  • Optimize: Lightbox styling isolated from site styles
  • Optimize: Improved link processing performance
  • Optimize: Improved image metadata support
  • Optimize: Improved support for HTTP/HTTPS requests
  • Fix: SLB is not defined in JS (Jezz Hands)
  • Fix: Boolean case-sensitivity (78 Truths)
  • Fix: YouTube embed using iFrame overlaps lightbox (Elena in Hiding)
  • Fix: Issue when scanning links without valid URLs (McCloskey Iteration)
  • Fix: Image activation is case-sensitive (Sensitive Tanya)
  • Fix: Visible lightbox overlay edges when image larger than browser window (Chibi Overlay)
  • Fix: Options availability for some users
  • Fix: Inconsistent loading of image metadata
  • Fix: Links not fully processed when group is set manually

1.5.6

  • Add: Display image description in lightbox (with HTML support)
  • Add: Support for W3 Total Cache plugin
  • Add: Initial support for NextGEN galleries
  • Update: Important: System Requirements aligned with WP 3.2.1
  • Optimize: Improved support for small images in default template
  • Optimize: Support for non-English text in user options
  • Optimize: Improved IE compatibility
  • Optimize: Improved data handling
  • Optimize: Skin loading performance
  • Optimize: Skin CSS Cleanup
  • Optimize: Caption support for galleries
  • Optimize: Options code cleanup (Juga Sweep)
  • Fix: User-defined UI text not used (Ivan gets Even (cooler))
  • Fix: Options reset after update (KRazy Donna)

1.5.5.1

  • Fix: Disabled links not being disabled (Disabling Sascha)

1.5.5

  • Add: Distinct link activation (will not affect other lightboxes)
  • Add: Backwards compatibility with legacy lightbox links (optional)
  • Add: Support for WordPress 3.2
  • Add: Support for links added after page load (e.g. via AJAX, etc.)
  • Add: Admin option to enable/disable attachment links
  • Add: Support for image attachment links
  • Update: Options management overhaul
  • Update: Additional WordPress 3.2 support (Gallery)
  • Update: Cache-management for enqueued files
  • Update: Improved UI consistency
  • Update: Improved compatibility for older versions of PHP
  • Update: Internal optimizations
  • Update: Improved URL handling
  • Fix: Improved options migration from old versions (Hutchison Migration)
  • Fix: XHTML Validation (Hajo Validation)

1.5.4

  • Add: Optional Link validation
  • Add: Keyboard Navigation
  • Add: Option to enable/disable image caption
  • Add: `rel` attribute supported again
  • Add: Use `slb_off` in link's `rel` attribute to disable automatic activation for link
  • Optimize: Filter double clicks
  • Optimize: Separate options to enable/disable SLB on Posts and Pages
  • Optimize: Better grouping support
  • Fix: HTTPS compatibility (Jürgen Protocol)
  • Fix: Enabling SLB on Pages issue
  • Fix: Zmanu is_single
  • Fix: Image order is sometimes incorrect

1.5.3

  • Update: Lightbox will not be activated for links that already have `rel` attribute set
  • Fix: Caption may not display under certain circumstances (Caption Erin)
  • Fix: Images not grouped when "separate by post" option is activated (Logical Ross)

1.5.2

  • Add: Option to use the image's URI as caption when link title not set (Under UI options)
  • Fix: Slideshow loops out of control (Mirage of Wallentin)
  • Fix: Lightbox fails when group by posts disabled (Lange Find)

1.5.1

  • Added: WP Gallery support
  • Fixed: Navigation hidden when only one image
  • Fixed: Use user-defined UI text

1.5

  • Add: Theme support
  • Optimize: Performance optimizations

1.4

  • Add: Close lightbox by clicking to left/right outside of image (an oft-requested feature)
  • Update: Integrated with jQuery
  • Optimize: Javascript filesize 9x smaller

1.3.2

  • Add: Option to enable/disable lightbox resizing animation (thanks Maria!)

1.3

  • Add: Customizable UI label text (close, next, and prev button images can be replaced in images directory)
  • Add: Group image links by Post (separate slideshow for each post)
  • Add: Reset settings link on plugin listings page
  • Optimize: Organized settings page  1.2.1 (2010-06-15)
  • Fix: Image title given higher precedence than Image alt (more compatible w/WP workflow)

1.2

  • Add: Option to group automatically activated links (for displaying as a slideshow)
  • Optimize: Lightbox caption retrieval

1.1

  • Add: Enable/disable lightbox functionality by page type (Home, Pages/Posts, Archive, etc.)
  • Add: Automatically activate lightbox functionality for image links
  • Add: Link to settings menu on plugin listing page
  • Optimize: Options menu field building
  • Optimize: Loading of default values for plugin options
  • Optimize: General code optimizations

1.0 (2010-05-29)

  • Initial Release

Credits/Acknowledgments

The lightbox functionality of this plugin was originally based on Lightbox Slideshow by Justin Barkhuff, but has undergone major changes as it entered puberty.

Discuss

654

Sol

April 2, 2013 8:30 am

@khoa ho: Make sure Grouping is enabled in SLB’s settings. If you have multiple image links in a post, then they will be grouped and the prev/next buttons will be displayed.

khoa ho

April 2, 2013 8:49 am

Thanks for fast replying, the problem is I use simple plugin with NGG Gallery. So images is in the plugin’s gallery folder not in posts or pages.

Sol

April 2, 2013 11:50 am

@khoa ho: Grouping should work with NGG galleries as well. Please follow the link in the Support section above so that your issue can be investigated further.

Ron

April 16, 2013 4:06 pm

How can I set this up to work for videos?

Sol

April 17, 2013 8:34 am

@Ron: Video support is coming

David

April 25, 2013 7:22 am

Hey there! Awesome plugin, really admire and appreciate the clean settings and default skin! I am having one hiccup though,

I’d like to be able to group sets of images, so that they don’t cycle through every SLB link on a page, for example.

Group 1: 6 images
Group 2: 16 images,

etc.

Is there an attribute I can specify so that the grouping is controllable?

Crais

April 26, 2013 1:24 am

How do you disable this plugin on certain pages, and enable it on other pages?

Sol

May 1, 2013 1:11 pm

@David: You can create separate groups of images in a single post by creating and inserting a gallery for each group of images. As long as the Group gallery links separately option is enabled, each gallery will be a separate group.

@Crais: SLB can be enabled/disabled for different page types. See the Activation section in SLB’s settings for the available options.

eaglejohn

May 20, 2013 11:29 pm

Could you please remove the beta version from the WordPress repositories? The ‘update’ is shown besides the regular updates, this is causing a lot of confusing and problems for clients.

Sol

May 24, 2013 7:41 am

@eaglejohn: Most users are happy to get access to new features of prerelease versions, though I can see how it may be confusing to some users despite the additional notice that we display when a prerelease update is available. A solution to accommodate all users is being developed.

Leave a comment

Please report issues and other support requests via Simple Lightbox's official support system.

Comments containing support requests will be deleted immediately.