{"id":47929,"date":"2014-01-19T17:22:38","date_gmt":"2014-01-19T17:22:38","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wp-handy-lightbox\/"},"modified":"2014-01-20T13:06:27","modified_gmt":"2014-01-20T13:06:27","slug":"wp-handy-lightbox","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/wp-handy-lightbox\/","author":13581425,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.4.5","stable_tag":"trunk","tested":"3.5.2","requires":"3.5.1","requires_php":"","requires_plugins":"","header_name":"handy lightbox","header_author":"hansenmartin","header_description":"","assets_banners_color":"","last_updated":"2014-01-20 13:06:27","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/handylightbox.webs.com","header_plugin_uri":"http:\/\/wordpress.org\/extend\/plugins\/wp-handy-lightbox\/","header_author_uri":"http:\/\/handylightbox.webs.com","rating":3.2,"author_block_rating":0,"active_installs":30,"downloads":10110,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog","other_notes"],"tags":[],"upgrade_notice":{"1.4.5 (2013-06-09)":"<p>Support latest jQuery. Better use of small screen estate, fixed buggy features (slideshow, swipes) and reduced system load.<\/p>","1.4.1":"<p>Swipe gestures, slideshow, sets and lots of fixes. Check your config screen after update!<\/p>","1.3.4.1 (2011-01-31)":"<p>Updated deprecated jQuery calls (thanks; David Naber)<\/p>","1.3.4":"<p>Lots of fixes, translations and support for the Admin Bar and Twentyeleven theme.<\/p>","1.3.3":"<p>Fixes for Internet Explorer. Added Japanese translation.<\/p>","1.3.2":"<p>Support for auto-lightboxing comments. Added Polish, Russian and Czech languages.<\/p>","1.3.1":"<p>Added missing files from previous release... Also: mobile support, larger display area.<\/p>","1.3":"<p>Enables larger viewing area, improved mobile experience and translations.<\/p>","1.2.2":"<p>Use WordPress bundled jQuery instead of forcing the Google CDN<\/p>","1.2.1":"<p>Removed forgotten debug call. Important upgrade!<\/p>","1.2":"<p>Support caption and titles from the Media Library<\/p>","1.1":"<p>Honors empty captions and fixes some typos.<\/p>","1.0":"<p>First release.<\/p>"},"ratings":{"1":"6","2":0,"3":0,"4":0,"5":"7"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"A post gallery on Android.","2":"Lightbox displayed in landscape mode. Image info and 'close' is always visible, download link is optional. Click left\/right side of image to navigate the set.","3":"Lightbox, with device rotated. Image remains centered and as wide as possible."}},"plugin_section":[],"plugin_tags":[221,1578,202,237,69182],"plugin_category":[50,59],"plugin_contributors":[],"plugin_business_model":[],"class_list":["post-47929","plugin","type-plugin","status-closed","hentry","plugin_tags-ajax","plugin_tags-display","plugin_tags-jquery","plugin_tags-lightbox","plugin_tags-nodal","plugin_category-media","plugin_category-utilities-and-tools","plugin_committers-handymartin"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/wp-handy-lightbox.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>This plugin lets you keep <a href=\"http:\/\/www.huddletogether.com\/projects\/lightbox2\/\">the awesome Lightbox 2<\/a>-functionality, but sheds the bulk of the Prototype Framework <strong>and<\/strong> Scriptaculous Effects Library.<\/p>\n\n<p>Warren Krewenki <a href=\"http:\/\/warren.mesozen.com\/jquery-lightbox\/\">ported Lightbox to jQuery<\/a> and this plugin is mostly a wrapper to his work: providing localization support, an admin panel for configuration, (optional) auto-boxing of your image links and support for <a href=\"http:\/\/codex.wordpress.org\/Gallery_Shortcode\">WordPress galleries<\/a>, <em>including<\/em> <a href=\"http:\/\/codex.wordpress.org\/Media_Library_SubPanel\">media library<\/a> titles and captions.<\/p>\n\n<ul>\n<li>Swipe gestures for flicking between images on touch devices<\/li>\n<li>Improved scaling <em>maximizes<\/em> use of screen space<\/li>\n<li>Live adjustment to the browser window and orientation of your phone<\/li>\n<li>Optional download link to display images in native app.<\/li>\n<\/ul>\n\n<p>You can browse images with your keyboard: Arrows, P(revious)\/N(ext) and X\/C\/ESC for close.<\/p>\n\n<h4>1.4.5 (2013-06-09)<\/h4>\n\n<ul>\n<li>Fit to screen edge on low rez displays (&lt;500px)<\/li>\n<li>Added global setting to hide title &amp; caption<\/li>\n<li>Reduced the amount of code running for each image shown<\/li>\n<li>Fix: swipe direction<\/li>\n<li>Fix: slideshow now waits for images to display before starting timer.<\/li>\n<li>Fix: support for latest jQuery<\/li>\n<li>Fix: WordPress encoding wrong quote mark in captions, causing duplicate texts to display.<\/li>\n<\/ul>\n\n<p><h4>1.4.1 (2013-02-03)<\/h4><\/p>\n\n<ul>\n<li>Added swipe gestures on touch devices<\/li>\n<li>Added slideshow <\/li>\n<li>Fix regexp to deal with urls like www.gif.org. (Thanks Yannick Berker!)<\/li>\n<li>Fix changed common IDs to avoid collisions. (you'll have to update your CSS now!) (Hat tip; Pollmann Frederic)<\/li>\n<li>Fix better support of Infinite Scroll and similar<\/li>\n<\/ul>\n\n<h4>1.3 (2011-05-01)<\/h4>\n\n<ul>\n<li>Improved scaling to <em>maximize<\/em> display area.<\/li>\n<li>Supports orientation \/ resize changes - Lightbox reflows with site. <\/li>\n<li>Added option to display download link.<\/li>\n<li>Added support for disabling all animations (set duration to 0).<\/li>\n<li>Fixed \"duration\" not having an effect.<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>wp-handy-lightbox<\/code>-folder to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Check out the jQuery Lightbox-panel in your admin interface for usage details and configuration.<\/li>\n<\/ol>\n\n<h4>How to Use:<\/h4>\n\n<ol>\n<li>With <a href=\"http:\/\/codex.wordpress.org\/Gallery_Shortcode\">WordPress built-in gallery<\/a>: <a href=\"http:\/\/codex.wordpress.org\/Gallery_Shortcode\"><code>[gallery link=\"file\"]<\/code><\/a> <\/li>\n<li><p>All galleries in a post make a single slideshow. To create separate slideshows, use <code>group<\/code>:<\/p>\n\n<pre><code>[gallery link=\"file\" ids=\"1,2,3\" group=\"mon\"]\n\n[gallery link=\"file\" ids=\"4,5,6\" group=\"tue\"]\n<\/code><\/pre><\/li>\n<li><p>You can manually add a <code>rel=\"lightbox\"<\/code> attribute to any link:<\/p>\n\n<pre><code>&lt;a href=\"image-1.jpg\" rel=\"lightbox\" title=\"my caption\"&gt;image #1&lt;\/a&gt;\n<\/code><\/pre>\n\n<p>Note the use of title-attribute to set a caption<\/p><\/li>\n<li><p>To manually group sets of related images, follow step 3 but additionally include a group name in the <code>rel<\/code> attribute:<\/p>\n\n<pre><code>&lt;a href=\"image-1.jpg\" rel=\"lightbox[roadtrip]\"&gt;image #1&lt;\/a&gt;\n\n&lt;a href=\"image-2.jpg\" rel=\"lightbox[roadtrip]\"&gt;image #2&lt;\/a&gt;\n\n&lt;a href=\"image-3.jpg\" rel=\"lightbox[roadtrip]\"&gt;image #3&lt;\/a&gt;\n<\/code><\/pre><\/li>\n<li><p>You can use the <code>data-download<\/code> attribute to set a custom download link:<\/p>\n\n<pre><code>&lt;a href=\"image-medium.jpg\" rel=\"lightbox\" data-download=\"image-superlarge.jpg\"&gt; [...] &lt;\/a&gt;\n<\/code><\/pre><\/li>\n<li><p>To <em>disable<\/em> lightboxing of an image link, just set any other rel-attribute: <code>rel=\"nobox\"<\/code><\/p><\/li>\n<li><p>Keyboard support: Arrows, P(revious)\/N(ext) and X\/C\/ESC for close. Swipe left \/ right on touch devices.<\/p><\/li>\n<li><p><a href=\"http:\/\/wordpress.org\/extend\/plugins\/infinite-scroll\/\">Infinite-Scroll<\/a> and similar \"endless pages\"-plugins should call <code>doLightbox();<\/code> whenever it loads new content. Check your plugin for a setting \nnamed \"callbacks\" - code that is called after each new page is loaded. Add this line;\n    if(typeof doLightBox !== 'undefined' &amp;&amp; typeof jQuery !== 'undefined'){\n           doLightBox();\n        }<\/p><\/li>\n<li><p>On the server side you can apply lightbox to any content by running <code>jqlb_apply_lightbox($your_html_content, \"any ID\");<\/code> It returns a string with all image links lightboxed, grouped by <code>\"any id\"<\/code>.<\/p><\/li>\n<\/ol>\n\n<h4>Trouble shooting:<\/h4>\n\n<p>If you have problems with Handy 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.<\/p>\n\n<ol>\n<li>Make sure your site is not throwing any javascript errors. Use <a href=\"http:\/\/webmasters.stackexchange.com\/questions\/8525\/how-to-open-the-javascript-console-in-different-browsers\">your browsers javascript console<\/a> to find out.<\/li>\n<\/ol>\n\n<p>If you're running a custom theme:<\/p>\n\n<ol>\n<li><p>Make sure you have <a href=\"http:\/\/codex.wordpress.org\/Function_Reference\/wp_head\"><code>wp_head();<\/code><\/a> just before the closing <code>&lt;\/head&gt;<\/code> tag of your theme, or you will break many plugins, which generally use this hook to reference JavaScript files.<\/p><\/li>\n<li><p>For the same reason, always have <code>wp_footer();<\/code> just before the closing <code>&lt;\/body&gt;<\/code> tag of your theme.<\/p><\/li>\n<li><p>Many JavaScript optimizers, combiners, minifiers, etc. conflict with <a href=\"http:\/\/codex.wordpress.org\/Function_Reference\/wp_localize_script2\"><code>wp_localize_script<\/code><\/a>, used to configure this plugin and many others.<\/p><\/li>\n<\/ol>\n\n<ul>\n<li><p>If you have problems with jQuery Lightbox; first disable all JavaScript-optimizing plugins. (Optimize Scripts, W3 Total Cache, WP Minify etc)<\/p><\/li>\n<li><p>If you develop JavaScript optimizers for WordPress, please play nice with the default API...<\/p><\/li>\n<\/ul>\n\n<p>Lastly:<\/p>\n\n<ol>\n<li><p>Disable all other plugins, one at a time. Try the lightbox between each.<\/p><\/li>\n<li><p>Revert to the default theme. Did it help? Fix your theme.<\/p><\/li>\n<li><p>Search the forums for similar symptoms.<\/p><\/li>\n<\/ol>\n\n<p>Still have problems? Post a link and describe what issue you're having, and tell us what of these steps you've already tried.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt>Trouble shooting:<\/dt>\n<dd><p>If you have problems with Handy 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.<\/p>\n\n<ol>\n<li>Make sure your site is not throwing any javascript errors. Use <a href=\"http:\/\/webmasters.stackexchange.com\/questions\/8525\/how-to-open-the-javascript-console-in-different-browsers\">your browsers javascript console<\/a> to find out.<\/li>\n<\/ol>\n\n<p>If you're running a custom theme:<\/p>\n\n<ol>\n<li><p>Make sure you have <a href=\"http:\/\/codex.wordpress.org\/Function_Reference\/wp_head\"><code>wp_head();<\/code><\/a> just before the closing <code>&lt;\/head&gt;<\/code> tag of your theme, or you will break many plugins, which generally use this hook to reference JavaScript files.<\/p><\/li>\n<li><p>For the same reason, always have <code>wp_footer();<\/code> just before the closing <code>&lt;\/body&gt;<\/code> tag of your theme.<\/p><\/li>\n<li><p>Many JavaScript optimizers, combiners, minifiers, etc. conflict with <a href=\"http:\/\/codex.wordpress.org\/Function_Reference\/wp_localize_script2\"><code>wp_localize_script<\/code><\/a>, used to configure this plugin and many others.<\/p><\/li>\n<\/ol>\n\n<ul>\n<li><p>If you have problems with jQuery Lightbox; first disable all JavaScript-optimizing plugins. (Optimize Scripts, W3 Total Cache, WP Minify etc)<\/p><\/li>\n<li><p>If you develop JavaScript optimizers for WordPress, please play nice with the default API...<\/p><\/li>\n<li><p><a href=\"http:\/\/wordpress.org\/support\/topic\/122-worked-13-does-not-work-for-me?replies=19\">More info about this issue<\/a><\/p><\/li>\n<\/ul>\n\n<p>Lastly:<\/p>\n\n<ol>\n<li><p>Disable all other plugins, one at a time. Try the lightbox between each.<\/p><\/li>\n<li><p>Revert to the default theme. Did it help? Fix your theme.<\/p><\/li>\n<li><p>Search the forums for similar symptoms.<\/p><\/li>\n<\/ol>\n\n<p>Still have problems? Post a link and describe what issue you're having, and tell us what of these steps you've already tried.<\/p><\/dd>\n<dt>Can the lightbox display the image description instead of the title?<\/dt>\n<dd><p>Handy Lightbox grabs texts from three different HTML nodes;<\/p>\n\n<ol>\n<li><code>title<\/code>-attribute of link-to-image<\/li>\n<li><code>img<\/code> tag's <code>title<\/code> attribute (if 1 is empty)<\/li>\n<li><code>img<\/code> tag's <code>alt<\/code> attribute (if 1 and 2 is empty)<\/li>\n<li>HTML content of <code>.gallery-caption<\/code> or <code>.wp-caption-text<\/code> (in that order)<\/li>\n<\/ol>\n\n<p>Look at how the default TwentyTwelve theme uses these in its galleries and set up your theme so it outputs what you need in these places.<\/p><\/dd>\n<dt>I can see elements of my site through the overlay<\/dt>\n<dd><p>It's a problem of <a href=\"http:\/\/www.w3schools.com\/Css\/pr_pos_z-index.asp\">z-index<\/a>. Check <a href=\"http:\/\/www.w3schools.com\/Css\/pr_pos_z-index.asp\">the z-index property<\/a> for the problematic elements, and force them to be less than 100. (Thanks <a href=\"http:\/\/wordpress.org\/support\/topic\/plugin-wp-handy-lightbox-title-captions-bug-found-solved-and-fix-proposed?replies=20#post-2052340\">dway<\/a>!)<\/p><\/dd>\n<dt>How do I add images to a post?<\/dt>\n<dd><p><a href=\"http:\/\/codex.wordpress.org\/Inserting_Images_into_Posts_and_Pages\">Inserting Images into Posts and Pages<\/a><\/p><\/dd>\n<dt>How do I create a thumbnail gallery?<\/dt>\n<dd><p>Upload images to a post (see previous question) and use <a href=\"http:\/\/codex.wordpress.org\/Gallery_Shortcode\">WordPress' built-in gallery shortcode<\/a>: <code>[gallery link=\"file\"]<\/code><\/p>\n\n<p>Note the <code>link=\"file\"<\/code> - this is crucial! By default the gallery will link your humbnails to a page displaying your image. With <code>link=\"file\"<\/code> the thumbnails links \ndirectly to the image files - allowing Lightbox to function.<\/p><\/dd>\n<dt>Must fade-in and animation of all *box-scripts be so slow?<\/dt>\n<dd><p>WP-jQuery Lightbox lets you configure the animation duration and disable image resizing from the admin panel. Set duration to 0 to disable animations entirely.<\/p><\/dd>\n<dt>For developers:<\/dt>\n<dd><ol>\n<li>Always have <code>wp_footer();<\/code> just before the closing <code>&lt;\/body&gt;<\/code> tag of your theme, or you will break many plugins, which generally use this hook to reference JavaScript files. <\/li>\n<li>Apply lightbox to any content by running <code>jqlb_apply_lightbox($your_content, \"any ID\");<\/code> It returns a string with all image links lightboxed, grouped by <code>\"any id\"<\/code>.<\/li>\n<li>Many JavaScript optimizers, combiners, minifiers, etc. conflict with <a href=\"http:\/\/codex.wordpress.org\/Function_Reference\/wp_localize_script2\"><code>wp_localize_script<\/code><\/a>, used to configure this plugin and many others.<\/li>\n<\/ol>\n\n<ul>\n<li>If you have problems with jQuery Lightbox; first disable all JavaScript-optimizing plugins. (Optimize Scripts, W3 Total Cache, WP Minify etc)<\/li>\n<li>If you develop JavaScript optimizers for WordPress, please play nice with the default API...<\/li>\n<li><a href=\"http:\/\/wordpress.org\/support\/topic\/122-worked-13-does-not-work-for-me?replies=19\">More info about this issue<\/a><\/li>\n<\/ul><\/dd>\n<dt>Can I help you in any way?<\/dt>\n<dd><p>Indeed you can!<\/p>\n\n<p>Translations and help with implementing them would be nice. A read through and comments on my WordPress API usage would also be most welcome, as I'm not really able to keep on top of the frequent WordPress releases anymore.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.4.5 (2013-06-09)<\/h4>\n\n<ul>\n<li>Fit to screen edge on low rez displays (&lt;500px)<\/li>\n<li>Added global setting to hide title &amp; caption<\/li>\n<li>Reduced the amount of code running for each image shown<\/li>\n<li>Fix: swipe direction<\/li>\n<li>Fix: slideshow now waits for images to display before starting timer.<\/li>\n<li>Fix: support for latest jQuery<\/li>\n<li>Fix: WordPress encoding wrong quote mark in captions, causing duplicate texts to display.<\/li>\n<\/ul>\n\n<p><h4>1.4.1 (2013-02-03)<\/h4><\/p>\n\n<ul>\n<li>Added swipe gestures on touch devices<\/li>\n<li>Added slideshow <\/li>\n<li>Added support to pick text from the image ALT-attribute (if title is not available) <\/li>\n<\/ul>\n\n<h4>1.3.4.2 (2011-02-01)<\/h4>\n\n<ul>\n<li>Fallbacks for people using older jQuery<\/li>\n<\/ul>\n\n<h4>1.3.4.1 (2011-01-31)<\/h4>\n\n<ul>\n<li>Updated deprecated jQuery calls (thanks; David Naber)<\/li>\n<\/ul>\n\n<h4>1.3.2 (2011-05-16)<\/h4>\n\n<ul>\n<li>Added support for auto-lightboxing comments too<\/li>\n<li>Added Russian and Czech translations (incl. images). Thanks again Denis!<\/li>\n<\/ul>\n\n<h4>1.3.1 (2011-05-02)<\/h4>\n\n<ul>\n<li>Forgot to include languages files! :)<\/li>\n<\/ul>\n\n<h4>1.3 (2011-05-01)<\/h4>\n\n<ul>\n<li>Improved scaling to make maximum use of display area.<\/li>\n<li>Supports orientation \/ resize changes - Lightbox reflows with site. <\/li>\n<li>Added option to display download link.<\/li>\n<li>Added support for disabling all animations (set duration to 0).<\/li>\n<li>Fixed \"duration\" not having an effect.<\/li>\n<\/ul>\n\n<h4>1.2.2 (2011-04-14)<\/h4>\n\n<ul>\n<li>Use WordPress bundled jQuery instead of forcing the Google CDN<\/li>\n<li>Fixed the settings link on the Plugins page<\/li>\n<\/ul>\n\n<h4>1.2.1 (2010-10-24)<\/h4>\n\n<ul>\n<li>Removed a forgotten debug call<\/li>\n<\/ul>\n\n<h4>1.2 (2010-10-12)<\/h4>\n\n<ul>\n<li>Added support for Media Library titles and captions.<\/li>\n<li>Minified the javascript (8.6KB vs 17.8KB)<\/li>\n<li>Minified the CSS (2.0KB vs 2.7KB)<\/li>\n<\/ul>\n\n<h4>1.1 (2010-10-09)<\/h4>\n\n<ul>\n<li>Honors empty captions. <\/li>\n<li>Fixed typos on admin page.<\/li>\n<\/ul>\n\n<h4>1.0 (2010-04-11)<\/h4>\n\n<ul>\n<li>Release.<\/li>\n<\/ul>\n\n<!--section=other_notes-->\n<p>Copyright (C) 2010-2013 Handy Martyn (hansentmartin@mail.com).<\/p>\n\n<p>This program is free software; you can redistribute it and\/or modify\nit under the terms of the GNU General Public License as published by\nthe Free Software Foundation; either version 2 of the License, or\n(at your option) any later version.<\/p>\n\n<p>This program is distributed in the hope that it will be useful,\nbut WITHOUT ANY WARRANTY; without even the implied warranty of\nMERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the\nGNU General Public License for more details.<\/p>\n\n<p>You should have received a copy of the GNU General Public License\nalong with this program; if not, write to the Free Software\nFoundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA<\/p>","raw_excerpt":"A drop-in replacement for Lightbox 2 and similar plugins, shedding the bulk of Prototype and Scriptaculous. Improved for mobile devices.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/47929","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=47929"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/handymartin"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=47929"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=47929"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=47929"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=47929"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=47929"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=47929"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}