Permalink
Find file
Fetching contributors…
Cannot retrieve contributors at this time
275 lines (194 sloc) 8.13 KB
=== Lightbox Gallery ===
Contributors: Hiroaki Miyashita
Donate link: http://wpgogo.com/development/lightbox-gallery.html
Tags: lightbox, gallery, galleries, image, images, album, photo, photos, picture, pictures, jQuery, Highslide, Colorbox
Requires at least: 2.5
Tested up to: 4.2
Stable tag: 0.8.2
License: GPLv2 or later
The Lightbox Gallery plugin changes the view of galleries to the lightbox.
== Description ==
**Importance:**
From 0.7.1, the default view changed to Colorbox due to the license regulation by the plugin directory. If you would prefer the prior Lightbox to Colorbox, you need to get the script from the setting page.
The Lightbox Gallery plugin changes the view of galleries to the lightbox.
* Lightbox display of Gallery
* Tooltip view of caption of images
* Displays the associated metadata with images
* Divides Gallery into several pages
* Extends the default Gallery options
* Additional settings are set in the option page
* Switch to the Highslide JS display
You can also make regular images appear in a lightbox. See Faq.
Localization
* Brazilian Portuguese (pt_BR) - [Emmanuel Carvalho](http://www.emmanuelcarvalho.com.br/)
* Belorussian (by_BY) - [ilyuha](http://antsar.info/)
* Czech (cs_CZ) - [Petufo](http://blog.vlastenci.cz/)
* Spanish (es_ES) - [Daniel Tarrero](http://www.bluebrain.es/)
* Danish (da_DK) - [Jacob Voldby](http://www.clmedia.dk)
* German (de_DE) - Michael Wruck and Tacitus Media
* Farsi (fa_IR) - [Ehsan Razavi](http://webdata.in/)
* French (fr_FR) - [BenLeTibetain](http://www.benletibetain.net/)
* Hindi (hi_IN) - [Outshine Solutions](http://outshinesolutions.com/web-hosting/web-hosting-india.html)
* Croatian (hr) - [Tomislav Konestabo](http://aciddot.com/)
* Hungarian (hu_HU) - [Zsolt Vereb](http://www.google.com/profiles/zsolt.vereb) and [Feriman](http://feriman.com/)
* Italian (it_IT) - [Gianni Diurno](http://gidibao.net/)
* Japanese (ja) - [Hiroaki Miyashita](http://wpgogo.com/)
* Dutch (nl_NL) - [Peter Arends](http://www.peterarends.net/)
* Polish (pl_PL) - Otmar
* Romanian (ro_RO) - [Anunturi Jibo](http://www.jibo.ro/)
* Russian (ru_RU) - [Fat Cow](http://www.fatcow.com/)
* Slovak (sk_SK) - [Viliam Brozman](http://www.brozman.sk/blog/)
* Swedish (sv_SE) - [Anders Martensson](http://nemrod.se/)
* Turkish (tr_TR) - [Hakan Demiray](http://www.dmry.net/)
* Ukrainian (uk_UA) - [Vitalij Lew](http://wpp.pp.ua/)
* Simplified Chinese (zh_CN) - [leonanu](http://www.inanu.net/)
If you have translated into your language, please let me know.
== Installation ==
1. Activate the plugin through the 'Plugins' menu in WordPress
2. Just upload images and write down the [gallery] shortcode in the post content.
3. That's it! :)
Lightbox Gallery will load 'lightbox-gallery.css' and 'lightbox-gallery.js' from your theme's directory if they exist.
If they don't exist, they will just load the default 'lightbox-gallery.css' and 'lightbox-gallery.js' that come with Lightbox Gallery. This will allow you to upgrade Lightbox Gallery without worrying about overwriting your lightbox gallery styles that you have created.
* Edit the `lightbox-gallery.js` and check the path of line 2 according to your settings.
* There may exist localized images in 'images' directory. Replace default images with them.
== Frequently Asked Questions ==
* How can I make regular images appear in a lightbox without [gallery] shortcode?
Just add rel="lightbox" into "a" tag. Here is a sample.
&lt;a href="image.jpg" rel="lightbox" title="this is a caption"&gt;<br />
&lt;img src="thumbnail.jpg" alt="" /&gt;<br />
&lt;/a&gt;
* How can I handle multiple galleries in one page as separate ones?
If you would like to handle galleries separately, add different class names
into [gallery]. ex) [gallery class="gallery2"]
* Java Script does not seem to be loading?
Check out your theme has `wp_head()` in the header and `wp_footer()` in ther footer.
== Screenshots ==
1. Lightbox Gallery
== How to use ==
How to use this plugin is basically the same as the way to add [gallery] which has been adopted
by over WordPress 2.5. Lightbox Gallery plugin automatically converted the default view of gallery
into the lightbox view. Photo captions are displayed as tooltips. Photo descriptions are displayed
when the lightbox pops up.
== Advanced settings ==
There are three additional options to extend the shorttag [gallery].
* lightboxsize
The image size when the lightbox pops up. The default is medium, but you can change to full.
[gallery lightboxsize="full"]
* meta
Defines whether the exif information is displayed. The default is false.
If you want to show the photo info, set true. The exif shown on the lightbox includes camera body,
aperture, focal length, shutter speed, and created timestamp.
[gallery meta="true"]
* class
Adds a class attribute of the gallery. The default is `gallery1`.
[gallery class="gallery2"]
* nofollow
Adds the attribute, rel="nofollow". The default is false.
[gallery nofollow="true"]
* from, num
Defines from which and how many photos are displayed.
If the number of photos is over that of `num`, the navigation will be shown.
You can use the navigation option almost same as the `wp_link_pages` function.
[gallery from="5" num="10"]
* pagenavi
If you would like not to show the navigation, set `0`. The default is `1`.
[gallery num="10" pagenavi="0"]
== Changelog ==
= 0.8.2 =
* CSS loading in a child theme.
= 0.8.1 =
* Backward compatibility: caption loading.
* Code cleaning.
= 0.8 =
* Responsive output.
* Gallery code renewal.
= 0.7.5 =
* Farsi (fa_IR) - Ehsan Razavi
= 0.7.4 =
* Bugfix: support for WordPress 3.5.
= 0.7.3 =
* Danish (da_DK) - Jacob Voldby
* Bugfix: rel="lightbox"
= 0.7.2 =
* Bugfix: lightbox image path.
= 0.7.1 =
* The default view changed to Colorbox.
* Slovak (sk_SK) - Viliam Brozman
= 0.6.8 =
* Due to the license restriction, the highslide script has been removed.
* Bugfix: key transition.
= 0.6.7 =
* Swedish (sv_SE) - Anders Martensson
* Bugfix: button images of sub directory WordPress.
= 0.6.6 =
* Option to add rel=&quot;lightbox&quot; automatically in the post insert.
* Code cleaning.
* Bugfix: addition of esc_attr().
* Croatian (hr) - Tomislav Konestabo
* Hindi (hi_IN) - Outshine Solutions
* Simplified Chinese (zh_CN) - leonanu
= 0.6.5 =
* Lightbox and Highslide path.
* Czech (cs_CZ) - Petufo
* Germany (de_DE) - Michael Wruck and Tacitus Media
* Romanian (ro_RO) - Anunturi Jibo
= 0.6.3 =
* jQuery lightBox plugin license changed.
* Hungarian (hu_HU) - Zsolt Vereb and Feriman
= 0.6.2 =
* Enforced loading option of lightbox gallery scripts.
= 0.6.1 =
* Bugfix: JavaScript error.
= 0.6 =
* If you set the `class` attribute into [gallery], galleries are handled separately. ex) [gallery class="gallery2"]
* Support for the Highslide JS.
* Support for the javascript loading in the footer.
* Turkish (tr_TR) - Hakan Demiray
= 0.5 =
* Brazilian Portuguese (pt_BR) - Emmanuel Carvalho
* Belorussian (be_BY) - ilyuha
* Combine jquery.lightbox.css and jquery.tooltip.css into lightbox-gallery.css
= 0.4.7 =
* Default thumbnail size and lightbox size.
= 0.4.6 =
* Spanish (es_ES) - Daniel Tarrero
* Polish (pl_PL) - Otmar
* Bugfix: translation miss.
= 0.4.5 =
* Dutch (nl_NL) - Peter Arends
= 0.4.4 =
* French (fr_FR) - BenLeTibetain
= 0.4.3 =
* Bugfix: JavaScript.
* Russian (ru_RU) - Fat Cow
= 0.4.2 =
* Bugfix: page navigation.
= 0.4.1 =
* Loads `lightbox-gallery.js` from your theme directory.
* Italian (it_IT) - Gianni Diurno.
= 0.4 =
* `from` and `num` attributes for gallery division.
* Additional settings are set in the option page.
= 0.3.1 =
* Bugfix.
= 0.3 =
* Bugfix.
* Output jquery and lightbox scripts only in the replated page.
= 0.2.6 =
* Bugfix.
= 0.2.5 =
* Bugfix.
= 0.2.4 =
* `nofollow` attribute.
= 0.2.2 =
* ISO attribute
= 0.2.1 =
* `class` attribute.
= 0.2 =
* `rel="lightbox"` to make regular images appear in a lightbox.
= 0.1 =
* Initial release.
== Known Issues / Bugs ==
== Uninstall ==
1. Deactivate the plugin
2. That's it! :)