=== Image Formatr ===
Contributors: eyn, huntermaster
Tags: images, caption, formatting, css, post
Requires at least: 2.0
Tested up to: 2.9
Donate link: http://www.channel-ai.com/blog/donate.php?plugin=image-caption
Stable tag: 0.8

Formats all images on a page / post giving them borders and captions.

== Description ==

Based on: image-caption by Yaosan Yeo @ http://www.channel-ai.com/blog/

Image Formatr goes through all the images on a page and gives them a standardized format.  You can override this format for each image but otherwise all images will be shown as thumbnails and have a caption underneath. Images will also be linked so that when you click on them, they popup in a larger size.

If you surround an image with an anchor tag yourself in the post, then you must add a 'usemyanchor' attribute within the image or else your post anchor will be ignored and replaced. If you do not want the popup effect at all you must add a 'nofx' attribute to the image. If you do not want any caption, you can specify the 'nocap' attribute, or just leave the title blank.

*These rules can all be disabled in the administration settings.*  In addition you can link the caption using the 'link' attribute with a URL as the parameter which will wrap the caption with an anchor link.  The mouseover hint can be set with the 'hint' attribute. And to have the plugin completely ignore an image, and output the content directly from the post, use the 'asis' attribute.

Note: **The popup zoom effect is currently hardcoded to use the Highslide effect.  If you do not want this effect, or you do not have the required plugin installed, then you should uncheck the 'Effects' administration setting.**

Requirements:

 * Highslide Integration plugin: [English](http://wordpress.org/extend/plugins/highslide-integration/), [Deutsch](http://www.scrollleiste.de/online/highslide-integration-in-wordpress) provides the JavaScript popup image zoom.

Image modifier attributes list:

  * nofx
  * usemyanchor
  * nocap
  * link
  * hint
  * asis

Features:

  * generates image captions using the image title
  * standardizes all images on your blog with zero post changes
  * automatically adds width and height attribute to your image
  * zooms image to large size when clicked
  * degrades gracefully when disabled
  * supports [MyCSS](http://www.channel-ai.com/blog/plugins/mycss/ "MyCSS WordPress Plugin") by disabling default CSS import
  * supports custom CSS class for div image container

== Installation ==

1. Download and extract the [Highslide](http://downloads.wordpress.org/plugin/highslide-integration.zip) plugin and the Image Formatr plugin.
1. Upload these extracted directories to your WordPress plugin directory, probably wp-content/plugins
1. Activate the plugins through the 'Plugins' menu in WordPress admin
1. Verify the settings with the 'Setting' menu

== Screenshots ==

1. Image Formatr in action
1. Image Formatr admin

== Usage ==

Once activated, you can start adding captions to your images by adding title attributes to them.  In your post:

    <img
      src="/images/picture.jpg"
      class="alignright"
      title="A sample caption"
      link="http://example.com/"
      hint="Image borrowed from example.com"
    />

After the plugin runs, the output to the browser looks like:

    <div class="img alignright" style="width: 200px;">
    <a
      href="/images/picture.jpg"
      title="A sample caption"
      class="highslide"
      onclick="return hs.expand(this, { slideshowGroup: 'main' })"
    ><img
      src="/images/picture.jpg"
      title="Image borrowed from example.com" alt=""
      width="200" height="132"
    ></a>
    <div style="width: inherit;"><a href="http://example.com/" target="_blank">A sample caption</a></div>
    </div>

CSS classes supported "out of the box" are: center, alignleft, alignright.

== History ==

0.8

* Initial release