=== MetaSlider Lightbox - Image Lightbox, Gallery Lightbox, Video Lightbox, WordPress Lightbox ===
Contributors: 
Tags: lightbox, image lightbox, gallery lightbox, wordpress lightbox, video lightbox
Requires at least: 5.0
Tested up to: 6.8.2
Stable tag: 2.0.0
Requires PHP: 5.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Lightbox plugin for WordPress. Build your image lightbox, video lightbox, YouTube lightbox, slideshow lightbox, YouTube lightbox.

== Description ==

MetaSlider Lightbox is the lightbox plugin for WordPress. This plugin allows you to build an image lightbox, slideshow lightbox, image gallery lightbox, local video lightbox, YouTube lightbox, or Vimeo lightbox.


### MetaSlider Slideshow Lightbox

This lightbox plugin connects deeply with the MetaSlider slideshow plugin.

A slideshow allows you to create a beautiful showcase of images or videos for your visitors.

You can enhance your slideshow with a lightbox. Visitors can view your slideshow and then click on an image and see a larger, higher-resolution version of the image. Often the background is darkened so that the viewer’s eyes can focus on the image alone.

MetaSlider Lightbox supports every kind of slideshow created with MetaSlider except Layer Slides and Custom HTML.

### WordPress Image Lightbox

MetaSlider Lightbox allows you to add lightboxes to images in your WordPress post content. You can choose to automatically add the lightbox to all images, or you can do it manually via the "Enlarge on click" setting.


### WordPress Image Gallery Lightbox

MetaSlider Lightbox allows you to add lightboxes to image galleries in your WordPress post content. You can choose to automatically add the lightbox to all images, or you can do it manually via the "Enlarge on click" setting.


### Local Video Lightbox

MetaSlider Lightbox allows you to add lightboxes to local videos in your WordPress post content. You can choose to automatically add the lightbox to all images.

### YouTube Lightbox

MetaSlider Lightbox allows you to add lightboxes to YouTube videos in your WordPress post content. You can choose to automatically add the lightbox to all images.


### Vimeo Lightbox

MetaSlider Lightbox allows you to add lightboxes to Vimeo videos in your WordPress post content. You can choose to automatically add the lightbox to all images.


== Installation ==

= To install the plugin automatically: =
* Through WordPress admin, use the menu: Plugin > Add New
* Search for MetaSlider Lightbox
* Click on install then click the activation link

== Frequently Asked Questions ==

= Can I Connect to Other Lightbox Plugins to MetaSlider? =

Yes, a legacy feature in this plugin allows you to connect other Lightbox plugins to MetaSlider slideshows. We no longer support this feature, but it should still work. Here are the connected slideshows:

<ul>
<li><a href="https://wordpress.org/plugins/easy-fancybox/">Easy FancyBox</a></li>
<li><a href="https://wordpress.org/plugins/simple-lightbox/">Simple Lightbox</a></li>
<li><a href="https://wordpress.org/plugins/foobox-image-lightbox/">FooBox Image Lightbox</a> </li>
<li><a href="https://wordpress.org/plugins/wp-colorbox/">WP Colorbox Lightbox</a> </li>
<li><a href="https://wordpress.org/plugins/ari-fancy-lightbox/">ARI Fancy Lightbox</a></li>
</ul>

We also support the following WordPress plugins, although they haven't had recent updates, or sometimes go long periods without the authors fixing issues:<br>

<ul>
<li><a href="https://wordpress.org/plugins/responsive-lightbox/">Responsive Lightbox by dFactory</a></li>
<li><a href="https://wordpress.org/plugins/wp-lightbox-2/">WP Lightbox 2</a></li>
<li><a href="https://wordpress.org/plugins/wp-jquery-lightbox/">WP jQuery Lightbox</a></li>
<li><a href="https://wordpress.org/plugins/jquery-colorbox/">jQuery Colorbox</a></li>
<li><a href="https://wordpress.org/plugins/fancy-lightbox/">Fancy Lightbox</a></li>
<li><a href="https://wordpress.org/plugins/imagelightbox/">imageLightbox</a></li>
<li><a href="https://www.tipsandtricks-hq.com/wordpress-lightbox-ultimate-plugin-display-media-in-a-fancy-lightbox-overlay-3163">WP Lightbox Ultimate</a></li>
<li><a href="https://23systems.net/wordpress-plugins/lightbox-plus-for-wordpress/">Lightbox Plus</a></li>
</ul>

If you would like to use a lightbox plugin, you can filter the supported plugin list with the necessary attributes. For example, using <a target="_blank" href="https://wordpress.org/plugins/responsive-lightbox-lite/">Responsive Lightbox Lite</a>
<pre>
add_filter('metaslider_lightbox_supported_plugins', 'supported_plugins_list');
function supported_plugins_list($supported_plugins_list) {
    return array(
        'Responsive Lightbox' => array(
            'location' => 'responsive-lightbox-lite/responsive-lightbox-lite.php',
            'settings_url' => 'options-general.php?page=responsive-lightbox-lite',
            'rel' => 'lightbox',
            'attributes' => array(
                'data-lightbox-type' => 'iframe'
            )
        )
    );
}
</pre>





== Changelog ==

The format is based on [Keep a Changelog recommendations](http://keepachangelog.com/)
and this project adheres to [Semantic Versioning](http://semver.org/).

= [2.0.0] - 24 Jul, 2025 =

* ADDED: LightGallery.js implementation with built-in lightbox
  functionality, #70;
* ADDED: Admin settings page with color customization options, #49;
* ADDED: Thumbnail navigation toggle, #58;
* ADDED: Video support for local and external videos with Video.js
  integration, #85;
* ADDED: WordPress "Enlarge on click" override functionality, #50;
* ADDED: CSS per MetaSlider theme for better mobile compatibility, #77;
* ADDED: Tab focus accessibility on "Open in Lightbox" buttons, #86;
* ADDED: Icon hover color picker option, #114;
* FIXED: Lightbox animation smoothness when opening/closing, #41;
* FIXED: Arrows and close button visibility on mobile/tablet, #43;
* FIXED: Thumbnail navigation overlapping main image, #58;
* FIXED: Slide images being always linked, #62;
* FIXED: Clear button alignment issues, #72;
* FIXED: Color picker functionality without MetaSlider installed, #75;
* FIXED: PHPCS errors and security issues, #89;
* FIXED: External video loading issues, #107;
* FIXED: Post feed "Open in Lightbox" button clickability on mobile,
  #106;
* FIXED: Custom HTML slide display issues, #101;
* FIXED: Layer slide text sizing on mobile, #105;
* FIXED: MetaSlider theme compatibility (Radix, Databold, Highway), #91,
   #109;
* FIXED: Close button display on desktop, #45;
* FIXED: Unable to save disabled "Open in Lightbox" setting, #42;
* CHANGED: Made lightbox addition automatic for better UX, #38;
* CHANGED: UI improvements and dropdown labels, #60;
* CHANGED: Menu and save button design consistency, #113;

= [1.13.4] - 14 Mar, 2025 =

* CHANGED: Remove discontinued lightbox plugins on description list;

= [1.13.3] - 13 Mar, 2025 =

* CHANGED: Remove active installation stats on readme;

= [1.13.2] - 10 Jul, 2024 =

* ADDED: metaslider_admin_notices hook, #26;

= [1.13.1] - 12 Oct, 2021 =

* FIXED: Lightbox setting is broken if using MetaSlider v3.27.13, #18;
* CHANGED: Remove Extendify library;

= [1.13.0] - 13 Jul, 2021 =

* CHANGED: Update the library.

= [1.12.2] - 7 Jul, 2021 =

* FIXED: Bug fixes.
* ADDED: Adds option to disable the library.

= [1.12.1] - 17 May, 2021 =

* FIXED: Bug fixes.

= [1.12.0] - 28 Apr, 2021 =

* ADDED: Adds access to the Extendify template and pattern library.

= [1.11.3] - 22 Aug, 2020 =

* CHANGED: Updates readme and team account info.

= [1.11.2] - 09 Apr, 2020 =

* CHANGED: De-prioritizes recommendation for Responsive Lightbox by dFactory due to inactivity.

= [1.11.1] - 14 Aug, 2019 =

* FIXED: Fixes issue where the setting wouldn't save properly.

= [1.11.0] - 8 Jul, 2019 =

* ADDED: Adds support for Gallery Manager Pro.

= [1.10.4] - 30 Apr, 2019 =

* CHANGED: Adds unique class name to admin notices.

= [1.10.3] - 04 Jan, 2019 =

* FIXED: Fixes a bug where WP-Featherlight would not load as a gallery.

= [1.10.2] - 14 Jul, 2018 =

* CHANGED: Updates settings page for WP Lightbox 2 to match their update.

= [1.10.1] - 16 Mar, 2018 =

* FIXED: Updates how lightbox plugins are checked for activation.
* FIXED: Addresses a bug that checks for previous slider settings.
* FIXED: Removes an incompatible lightbox plugin (duplicate name).

= [1.10.0] - 16 Mar, 2018 =

* ADDED: Adds support for additional lightbox plugins.
* CHANGED: Refactors lightbox to clean up attribute function.
* CHANGED: Refactors various parts of the code to extract supported plugin data.
* CHANGED: Extracts the class MetaSliderLightboxPlugin to its own file.
* CHANGED: Changes the logic for check if the plugin is install and active.
* CHANGED: Adds a CSS class to the container that identifies the active lightbox plugin.
* CHANGED: Adds filters to let users manipulate the plugin use.
* CHANGED: Refactors lightbox to clean up attribute function.

= [1.9.3] - 14 Nov, 2018 =

* CHANGED: Fix checks to slide URL.
* FIXED: FooBox Pro compatibility update.
* FIXED: Updates the FooBox Profile name.
* FIXED: Update Gallery Manager plugin settings.

= [1.9.2] - 26 Jan, 2018 =

* CHANGED: Update translation strings.
* CHANGED: Adds warning message when no lightbox is active.

= [1.9.0] - 28 Mar, 2017 =

* FIXED: Simple lightbox use slide caption instead of attachment caption.

= [1.8.0] - 16 Mar, 2017 =

* FIXED: Update slide image URL to comply with new slide post type.

= [1.7.0] - 09 May, 2016 =

* FIXED: Removes defunct Lightbox Plus plugin link (thanks to @Hendrik57).

= [1.6.0] - 01 Apr, 2015 =

* ADDED: Adds support for FooBox Image Lightbox and WP Lightbox 2 *Pro* versions.

= [1.5.0] - 30 Jan, 2015 =

* ADDED: Adds support for FooBox Image Lightbox and Responsive Lightbox by dFactory.

= [1.4.0] - 15 Dec, 2014 =

* FIXED: Hides dependency warning in admin if WP Video Lightbox is activated (reported by and thanks to: vfontj).

= [1.3.0] - 28 Oct, 2014 =

* ADDED: Adds support for Fancy Gallery lightbox plugin (suggested by and thanks to: Zim1).

= [1.2.0] - 17 Sep, 2014 =

* ADDED: Support for additional lightbox plugins.

= [1.1.0] - 22 Aug, 2014 =

* FIXED: Array assignment compatibility PHP < v5.4 (reported by and thanks to: andrea_montuori).

= [1.0.0] - 15 Aug, 2014 =

* ADDED: Initial version.