The SiteOrigin Premium Lightbox Addon provides image lightbox functionality for the following SiteOrigin widgets:
- Image Widget
- Image Grid Widget
- Simple Masonry Widget
- Slider Widget
- SiteOrigin Premium Plugin
- SiteOrigin Widgets Bundle Plugin
- Optional: Page Builder by SiteOrigin Plugin
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.
Within each of the above widgets you’ll find the following options:
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.
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 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.
The background color of the lightbox overlay. Defaults to black,
The opacity of the lightbox overlay. Defaults to
Time, in milliseconds, for the lightbox container and overlay to fade in/out. Defaults to
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
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.
Position, in pixels, of the lightbox from the top of the viewport. Defaults to
The time it takes for the lightbox container to animate its width and height when transitioning between different size images, in milliseconds. Defaults to
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.
Go back to the first image when the last image is reached.