=== 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: 2.6
Tested up to: 2.8
Stable tag: 0.7

A cleaner WordPress [gallery] that integrates with multiple Lightbox-type scripts.

== Description ==

*Cleaner Gallery* was written to take care of the invalid XHTML 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 XHTML 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 JavaScript unless you choose to do so.

**Integrates with 16 different Lightbox-type scripts:**

1. <a href="http://www.huddletogether.com/projects/lightbox2/" title="Lightbox 2">Lightbox 2</a>
1. <a href="http://www.digitalia.be/software/slimbox" title="Slimbox">Slimbox</a>
1. <a href="http://www.digitalia.be/software/slimbox2" title="Slimbox 2">Slimbox 2</a>
1. <a href="http://jquery.com/demo/thickbox/" title="Thickbox">Thickbox</a>
1. <a href="http://dolem.com/lytebox/" title="Lytebox">Lytebox</a>
1. <a href="http://orangoo.com/labs/GreyBox/" title="Greybox">Greybox</a>
1. <a href="http://www.nickstakenburg.com/projects/lightview/" title="Lightview">Lightview</a>
1. <a href="http://www.balupton.com/sandbox/jquery_lightbox/" title="jQuery Lightbox (balupton edition)">jQuery Lightbox Plugin</a> (balupton edition)
1. <a href="http://leandrovieira.com/projects/jquery/lightbox/" title="jQuery Lightbox">jQuery Lightbox Plugin</a>
1. <a href="http://www.laptoptips.ca/projects/wp-shutter-reloaded/" title="Shutter Reloaded">Shutter Reloaded</a>
1. <a href="http://mjijackson.com/shadowbox/index.html" title="Shadowbox">Shadowbox</a>
1. <a href="http://fancy.klade.lv" title="FancyBox">FancyBox</a>
1. <a href="http://github.com/krewenki/jquery-lightbox/tree/master" title="jQuery Lightbox">jQuery Lightbox</a>
1. <a href="http://www.stickmanlabs.com/lightwindow" title="LightWindow">LightWindow</a>
1. <a href="http://www.cabel.name/2008/02/fancyzoom-10.html" title="FancyZoom">FancyZoom</a>
1. <a href="http://randomous.com/floatbox/home" title="Floatbox">Floatbox</a>

== Installation ==

1. Upload `cleaner-gallery` to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Go to <em>Appearance > Cleaner Gallery</em> to set your preferences.

More detailed instructions are included in the plugin's `readme.html` file.

== 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.

= Which Lightbox-type scripts will the plugin work with? =

The plugin has been tested and works with these scripts:

1. <a href="http://www.huddletogether.com/projects/lightbox2/" title="Lightbox 2">Lightbox 2</a>
1. <a href="http://www.digitalia.be/software/slimbox" title="Slimbox">Slimbox</a>
1. <a href="http://www.digitalia.be/software/slimbox2" title="Slimbox 2">Slimbox 2</a>
1. <a href="http://jquery.com/demo/thickbox/" title="Thickbox">Thickbox</a>
1. <a href="http://dolem.com/lytebox/" title="Lytebox">Lytebox</a>
1. <a href="http://orangoo.com/labs/GreyBox/" title="Greybox">Greybox</a>
1. <a href="http://www.nickstakenburg.com/projects/lightview/" title="Lightview">Lightview</a>
1. <a href="http://www.balupton.com/sandbox/jquery_lightbox/" title="jQuery Lightbox (balupton edition)">jQuery Lightbox Plugin</a> (balupton edition)
1. <a href="http://leandrovieira.com/projects/jquery/lightbox/" title="jQuery Lightbox">jQuery Lightbox Plugin</a>
1. <a href="http://www.laptoptips.ca/projects/wp-shutter-reloaded/" title="Shutter Reloaded">Shutter Reloaded</a>
1. <a href="http://mjijackson.com/shadowbox/index.html" title="Shadowbox">Shadowbox</a>
1. <a href="http://fancy.klade.lv" title="FancyBox">FancyBox</a>
1. <a href="http://github.com/krewenki/jquery-lightbox/tree/master" title="jQuery Lightbox">jQuery Lightbox</a>
1. <a href="http://www.stickmanlabs.com/lightwindow" title="LightWindow">LightWindow</a>
1. <a href="http://www.cabel.name/2008/02/fancyzoom-10.html" title="FancyZoom">FancyZoom</a>
1. <a href="http://randomous.com/floatbox/home" title="Floatbox">Floatbox</a>

= 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 <a href="http://justintadlock.com/archives/2008/04/13/cleaner-wordpress-gallery-plugin" title="Cleaner Gallery">Cleaner Gallery plugin page</a>.

== Changelog ==

**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 <a href="http://github.com/krewenki/jquery-lightbox/tree/master" title="jQuery Lightbox">jQuery Lightbox</a>.
* Added support for <a href="http://www.stickmanlabs.com/lightwindow" title="LightWindow">LightWindow</a>.
* Added support for <a href="http://www.cabel.name/2008/02/fancyzoom-10.html" title="FancyZoom">FancyZoom</a>.
* Added support for <a href="http://randomous.com/floatbox/home" title="Floatbox">Floatbox</a>.

**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 <a href="http://www.digitalia.be/software/slimbox2" title="Slimbox 2">Slimbox 2</a>.
* 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.