=== Exhibition ===
Contributors: mkdo, mwtsn, mkjones
Donate link: 
Tags: image gallery, images, gallery, multiple images, thumbnails, multiple thumbnails, carousel, slide show, slide, slides
Requires at least: 3.3
Tested up to: 3.9
Stable tag: 1.1.5
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Add multiple images to any post type. This plugin stores an array of image ids in a custom field, so you can display them however you want.

== Description ==

Created by [Make Do](http://makedo.in/), this plugin will allow you to add multiple images to any post type. 

The plugin stores an array of image ids in a custom field, so you can display them however you want, at whatever size you want by using the built in WordPress wp_get_attachment_image() function.

You can also output the images as a carousel with a built in function. 

Too simple for your needs? Try our [Conveyor](http://wordpress.org/plugins/conveyor/) plugin, that allows you to to create carousel from a 'slides' custom post type, or from any post type.

= Exhibition features =

* Store multiple images against any post type
* Render a Bootstrap compatible carousel
* Comes with a predefined image sizes

If you are using this plugin in your project [we would love to hear about it](mailto:hello@makedo.in).

== Installation ==

1. Backup your WordPress install
2. Upload the plugin folder to the `/wp-content/plugins/` directory
3. Activate the plugin through the 'Plugins' menu in WordPress

== Screenshots ==

1. Add a gallery to any post type via the options page
2. Render your gallery in a bootstrap carousel

== Frequently asked questions ==

= What is the meta field that exhibition stores the image ids in? =

It is:

* '_exhibition_images'

= What functions does this plugin provide? =

You can use:

* exhibition_render_bootstrap()

= What does exhibition_render_bootstrap() do? =

This function will render a Bootstrap 3 carousel. You can use it like so: 

`exhibition_render_bootstrap( $post_id, $args );`

It accepts the ID of the post you wish to render the images of, as well as an array of arguments that dictate how it renders. 

Use the defaults like so:

`
$defaults = array(
	'id'						=> 'exhibition_carousel',				// If you want to have multiple carousels, you will want to change the id each time
	'image_size'				=> 'golden-ratio-1024',					// [ thumbnail | medium | large | full | custom ] - the image size you wish to output
	'render_controls'			=> true,								// [ true | false ] - Show the slide left right controls
	'render_indicators'			=> true 								// [ true | false ] - Show the slide indicators
);

exhibition_render_bootstrap( $post_id, $defaults );
`

= The bootstrap carousel isnt working, what do I need to do? =

The plugin will only render the HTML and JavaScript configuratio for the carousel, you will need to add Bootstrap CSS and JS to your theme.

= What custom image sizes are created by this plugin? =

The image sizes are:

* 'golden-ratio-2560' - 2560 x 1582
* 'golden-ratio-2048' - 2048 x 1266
* 'golden-ratio-1920' - 1920 x 1186
* 'golden-ratio-1680' - 1680 x 633
* 'golden-ratio-1440' - 1440 x 890
* 'golden-ratio-1280' - 1280 x 791
* 'golden-ratio-1024' - 1024 x 633
* 'golden-ratio-800' - 800 x 494
* 'golden-ratio-640' - 640 x 396
* 'square-75' - 75 x 75
* 'square-150' - 150 x 150
* 'square-300' - 300 x 300
* 'square-600' - 600 x 600
* 'square-1200' - 1200 x 1200

= The custom image sizes dont seem to work, help! =

The image sizes will only take effect on images you have uploaded after this plugin has been installed, however there are other plugins out there (such as [WPThumb](http://wordpress.org/plugins/wp-thumb/)) that will fix this for you.

If it still isnt working, check that you have the 'GD' module installed in your PHP environment. If you havent, you can install it like so:

`apt-get install php5-gd`

= Can I contribute? =

Sure thing, the GitHub repository is right here: (https://github.com/mwtsn/exhibition)

== Changelog ==

= 1.1.9 =
* Tested plugin with WordPress 3.9

= 1.1.4 = 	
* Fixed ability to add to gallery and editor

= 1.1.3 =
* Fixed bug in JavaScript

= 1.1.2 =
* Minor ammendments

= 1.1.1 =
* Fixed issue with Bootstrap in function names

= 1.1.0 =
* Added carousel render

= 1.0.0 =
* Initial WordPress repository release

== Upgrade notice ==

Prior to version 1.1.1 the function exhibition_render_bootstrap() was called exhibition_render_boostrap(), a legacy function has been added to route the call, so the change shouldn't cause any issues.