Image Archives

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.
This plugin create a image list that is based on images you uploaded, not based on posts.
This plugin aims to show your recent posts with images for visitors on your site.

See how this plugin works on Sample Page(My site).

If you found any problems with this plugin, please tell me. “nomeu[-at-]nomeu.net”.

NOTICE

• The images you want to show are needed to be attached to posts they were published in (Attaching with post is automatically done by WordPress when you upload images on creating/editing a post).
• In order to link to the permalink of a post, the post must be “published”.
• If a post doesn’t contain a image(external images was not searched), this post is not listed.

HOW TO USE

It is simple. Write a shortcode [image_archives] on the place where you want to show a list of your images linked to their host posts.

But at first, I recommend you to write a shortcode “[image_archives first_image_mode=on]” on a unpublished post.
This “first_image_mode” is a easy way(mode) to show a list. Without configuring a search strings, you can show a list which contains A image per A post.
(If you want to change the number of images per a post, set this attribute “off”.)
(And please note that the ‘first’ image means your ‘first’ uploaded image in a post. If you want to show a first image that is sorted by filename, use “image_order_by=title”. You can also use “image_order=DESC” at the same time. This means a latest image in a post is showed.)

Then you can see the output and how attributes works. After this, set some attributes for this plugin as you want.

Attributes are written like the following.

[image_archives term_id=? ordered_by=? order=? str=? limit=? size=? design=? item=? column=? date_format=? date_show=? cache=?]

Write only your necessary attributes. Default settings are below. Probably you should change “str” and “term_id” at least.

You can also use the php function of this plugin. In order to use the function, write “wp_image_archives();” within php code. As for the attributes, write like below.

wp_image_archives (‘term_id=9&order=DESC&design=1’);

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
• cache = on
• section_name = Section
• section_sort = number
• section_result_number_show = on

Explanation

• first_image_mode is the feature you can show a image per a post without configuring the search strings. Default of this attribute is “off”. If you set first_image_mode=on, you can use the following two settings.
• image_order_by is the method of ordering the searched images within a post. You can use “title” or “date”. This attribute is enabled only when first_image_mode is on.
• image_order requires the sort type within a post. 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 check Term IDs on ‘Post -> Category’ on Dashboard.). You can use several IDs like ‘term_id=1,3,10’. Numbers only. Or you can search all of your categories with ‘term_id=ALL’ (Uppercase only).
• order_by is the method of ordering a list of the images(posts) in the output. You can use “title” or “date”.
• order requires the sort type in the output. 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.
• lmit is a limit of the images that is shown. Write this attribute like ‘start number,the number of posts‘ . example, ‘limit=0,30’ . You can also use this like ‘limit=20,30’.
• size is the size of the images. “thumbnail” or “medium” or “large” or “full”. These actual sizes are based on your WordPress settings.
• design is the type of the output design. “1” to “5” at present. “design=4” and “5” uses jQuery and jQuery UI. “design=4” uses Accordion. “design=5” uses Tabs.
• item is the number of images per a section on “design=4,5”. 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.
• 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”.
• cache is a switch to cache the output. You can use “on” or “off”. If you set “cache=on“, the output cache will be created in the plugin directory. This cache file will be renewed when you publish a article or edit a article.
• section_name is the section name in “design=4,5”. You can change the section name as you like.
• section_sort is the method of sorting section in “design=4,5”. You can set “number” or “category” to this attribute. If you set “category” to this attribute, “limit” will be the limit number of images per a category. And please be careful, using “section_sort=category” takes a little long time, so I recommend you to use “cache=on” at the same time. As for the order of categories, those are ordered by “term_id” you set. If you set “term_id=2,4,6”, the order of the categories is “2,4,6”. So if you want to change the order, you should set it like “term_id=6,2,4”.
• section_result_number_show is a switch to show the number of your search result. You can set “on” or “off”. But this attribute is effective in “design=4,5” and “section_sort=number”.

You can also change design of the output 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 {
  border: 0 none;
}

div.img_arc_img, div.img_arc_text {
  text-align: center;
  line-height: 1;
}

div.img_arc_text a {
  text-decoration: none;
}

When you use jQuery UI designs, please refer to Accordion, Tabs. jQuery automatically will add classes with outputted elements.

As for the color themes of Accordion(design=4) and Tabs(design=5), these themes are changeable. If you want to change themes, visit jQuery UI(https://jqueryui.com/themeroller) and download a theme file. Then, extract it, and overwrite the files of this plugin(/css/) with the downloaded files(/css/THEME_NAME/). In order to overwrite the files, you need to use FTP or else. The files is located under your wordpress folder(/wp-content/plugins/image-archives/css/).

Frequently Asked Questions

• I want to show a chosen image in a post!
  In order to show specific images, I recommend you to name image files nicely.
  For example, if you name images like “aaa-1.jpg“, “bbb-2.jpg“, “ccc-3-IWantToShowThis.jpg“, you can search your database for “ccc-3-IWantToShowThis.jpg” with “str=%IWantToShowThis“.
  In other words, I recommend you add “-thumb” or something to the suffix of your specific image filename. Then search for it.

• I want to show a monthly archive.
  It is basically impossible with this plugin. But technically, it is possible. As I explained above, name the filenames nicely.
  If you name images like “2012-01-abc.jpg“, “2012-01-vvv.jpg“, “2012-02-112.jpg“, you can search for posts in 2012/01 with “str=2012-01-%“.
  I received many questions or requests about this. If you want a monthly archive, please use other plugins.

• I want to search all categories or tags.
  Use “term_id=ALL”.

• I want a paging system on this plugin.
  Sorry, a paging system is not supported by this plugin so far. But alternatively, you can use your wordpress function.
  When you write a article, you can use “<!–nextpage–>” as WordPress quicktag. This is similar to “more” tag.
  This is a WordPress function. Refer to this (https://codex.www.ads-software.com/Styling_Page-Links).
  Exmple,

  [image_archives first_image_mode=on ******* limit=0,30]
  <!–nextpage–>
  [image_archives first_image_mode=on ******* limit=30,30]
  …..

Screenshots

• 

Installation

1. Upload this plugin files to the “/wp-content/plugins/” directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. Write shortcode “[image_archives]” in your post. And configure some attributes.

Reviews

Contributors & Developers

Changelog

0.692

• Show more detailed error message.

0.691

• Update jQuery UI CSS to 1.9.2, jQuery Tabs works properly now.

0.690

• In design 4 or 5, the pages except for the first page are not displayed in loading.

0.68

• Added “term_id=ALL”. With this setting, you can search all of your categories for images.
• Now jQuery Library in WordPress includes is loaded.
• And jQueryUI Library is loaded from Google-CDN.
• So this plugin doesn’t contain jQuery Libraries now. But a jQuery UI theme is contained.
• Although when you showed lists more than one in a post, this plugin loaded duplicate jQuery Libraries, this was fixed.

0.67

• Fixed the height of output contents are wrong in design=4(jQuery UI Accordion). This is a jQuery UI known bug for the Accordion.

0.66

• Changed the cache system. Previously this plugin renewed a cache file when you publish/edit a post, but now this plugin deletes all of the cache files when you publish/edit a post, and creates the cache files when this plugin is first loaded after deleting them. By this change, you can use “cache=on” as many times as you want.
• Default value of “cahce” attribute is changed to “on”.
• Updated jQuery to 1.6.2.
• Updated jQueryUI to 1.8.14.

0.65

• Fixed “image_order_by” attribute to the images being ordered by “title” correctly.

0.64

• Updated jQuery files. Now jQuery 1.6.1 and jQuery UI 1.8.12.

0.63

• Fixed the cache creation function. Now you can update a cache file correctly when you save a post or a page.

0.62

• Fixed the searching query. Now you can search your database with term_id correctly.

0.61

• Fixed the short code for this plugin.

0.60

• Added a config “section_name”. You can change section name in design = 4 or 5.
• Added a config “section_sort”. You can sort the result by category in design = 4 or 5.
• Added a config “section_result_number_show”. You can hide the result number in design = 4 or 5.
• Updated jQuery and jQuery UI files.

0.53

• Change the plugin page.

0.52

• Fixed a cache bug.

0.51

• Fixed the parse_ini_ file error. sorry.

0.50

• Added a cache system.

0.42

• Fixed some code in design=3.

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