=== Backbone Bootstrap Gallery === Contributors: Magenta Cuda Tags: gallery, shortcode, lightbox, slideshow, responsive, plug-compatible, replacement Requires at least: 4.4 Tested up to: 4.9 Stable tag: 1.8.2.4.5.1 Requires PHP: 5.6 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html Responsive plug-compatible replacement for the built-in WordPress gallery shortcode. == Description == This is a responsive, mobile-friendly, plug-compatible replacement for the built-in WordPress gallery shortcode. You can view a working sample web page using this plugin at [my portfolio website](http://magentacuda.com/demo-bbgallery/). It is implemented using a [Backbone.js](http://backbonejs.org/) Model-View-Presenter (MVP) populated via the [WordPress REST API](http://v2.wp-api.org/). It is styled by a [Twitter Bootstrap 3](http://getbootstrap.com/) stylesheet and has touch optimizations from [jQuery Mobile](https://jquerymobile.com/). Using a MVP allows you to [switch instantaneously](http://docs.magentacuda.com/#navbar) (i.e. without doing a HTTP request) between multiple views of a gallery. The default implementation supports a [gallery view](http://docs.magentacuda.com/#gallery), [Miro's Justified Gallery](http://miromannino.github.io/Justified-Gallery/) view, a [carousel view](http://docs.magentacuda.com/#carousel), a [tabs view](http://docs.magentacuda.com/#tabs) and a [dense view](http://docs.magentacuda.com/#dense) of the gallery. Using the WP REST API allows you to [dynamically load](http://docs.magentacuda.com/#alt_galleries) (i.e. without reloading the entire page) new galleries. The view is styled by a Twitter Bootstrap 3 stylesheet so it is automatically responsive. You can easily modify the Backbone templates to create your own customized views of the gallery. The homepage for this plug-in is [http://docs.magentacuda.com/](http://docs.magentacuda.com/). == Installation == 1. Upload the folder "bb-gallery" to the "/wp-content/plugins/" directory. 2. Activate the plugin using the "Dashboard > Plugins > Installed Plugins" page. 3. Check the "Enable BB Gallery" option on the "Dashboard > Settings > Media" page. The defaults for all other options should work reasonably well. Save the settings. 4. Visit any page which has a gallery shortcode. 5. If you are not happy simply uninstall the plugin. Your website will not be changed in anyway. == Frequently Asked Questions == = Why is the page loading slowly? = BB Gallery can preload full size images for better user interactivity. This does not work well for low bandwidth and/or slow cpus. You can set the bandwidth option to "low" to prevent the preloading of full size images. = Where is the documentation? = http://docs.magentacuda.com/ == Screenshots == 1. [Multiple Views of a Gallery](http://docs.magentacuda.com/#navbar) 2. [Miro's Justified Gallery](http://docs.magentacuda.com/#view-justified) 3. [WordPress Gallery](http://docs.magentacuda.com/#view-gallery) 4. [Alternate Flexbox Gallery View](http://docs.magentacuda.com/#gallery-flexbox) 5. [Carousel](http://docs.magentacuda.com/#view-carousel) 6. [Tabbed Gallery](http://docs.magentacuda.com/#view-tabs) 7. [Dense Gallery](http://docs.magentacuda.com/#view-dense) 8. [Dynamically Loading Galleries](http://docs.magentacuda.com/#alt_galleries) 9. Dynamically Generating Galleries from Search Criteria 10. [Full-Size Image Overlay of the Selected Image](http://docs.magentacuda.com/#overlay) 11. [Image Info Overlay of the Selected Image](http://docs.magentacuda.com/#alt-overlay) 12. Mobile Portrait View 13. [User Options Pane](http://docs.magentacuda.com/#options) 14. [Admin Settings](http://docs.magentacuda.com/#installation) == Changelog == = 1.8.2.4.5.1 = * fix bad url = 1.8.2.4.5 = * update links to new documentation website * add info overlay to gallery and carousel views = 1.8.2.4.4 = * add info overlay to Miro's gallery = 1.8.2.4.3 = * disable loading of unneeded hi-res thumbnails * fix alignment bug in fullscreen landscape mode = 1.8.2.4.2 = * bb_tags now includes unattached images * search now uses the bb_tags taxonomy = 1.8.2.4.1 = * css tweaks = 1.8.2.4 = * tweaks to support the 2017 theme * css tweaks for better fit and finish = 1.8.2.3 = * fix compatibility bug with Yoast SEO and Jetpack = 1.8.2.2 = * workaround for a bug? in Chrome where navbar is hidden after the image overlay is closed. * fix bug where search result back pager shows wrong default view. = 1.8.2.1 = * fix bug where search results shows in the wrong default view * add missing Justified preferred row height setting = 1.8.2 = * added support for a fullscreen view * change default to not preload full size images * bug fixes and css tweaks = 1.8.1.1 = * make compatible with the new WordPress REST API released with 4.7 * fix HTML validation errors * some small enhancements, css tweaks and bug fixes = 1.8.1 = * some small enhancements, css tweaks and bug fixes = 1.8 = * replaced <picture> with <img srcset> for better support of Retina displays * added support for [Miro's Justified Gallery](http://miromannino.github.io/Justified-Gallery/) * bug fixes and css tweaks = 1.7.3.4 = * bug fix = 1.7.3.3 = * bug fix = 1.7.3.2 = * bug fixes * compatibility with WordPress 4.6 RC1 = 1.7.3.1 = * add object-fit contain and fill modes to tiles view * css tweaks and bug fixes = 1.7.3 = * added tiles view - show images as [butt joined square image tiles](http://docs.magentacuda.com/#gallery) * css tweaks and bug fixes = 1.7.1.2 = * option to [embed carousel inside post content](http://docs.magentacuda.com/#carousel) * option to individually specify initial view of gallery * css tweaks to prettify carousel = 1.7.1.1 = * show loadable galleries as a gallery of clickable representative images in place of a list of clickable titles * bug fixes and usability enhancements = 1.7.1 = * option to make the carousel as the initial view * option to show the dynamically loadable galleries as tabs * bug fixes, css tweaks and usability enhancements = 1.7 = * support for dynamically loading galleries using the WordPress REST API to populate Backbone.js collections. = 1.5.5 = * use the WordPress REST API if available - no new features just a more modern implementation * css tweaks and bug fixes = 1.5.3.1.1 = * compatible with WordPress 4.5-RC1 * added language support * more integration with jQuery Mobile = 1.5.3.1 = * replaced the Bootstrap carousel indicators with a jQuery mobile slider which is much more mobile friendly = 1.5.3 = * added support for mobile features: swipe, orientation change, ... * fix overlay bug on old Internet Explorer * add pause control to carousel = 1.5.2.1 = * various enhancements, bug fixes and improvements to code quality = 1.5.2 = * support history for multi-part search results = 1.5.1 = * support multi-part search results * css tweaks = 1.5 = * search added * enhancements for mobile = 1.3.3 = * fixes for problems with mobile (touch screen, small screen and/or low bandwidth) devices = 1.3.2 = * add carousel interval option * allow front-end to set options (minimum image width, number of columns, carousel interval) and save as a cookie = 1.3.1 = * better support for captions * description now supports shortcodes * prettify UI = 1.3 = * The gallery view and the dense view now support displaying a full viewport overlay of a selected image = 1.2.1 = * implement CSS object-fit in JavaScript for Microsoft Edge which does not have the CSS object-fit * improved tabs view = 1.2 = * added dense view = 1.1 = * improved flex gallery = 1.0 = * Initial release. == Upgrade Notice == = 1.8.2.4.5.1 = * fix bad url = 1.8.2.4.5 = * update links to new documentation website * add info overlay to gallery and carousel views = 1.8.2.4.4 = * add info overlay to Miro's gallery = 1.8.2.4.3 = * disable loading of unneeded hi-res thumbnails * fix alignment bug in fullscreen landscape mode = 1.8.2.4.2 = * bb_tags now includes unattached images * search now uses the bb_tags taxonomy = 1.8.2.4.1 = * css tweaks = 1.8.2.4 = * tweaks to support the 2017 theme * css tweaks for better fit and finish = 1.8.2.3 = * fix compatibility bug with Yoast SEO and Jetpack = 1.8.2.2 = * workaround for a bug? in Chrome where navbar is hidden after the image overlay is closed. * fix bug where search result back pager shows wrong default view. = 1.8.2.1 = * fix bug where search results shows in the wrong default view * add missing Justified preferred row height setting = 1.8.2 = * added support for a fullscreen view * change default to not preload full size images * bug fixes and css tweaks = 1.8.1.1 = * make compatible with the new WordPress REST API released with 4.7 * fix HTML validation errors * some small enhancements, css tweaks and bug fixes = 1.8.1 = * some small enhancements, css tweaks and bug fixes = 1.8 = * replaced <picture> with <img srcset> for better support of Retina displays * added support for [Miro's Justified Gallery](http://miromannino.github.io/Justified-Gallery/) * bug fixes and css tweaks = 1.7.3.4 = * bug fix = 1.7.3.3 = * bug fix = 1.7.3.2 = * bug fixes * compatibility with WordPress 4.6 RC1 = 1.7.3.1 = * add object-fit contain and fill modes to tiles view * css tweaks and bug fixes = 1.7.3 = * added tiles view - show images as butt joined square image tiles * css tweaks and bug fixes = 1.7.1.2 = * option to embed carousel inside post content * option to individually specify initial view of gallery * css tweaks to prettify carousel = 1.7.1.1 = * show loadable galleries as a gallery of clickable representative images in place of a list of clickable titles * bug fixes and usability enhancements = 1.7.1 = * option to make the carousel as the initial view * option to show the dynamically loadable galleries as tabs * bug fixes, css tweaks and usability enhancements = 1.7 = * support for dynamically loading galleries using the WordPress REST API to populate Backbone.js collections. = 1.5.5 = * use the WordPress REST API if available - no new features just a more modern implementation * css tweaks and bug fixes = 1.5.3.1.1 = * compatible with WordPress 4.5-RC1 * added language support * more integration with jQuery Mobile = 1.5.3.1 = * replaced the Bootstrap carousel indicators with a jQuery mobile slider which is much more mobile friendly = 1.5.3 = * added support for mobile features: swipe, orientation change, ... * fix overlay bug on old Internet Explorer * add pause control to carousel = 1.5.2.1 = * various enhancements, bug fixes and improvements to code quality = 1.5.2 = * support history for multi-part search results = 1.5.1 = * support multi-part search results * css tweaks = 1.5 = * search added * enhancements for mobile = 1.3.3 = * fixes for problems with mobile (touch screen, small screen and/or low bandwidth) devices = 1.3.2 = * add carousel interval option * allow front-end to set options (minimum image width, number of columns, carousel interval) and save as a cookie = 1.3.1 = * better support for captions * description now supports shortcodes * prettify UI = 1.3 = * The gallery view and the dense view now support displaying a full viewport overlay of a selected image = 1.2.1 = * implement CSS object-fit in JavaScript for Microsoft Edge which does not have the CSS object-fit * improved tabs view = 1.2 = * added dense view = 1.1 = * improved flex gallery = 1.0 = * Initial release.