Lightbox

The SiteOrigin Premium Lightbox addon provides image lightbox functionality for the following SiteOrigin widgets:

  • Image Widget
  • Image Grid Widget
  • Simple Masonry Widget
  • Slider Widget

View the Lightbox addon demo.

Requirements

To make use of this addon, go to PluginsSiteOrigin Widgets and ensure the SiteOrigin Image, SiteOrigin Image Grid, SiteOrigin Simple Masonry and SiteOrigin Slider widgets are activated, assuming you’d like to use them all. Next, go to SiteOriginPremium Addons and activate the Lightbox addon.

Usage

Within each of the above widgets you’ll find the following options:

Enable Lightbox
Enabling this checkbox will override the destination URL set for the image in the widget and open the image in a lightbox when the image is clicked.

Album Name
To include your lightbox images in a single gallery on the page, insert an album name. Images with the same album name will be displayed together.

Global Settings

Global settings for the Lightbox addon can be found at SiteOriginPremium AddonsLightboxSettings. Global settings apply to all lightboxes. The following options are available:

Always show navigation controls on touch devices
Enable to show navigation controls on touch devices, thereby not only relying on swipe actions.

Disable on tablet
Disable all lightboxes on tablet devices. Tablet width is set at SettingsPage BuilderLayout.

Disable on mobile
Disable all lightboxes on mobile devices. Mobile width is set at SettingsPage BuilderLayout.

Disable page scrolling when the lightbox is open
Enable to prevent the page from being scrollable when the lightbox is open.

Overlay color
The background color of the lightbox overlay. Defaults to black, #000.

Overlay opacity
The opacity of the lightbox overlay. Defaults to 0.8.

Fade duration
Time, in milliseconds, for the lightbox container and overlay to fade in/out. Defaults to 600.

Fit images in viewport
Resize images that are too large to fit in the current viewport.

Image fade duration
Time, in milliseconds, for an image to fade in, once loaded. Defaults to 600.

Max image height in pixels
Optionally set the maximum height for all lightbox images.

Max image width in pixels
Optionally set the maximum width for all lightbox images.

Top offset
Position, in pixels, of the lightbox from the top of the viewport. Defaults to 50.

Resize duration
The time it takes for the lightbox container to animate its width and height when transitioning between different size images, in milliseconds. Defaults to 700.

Show image number label
Show text indicating the current image number and the total number of images in the set.

Disable captions for all lightboxes
Prevent image captions from displaying in all lightboxes.

Wrap around
Go back to the first image when the last image is reached.