=== Cleaner Gallery ===
Contributors: greenshady
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=3687060
Tags: gallery, lightbox, slimbox, images, jquery, fancybox, shadowbox, thickbox, valid-xhtml
Requires at least: 3.0
Tested up to: 3.2
Stable tag: 0.9.2
A cleaner WordPress [gallery] that integrates with multiple Lightbox-type scripts.
== Description ==
*Cleaner Gallery* was written to take care of the invalid HTML that WordPress produces when using the `[gallery]` shortcode.
It does a bit more than that though. It will integrate with many Lightbox-type scripts and allow you to do much cooler things with your galleries. Plus, it has a couple of extra options that you can play around with.
**Features:**
* Validates the aweful HTML that WordPress spits out.
* Several options on how you want your gallery images.
* Allows multiple galleries in a single post.
* Ability to set the number of images shown in each gallery.
* Ability to exclude or include any images from your gallery.
* Doesn't load any CSS or JavaScript unless you choose to do so.
**Integrates with 18 different Lightbox-type scripts:**
1. Lightbox 2
1. Slimbox
1. Slimbox 2
1. Thickbox
1. Lytebox
1. Greybox
1. Lightview
1. jQuery Lightbox Plugin (balupton edition)
1. jQuery Lightbox Plugin
1. Shutter Reloaded
1. Shadowbox
1. FancyBox
1. jQuery Lightbox
1. LightWindow
1. FancyZoom
1. Floatbox
1. Colorbox
1. prettyPhoto
== Installation ==
1. Upload `cleaner-gallery` to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Go to Appearance > Cleaner Gallery to set your preferences.
More detailed instructions are included in the plugin's `readme.html` file.
== Upgrade ==
If you're upgrading from a version prior to version 0.9 of this plugin, please update your plugin settings. You can do so by going to *Appearance > Cleaner Gallery*.
== Frequently Asked Questions ==
= Why was this plugin created? =
The purpose of the Cleaner Gallery plugin is to get rid of the invalid XHTML caused by the default WordPress `[gallery]` shortcode. But, since I was having so much fun with it, I decided to make it compatible with several Lightbox-type image scripts.
= Why do I have one column of images? =
If you expect multiple columns of images but only have one column, go to *Appearance > Cleaner Gallery* and make sure to select the checkbox for loading the Cleaner Gallery stylesheet.
= Why do my galleries look different after upgrading? =
If you're upgrading the plugin, please update your plugin settings. You should always check this when upgrading any plugin. You can do so by going to *Appearance > Cleaner Gallery*.
= Which Lightbox-type scripts will the plugin work with? =
The plugin has been tested and works with these scripts:
1. Lightbox 2
1. Slimbox
1. Slimbox 2
1. Thickbox
1. Lytebox
1. Greybox
1. Lightview
1. jQuery Lightbox Plugin (balupton edition)
1. jQuery Lightbox Plugin
1. Shutter Reloaded
1. Shadowbox
1. FancyBox
1. jQuery Lightbox
1. LightWindow
1. FancyZoom
1. Floatbox
1. Colorbox
1. prettyPhoto
= How do I set it up? =
Well, it should work perfectly fine without any set up. But, if you need to integrate it with a Lightbox-type script or change some of the default settings, head over to *Appearance > Cleaner Gallery* in the WordPress admin. From there, you can select your preferences.
If you need a more detailed guide, see `readme.html`, which is included with the plugin.
== Screenshots ==
Screenshots and a demo can be found on the Cleaner Gallery plugin page.
== Changelog ==
**Version 0.9.2**
* Fixed an IE8 CSS bug with `max-width` and `height`.
* Tested with WordPress 3.2.
**Version 0.9.1**
* Remove the default feature of overwriting the columns if gallery has too few images since users have asked for this.
**Version 0.9**
* Important! Users sould re-save their settings after updating to version 0.9.
* Completely overhauled the plugin settings page to use the WordPress settings API.
* Added the option of loading the Cleaner Gallery stylesheet.
* Made the gallery shortcode script modular, allowing it to be ported to other projects.
* Added support for the prettyPhoto script.
* Plugin now only officially supports WordPress 3.0+.
** Version 0.8**
* Important! Users sould re-save their settings after updating to version 0.8.
* Completely recoded the plugin from the ground up for a much needed code overhaul.
* Added support for the Colorbox script.
* Added the `cleaner_gallery_image_link_class` filter hook.
* Added the `cleaner_gallery_image_link_rel` filter hook.
* Removed the link class and rel options in the admin for the more robust filter hooks.
* Changed the Image Link option to the Default Image Link option, which allows users to always override this setting on a per-post basis.
* Recognizes custom image sizes created using the `add_image_size()` WordPress function.
* Split the plugin into new files so that specific parts of the code are only loaded when needed.
* Changed the settings page to fully support the screen options and meta box functionality of WordPress.
* Moved translations to the `/languages` folder.
* Added the `offset` argument so that users could more easily make paginated galleries.
**Version 0.7**
* Recoded much of the plugin to be more efficient.
* Added the `cleaner_gallery_id()` function to make sure multiple galleries in a single post have different IDs but the same class.
* Added `cleaner_gallery_defaults` filter hook.
* Added `cleaner_gallery_default_settings()` function to better handle user settings.
* Moved Lightbox-type image scripts to an external function from the main script (`cleaner_gallery_link_attributes()`).
* Deprecated CSS functions in favor of using `wp_enqueue_style()`.'
* Dropped support for WordPress 2.5.
* Added support for jQuery Lightbox.
* Added support for LightWindow.
* Added support for FancyZoom.
* Added support for Floatbox.
**Version 0.6.1**
* Added `numberposts` parameter.
* Added `exclude` parameter.
* Added `include` parameter.
**Version 0.6**
* Cleaned up the code to be more efficient and understandable.
* New options added to the settings page, which include *Default Image Size*, *Default Order*, and *Default Orderby*.
* Added support for Slimbox 2.
* Fixed the `[gallery columns="0"]` error.
* Fully documented nearly every function and line of code within the PHP files.
**Version 0.5**
* Added in an options panel.
* Support added for Fancybox.
Earlier versions were not documented well.