=== Bitvolution Image Galleria ===
Contributors: Tom Fotherby
Donate link: http://www.amazon.co.uk/gp/registry/wishlist/5EU9QS88QKOI
Tags: gallery, image-gallery, galleria
Requires at least: 2.8
Tested up to: 2.9.2
Stable tag: 0.0.1

This plugin replaces the default Wordpress gallery feature with a more fancy image gallery inspired by the "Galleria" JQuery Image gallery.

== Description ==

This plugin hijacks the way the in-built Wordpress Gallery is displayed to the user. The Wordpress author uploads images to their pages/posts as normal and uses the usual [gallery] shortcode to display the gallery but instead of the default Wordpress image gallery with rows and columns of images, the user will be shown a more fancy image gallery inspired by the [Galleria JQuery Image gallery](http://devkick.com/lab/galleria/).

This plugin is rather specific and custom - it has no configurable settings. It is designed so, once set up, it is invisible to the Wordpress author - they will not need to learn or do anything different from normal Wordpress gallery usage.

In order to be efficient, the plugin uses the Wordpress in-built image scaling feature - Whenever a Wordpress author uploads a image, Wordpress automatically creates 3 different sizes of the image (A thumbnail size, a Medium size and a Large size). In order to avoid wasteing bandwidth by scaling the image on the front-end, this plugin uses the "thumbnail" size and the "Medium" size images. The disadvantage of this is that the default Wordpress image dimensions aren't really suitable for Galleria and will need to be altered. See the installation insturctions.

Users should follow the Codex on using the [gallery] shortcode: http://codex.wordpress.org/Using_the_gallery_shortcode

Developers can learn more about the WordPress shortcode API: http://codex.wordpress.org/Shortcode_API

Current limitations (i.e. the todo list)

* No image captioning
* No next/previous links

== Installation ==

Here we go:

1. Upload the `bitvolution-image-galleria` folder to the `/wp-content/plugins/` directory.
1. In the Wordpress Dashboard, activate the plugin through the 'Plugins' menu.
1. In the Wordpress Dashboard, go Settings->Media and modify the Thumbnail size to 80x80 (Wordpress default is 150x150) and the Medium size to 500x375 (Wordpress default is 300x300). In this is a brand new site with no images uploaded you can go to the next step. However, if there are already existing images uploaded, Wordpress will not resize them to your new dimensions and so this plugin will not function all that well. To fix this is easy - Install the [Regenerate-Thumbnails](http://www.viper007bond.com/wordpress-plugins/regenerate-thumbnails/) plugin and use it to re-generate all images to your new dimensions. Once done you can remove the Regenerate-Thumbnails plugin.
1. Upload a couple of images to a post and use the normal gallery shortcode `[gallery]` to display the image gallery.
1. Optional for a trivial increase in performance - Copy&Paste the CSS code in bitvolution-image-galleria.css to your themes style.css file and then comment out the line that contains "bitvol_galleria_css" in bitvolution-image-galleria.php.

== Frequently Asked Questions ==

= Can I see a demo of this plugin before I install it on my own site? =

Sure, I'm using this plugin for the image galleries on the following website: www.greekislandpropertyfinders.co.uk/what-we-are-finding

= How do I display a image gallery in my post or page? =

Upload 2 or more images using the normal Wordpress authoring tools and use the `[gallery]` shortcode within your post or page.

= How do I display more than one gallery in a post or page? =

Sorry, you can't.

== Screenshots ==

1. Image gallery with default style.

== Changelog ==

= 0.0.1 =
* This is the first version released. Features: 1) Efficient usage of images (no front-end resizing) no pre-downloading images that aren't needed, 2) Displays loading spinner image when image is loading, 3) Uses CSS classes so you can style the galleria in your own way, 4) Can click on the main image to cycle through the gallery, 5) Uses jQuery for cross-browser hover fade effects, 6) Small JS footprint: 2854 bytes, 7) outputs valid XHTML (unlike the default Wordpress gallery!).