=== WP jQuery Lightbox ===
Contributors: pandaboxwp
Tags: lightbox, photo, image, gallery
Requires at least: 5.0
Tested up to: 6.4.3
Stable tag: 1.5.3
Requires PHP: 7.0
License: GPLv2 or later
Very simple and lightweight lightbox plugin for WordPress. Formerly the 'WP JQuery Lightbox'.
== Description ==
A simple, lightweight WordPress lightbox plugin. [See demo here](https://pandaboxwp.com).
**Features**
* Automattically detect images so they open in a lightbox with no need to adjust markup.
* Works seamlessly with WordPress core images and galleries, and galleries from many plugins.
* Play or puase slideshow within lightbox.
* Enhanced mobile support with swipe gestures on touch devices, improved scaling to maximizes use of screen space, and live adjustment to the browser window and orientation of your phone.
* Browse images with your keyboard: Arrows, P(revious)/N(ext) and X/C/ESC for close.
* Admin panel to configure options. sv
* Localization support.
* Lightweight and fast.
See the plugin in action here: [pandaboxwp.com](https://pandaboxwp.com)
**Background and Thanks**
Special thanks to [Ulf Benjaminsson](http://www.ulfbenjaminsson.com), who created this plugin and maintained it for many years.
This plugin lets you keep [Lightbox 2](http://www.huddletogether.com/projects/lightbox2/) functionality but sheds the bulk of the Prototype Framework and Scriptaculous Effects Library. Warren Krewenki [ported Lightbox to jQuery](http://warren.mesozen.com/jquery-lightbox/) and this plugin is mostly a wrapper to his work.
== Screenshots ==
1. Default frontend appearance.
== Installation ==
1. Upload the `wp-jquery-lightbox`-folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Check out the jQuery Lightbox-panel in your admin interface for usage details and configuration.
= How to Use: =
1. With [WordPress built-in gallery](http://codex.wordpress.org/Gallery_Shortcode): [`[gallery link="file"]`](http://codex.wordpress.org/Gallery_Shortcode)
1. All galleries in a post make a single slideshow. To create separate slideshows, use `group`:
`[gallery link="file" ids="1,2,3" group="mon"]`
`[gallery link="file" ids="4,5,6" group="tue"]`
1. You can manually add a `rel="lightbox"` attribute to any link:
`image #1`
Note the use of title-attribute to set a caption
1. To manually group sets of related images, follow step 3 but additionally include a group name in the `rel` attribute:
`image #1`
`image #2`
`image #3`
1. You can use the `data-download` attribute to set a custom download link:
` [...] `
1. To *disable* lightboxing of an image link, just set any other rel-attribute: `rel="nobox"`
1. Keyboard support: Arrows, P(revious)/N(ext) and X/C/ESC for close. Swipe left / right on touch devices.
1. [Infinite-Scroll](http://wordpress.org/extend/plugins/infinite-scroll/) and similar "endless pages"-plugins should call `doLightbox();` whenever it loads new content. Check your plugin for a setting
named "callbacks" - code that is called after each new page is loaded. Add this line;
`if(typeof doLightBox !== 'undefined' && typeof jQuery !== 'undefined'){
doLightBox();
}`
1. On the server side you can apply lightbox to any content by running `jqlb_apply_lightbox($your_html_content, "any ID");` It returns a string with all image links lightboxed, grouped by `"any id"`.
= Trouble shooting: =
If you have problems with WP jQuery Lightbox, please make sure you try these steps before asking for help. If you ask for help and I find any of these steps would fix the problem, I will just link you back here to do the work yourself.
1. Make sure your site is not throwing any javascript errors. Use [your browsers javascript console](http://webmasters.stackexchange.com/questions/8525/how-to-open-the-javascript-console-in-different-browsers) to find out.
If you're running a custom theme:
1. Make sure you have [`wp_head();`](http://codex.wordpress.org/Function_Reference/wp_head) just before the closing `` tag of your theme, or you will break many plugins, which generally use this hook to reference JavaScript files.
1. For the same reason, always have `wp_footer();` just before the closing `