=== Agnosia Bootstrap Carousel ===
Author: andrezrv
Tags: bootstrap, responsive, carousel, images, slider
Requires at least: 3.0
Tested up to: 3.5.1
Stable tag: 0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

This plugin lets you use the [gallery] shortcode to show a Bootstrap Carousel.

== Description ==

**Agnosia Bootstrap Carousel** hooks the `[gallery]` shortcode with attribute `type="carousel"` in order to show a **[Bootstrap Carousel](http://twitter.github.io/bootstrap/javascript.html#carousel)** based on the selected images and their titles and descriptions.

This plugin assumes either your theme includes the necessary **Bootstrap** javascript and CSS files to display the carousel properly, or that you have included those files on your own. It will not include the files for you, so if they are not present, the carousel will not work and you will only obtain its bare HTML.

#### Basic example:


`[gallery type="carousel" ids="61,60,59"]`


#### Required attributes:


*	**type:** it needs to be `type="carousel"`.
*	**ids:** you must provide a list of `ids` corresponding to attachments, like `ids="1,2,3"`.

Otherwise, the default `[gallery]` shortcode function will be processed instead of this plugin's one.


#### Optional attributes:


*	**name:** any name. String will be sanitize to be used as an HTML ID. Recomended when you want to have more than one carousel in the same page. **Default:** *agnosia-bootstrap-carousel*. **Example:** `[gallery type="carousel" ids="61,60,59" name="myCarousel"]`
*	**indicators:** indicators position. **Accepted values:** *before-inner*, *after-inner*, *after-control*, *false* (hides indicators). **Default:** *before-inner*. **Example:** `[gallery type="carousel" ids="61,60,59" indicators="after-inner"]`
*	**control:** control arrows display. **Accepted values:** *true* (to show), *false* (to hide). **Default:** *true*. **Example:** `[gallery type="carousel" ids="61,60,59" control="false"]`
*	**interval:** the amount of time to delay between automatically cycling an item. If *false*, carousel will not automatically cycle. **Default:** *5000*. **Example:** `[gallery type="carousel" ids="61,60,59" interval="2000"]`
*	**pause:** pauses the cycling of the carousel on mouseenter and resumes the cycling of the carousel on mouseleave. **Default:** *"hover"*. **Example:** `[gallery type="carousel" ids="61,60,59" interval="hover"]`

== Installation ==

1. Unzip `agnosia-bootstrap-carousel.zip` and upload the `agnosia-bootstrap-carousel` folder to your `/wp-content/plugins/` directory.
2. Activate the plugin through the **"Plugins"** menu in WordPress.
3. Start using the `[gallery]` shortcode to show a [Bootstrap Carousel](http://twitter.github.io/bootstrap/javascript.html#carousel).

== Screenshots ==

1. This is how you should use the shortcode.
2. This is how it should appear in your website. Note that your theme styles may override Bootstrap styles.
3. This is an approximation on how the resultant HTML code should look like.

== Changelog ==

= 0.1 =
* First release!