=== WP Featherlight - A Simple jQuery Lightbox ===

Contributors: fatmedia, wpsitecare
Tags: lightbox, jquery lightbox, jquery, gallery, image, lightbox images, image lightbox, lightbox gallery, lightbox image, lightbox popup, featherlight, photo gallery, popup image, popup images, popup lightbox, responsive lightbox, swipe, wordpress image lightbox, wordpress lightbox, wordpress slideshow lightbox, photography, images, minimal, responsive, photo, photos
Requires at least: 4.6
Tested up to: 4.6.1
Stable tag: 1.0.0
License: GPL-2.0+

An ultra lightweight jQuery lightbox for WordPress images and galleries.

== Description ==

WP Featherlight is a WordPress lightbox plugin for adding a minimal, high-performance, responsive jQuery lightbox to your WordPress website. At its core, WP Featherlight is a WordPress plugin wrapper for the Featherlight jQuery lightbox plugin. When installed, the plugin will automatically display all standard WordPress images and galleries in a simple, minimalistic lightbox popup.

In order for WordPress images and galleries to be lightboxed, you need to select the "Media File" option when choosing where the thumbnails should link. You can also select the "Custom Link" option if you make sure to link directly to an image file. This should work for any image file, even if it's hosted on another website.

It's also possible to lightbox videos, iframes, and ajax content with WP Featherlight by adding data attributes to your content. For more details on custom content loading, check out the [featherlight documentation](https://github.com/noelboss/featherlight/#usage).

There are no settings for WP Featherlight, so you should be able to install it without needing to configure anything. In the event you don't want a lightbox on certain pages or posts, there is an option to disable it from within the post editor screen.

If you find a display problem, it may be related to your theme but please [open an support request](https://wordpress.org/support/plugin/wp-featherlight) about it so we can look into it. For more information about the Featherlight script itself, check out their [GitHub plugin page](http://noelboss.github.io/featherlight/).

= Developer Notes =

While there are no options in the plugin, there are some handy filters to modify the default behavior. As of `0.3.0` all images which use the default WordPress captions will also include a caption when the image is lightboxed. To disable this behavior, filter `wp_featherlight_captions` to false.

You can also disable inclusion of the CSS and JavaScript conditionally using filters which can be found in the `/includes/class-scripts.php` file. If you have questions about how any part of the plugin works, please don't hesitate to [open an issue on GitHub](https://github.com/wpsitecare/wp-featherlight/issues).

= Contributing =

If you'd like to submit code patches or contribute in any other way, please [fork the plugin on GitHub](https://github.com/wpsitecare/wp-featherlight).

== Screenshots ==

1. A view of the jQuery lightbox in action.

== Changelog ==

= 1.0.0 =
Even though this is a major version change, this is primarily a maintenance release. The reason for the jump to 1.0.0 is because we've changed some code which could break backwards compatibility with custom extensions and integrations.

If you're just using the plugin on your site and haven't customized it or paid anyone to customize it for you, you should be able to update without any issues.

If you're a developer and have written custom code extending the PHP side of WP Featherlight, be sure to test your code before updating.

Under the hood, we've [deprecated some internal methods](https://github.com/wpsitecare/wp-featherlight/search?utf8=%E2%9C%93&q=_deprecated_function) which could potentially break custom code which extends WP Featherlight. The changes are primarily limited to class initialization, so unless you were doing something specific to that, it's unlikely that you'll run into issues.

- Tweak: Improved transition between images within galleries
- Tweak: Moved our disable lightbox checkbox into the publish meta box to streamline the admin
- Tweak: Made styles more aggressive to ensure elements look consistent across different themes by default
- Fix: Reduced false positives for URLs that use image extensions but don't actually link to an image
- Dev: Updated [Featherlight](https://github.com/noelboss/featherlight/) to `1.5.1`
- Dev: Updated [jQuery Detect Swipe](http://github.com/marcandre/detect_swipe) to `2.1.3`
- Dev: Deprecated some internal methods
- Dev: Reorganized how classes are instantiated and plugin actions are fired

[View the full changelog on GitHub](https://github.com/wpsitecare/wp-featherlight/blob/master/CHANGELOG.md)