=== Image Archives ===
Contributors: coppola00
Donate link: 
Tags: image, archive, post list, list, thumbnail, jQuery
Requires at least: 2.0
Tested up to: 2.9.2
Stable tag: trunk

Image Archives is a wordpress plugin that displays images from your published posts with a permalink back to the post that the image is connected to. It can also be used as a complete visual archive or gallery archive with several customizable settings.


== Description ==
First of all, sorry for my bad English.

Image Archives is a wordpress plugin that displays images from your published posts with a permalink back to the post that the image is connected to. It can also be used as a complete visual archive or gallery archive with several customizable settings.

[Sample](http://if-music.be/2009/11/10/image-archives/)

= NOTICE =
* The images that you want to show is needed to be attached to posts they were published in.
* In order to link to the permalink of a post, the post must be "published".

= HOW TO USE =
Write shortcode "\[image\_archives\]" in the place you want to show the image archives.
And you can set some attributes.

\[image\_archives *term\_id=?* *ordered\_by=?* *order=?* *str=?* *limit=?* *size=?* *design=?* *item=?* *column=?* *date_format=?* *date_show=?*\]

Write only necessary attributes. Default settings are below. Probably you need to configure "str" and "term_id".

You can also use the function of this plugin. In order to use the function, write *wp\_image\_archives\(\);* within php code. And in order to use the attributes, write like below.

wp\_image\_archives \('term\_id=9&order=DESC&design=1'\);

Added the first\_image\_mode. Without configure the search strings you can search a image in a post, and show a image per post. If you want to show the images of your posts easily, use this feature.

\[image\_archives first\_image\_mode=on\]

The 'first' image means your 'first' uploaded image in the post. If you want to show the first image that is sorted by filename, use *image\_order\_by=title*. You can also use *image\_order=DESC*. If you use DESC, the latest image in the post is showed.

= Default values =
* first_image_mode = off
* image_order_by = date
* image_order = ASC
* term\_id = 1
* order\_by = title
* order = ASC
* str = %
* limit = 0,50
* size = medium
* design = 2
* item = 9
* column = 3
* date\_format = Y-m-d
* date\_show = off
* title\_show = on

= explanation =
* **first\_image\_mode** is the feature you can show a image per post without configuring the search strings. Default setting of this feature is off. If you configure first\_image\_mode=on, you can use below two settings.
* **image\_order\_by** is the method of ordering the searched images.  You can use "title" or "date". This attribute is enabled only when first\_image\_mode is on.
* **image\_order** requires the sort type. You can use "ASC" or "DESC". Uppercase only. This attribute is enabled only when first\_image\_mode is on.
* **term\_id** requires unique ID(s) of tags or categories. You can use several IDs like 'term\_id=1,3,10'. Numbers only.
* **order\_by** is the method of ordering a list of the images(posts).  You can use "title" or "date".
* **order** requires the sort type. You can use "ASC" or "DESC". Uppercase only.
* **str** is a search string. The search string must be a part of the file name of images you uploaded. This plugin searches "post\_title"(these are seen in "MEDIA LIBRARY" -> "FILE" or "TITLE") in your wordpress database for the string. This string is required to be SQL LIKE condition string. Please refer to [SQL LIKE condition](http://www.techonthenet.com/sql/like.php).
* **lmit** is a limit of the images that is shown. Write this attribute like '*start number*,*end number*' . example, 'limit=0,30' . You can also use this like '20,50'.
* **size** is the size of the images. "thumbnail" or "medium" or "large" or "full".
* **design** is the type of output design. "1" to "5" at present. design=4,5 use jQuery. design=4 uses [Accordion](http://jqueryui.com/demos/accordion/). design=5 uses [Tabs](http://jqueryui.com/demos/tabs/).
* **item** is the number of images per a page(section). This attribute is enabled only when "design=4,5".
* **column** is the number of columns. This attribute is enabled only when "design=2,4,5".
* **date\_format** is the date format. Please refer to [PHP.net date format](http://php.net/manual/en/function.date.php).
* **date\_show** is a switch to show posts' date or not. You can use "on" or "off".
* **title\_show** is a switch to show posts' title or not. You can use "on" or "off".

You can also change design of outputted table with CSS. output HTML tags, *table, div* have a *class="img\_arc"*. *div* before a image have a class="img\_arc\_img", *div* before text have a class="img\_arc\_text".

= CSS example =

table.img\_arc { <br />
&nbsp;&nbsp;border: 0 none;<br />
}

div.img\_arc\_img, div.img\_arc\_text { <br />
&nbsp;&nbsp;text-align: center; <br />
&nbsp;&nbsp;line-height: 1; <br />
}

div.img\_arc_text a { <br />
&nbsp;&nbsp;text-decoration: none; <br />
}

As for jQuery design CSS, please refer to [Accordion](http://jqueryui.com/demos/accordion/), [Tabs](http://jqueryui.com/demos/tabs/).

== Installation ==

1. Upload this plugin files to the "/wp-content/plugins/" directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Write shortcode "[image_archives]" in your post. And  configure some attributes.


== Screenshots ==
1. Output designs of 1-3. Please be careful, this is old.


== Changelog ==

= 0.41 =
* Changed the output source. Some output tags were changed not to have ' img_arc' class.
* Added 'title\_show' attribute.


= 0.40 =
* Added the first image mode. Without configure the search strings you can search a image in a post, and show a image per post.

= 0.34 =
* Change a part of output in design=3 from <p\> to <div\>.
* Change output. If a post have several categories or tags and you set several numbers to *term\_id*, the image of the post appears only once.

= 0.33 =
* Default "str" attributes, now "str=%".
* Updated jQuery to version 1.4.2.

= 0.32 =
* Fixed some code.

= 0.31 =
* Fixed some code.

= 0.30 =
* Added design=4,5. This design use jQuery. JavaScript needed.
* Now 'item' means the number of images per a page. You can determine the number of columns with 'column'.

= 0.21 =
* Fixed some code.
 
= 0.20 =
* Add a template tag of this plugin. *wp\_image\_archives*.
* Add attributes "limit", "date\_format", "date\_show".
* Add design=3.
* Default *term\_id* is changed to 1.
* Changed class names.
* Fixed some codes.

= 0.11 =
* Add a attribute "title" to output img tags.

= 0.10 =
* Release