=== 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
Show images that you searched in your database, and the images are linked to the permalink of the post that the images are attached to.
== Description ==
First of all, sorry for my bad English.
Show images that you searched in your database, and the images are linked to the permalink of posts that the images are attached to.
[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.
* In order to link to the permalink of a post, its post is required to 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
= 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 effective only when first\_image\_mode is on.
* **image\_order** requires the sort type. You can use "ASC" or "DESC". Uppercase only. This attribute is effective 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".
You can also change design of outputted table with CSS. output HTML tags, *table, td, a, img, p,* have a *class="img\_arc"*. *div* before a image have a class="img\_arc\_img", *div* before text have a class="img\_arc\_text". And if you show posts' date, on design=1 and 2, *p* before the post date have a class="img\_arc\_date".
= CSS example =
table.img\_arc {
border: 0 none;
}
div.img\_arc\_img, div.img\_arc\_text {
text-align: center;
line-height: 1;
}
a.img\_arc {
text-decoration: none;
}
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.
== Changelog ==
= 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 to .
* 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