=== WP ImageTagger ===
Contributors: phd
Donate link: http://www.photos-dauphine.com/wp-imagetagger-plugin
Tags: images, photos, tags, search, gallery, classification
Requires at least: 2.7
Tested up to: 2.7
Stable tag: 1.2


== Description ==

The WP ImageTagger plugin allows to associate the tags you created in your WordPress blog to any image part of your posts or pages.

The following functionalities are enabled in your blog after installing the ImageTagger plugin package :

> - Associate tags to images from the plugin admin panel
> - Associate tags to images from any post or page by clicking on your image caption
> - Create a page to offer your visitor to search for any image associated to a list of tags
> - Select a display mode for your result page : itemized image list or thumbnail gallery

   
== Installation ==

To install the WP ImageTagger plugin just follow these simple steps:

1. Download the plugin and expand it to an empty directory of your local disk drive.
2. Copy the local wp-imagetagger folder created by the unzipper onto your server plugins folder (wp-content/plugins/). Make sure you end up with all the PHP files, readme.txt and screenshots in wp-content/plugins/wp-imagetagger directory.
3. Login into the WordPress administration area and go to the Plugins page.
4. Locate the ImageTagger plugin and click on the activate link
5. Make sure your blog already holds posts or pages with images
6. Make sure you already created a list of tags for your blog
7. Start associating your blog images with any tag of your blog. Two methods for this purpose :

	> - From your WordPress administration panel, go to Manage > ImageTagger and start associating the first image found to any tag ;
	> - Alternatively: from any post or page holding images, click on any image caption (being administrator) and do the association with any tag.
	
8. Display a search form to allow searching by tags in your image database :

	> - Create a new page.
	> - Make sure you can run PHP code from your page text (using plugins like runPHP).
	> - From your WordPress editor, enter the single line code : `<?php wpit_multisort_insert(); ?>`

If you are interested in seeing the plugin in action, you might wish to go and have a look [here](http://www.photos-dauphine.com/phototheque "Check out here the WP ImagerTager plugin in action").  

More information on this plugin utilization can be found [there](http://www.photos-dauphine.com/wp-imagetagger-plugin "WP Image Tagger Home").

That's all for today - Enjoy !


== Frequently Asked Questions ==

= How is my WordPress database affected by this plugin ? =

ImageTagger does not affect any of the existing WP table. The relationships you create between tags and images are stored in a new table "wp_term_relationships_img".

= What are the pre-requisites to run this plugin ? =

At least one image should be present in your blog. Otherwise the ImageTagger admin panel will inform you that you need to start working on your blog !

= How can I know if an image is tagged or not ? =

A tooltip appears if you put your mouse pointer over the image caption. This tooltip displays the tags associated to the image. 

= How are the images displayed on the result page ? =

This is done using either an itemized image list, or a thumbnail gallery. A possibility is offered to the visitor to switch from one display mode to the other. 

= What are the available languages ? =

English is the primary version. French to follow.


== Screenshots ==

1. ImageTagger administration interface
2. ImageTagger image search form implementation


== Changelog ==

= 1.0 =
- First release. ImageTagger concept implemented with the minimum features set enabling root functions. Plugin available in French. English localization on going.

= 1.1 =
- Admin panel offers now a bunch of settings, like capability to display the list of images matching the searched tags in a gallery or itemized list mode.
- Result page is paginated. Number  of images shown is a parameter.
- Most of the messages are translated to English.

= 1.2 =
- Admin panel : input parameters are now validated against expected valid parameter ranges to make sure the plugin will not be shot by funky option settings. In case of inproper entry, an explicit message is displayed while highlighting the faulty option entry line.

= In progress =
- Language localization I18n : english default, french, .POT file provided for volunteers.

= Future =
- Access to the ImageTagger search function through a tag cloud `<?php wpit_tag_cloud(); ?>` ;  note that this search will not allow multi criteria search as provided with the current `<?php wpit_multisort_insert(); ?>` API.