=== Related Posts Thumbnails ===
Contributors: marynixie
Donate link: http://wordpress.shaldybina.com/donate
Tags: related, posts, thumbnail
Requires at least: 2.9
Tested up to: 2.9.2
Stable tag: 1.2

Customizable plugin, that nicely displays related posts thumbnails under the post.

== Description ==

This plugin will add related posts thumbnails after the post. Plugin allows to customize thumbnail sizes, display settings and type of relation.

By default it uses generated by Wordpress thumbnail for the first image appeared in the post, that was uploaded on the server with sizes as set in Media settings. You can select between 'thumbnail' and 'medium' size options. In addition if your theme supports Post Thumbnails feature introduced in Wordpress 2.9 you can specify custom thumbnail size. You can also specify post custom field name to be used as thumbnails source.

Thumbnails are arranged in columns under the post with related posts title/excerpt under each post thumbnail. Colors of background, border, text, text sizes, background on mouse over, title and excerpt length can be customized. See screenshot.

You can specify number of related posts to display, top text, style settings, default image URL. You can select type of relation - categories, tags or categories and tags. You can specify where to display related posts - choose page type (main or single) and select categories. You can turn off automatic appending to the end of post and use **<?php get_related_posts_thumbnails(); ?>** php tag in the Loop of your theme. Related Posts thumbnails sidebar widget is also available. You can use [related-posts-thumbnails] shortcode in the post body.

Related Links:

* <a href="http://wordpress.shaldybina.com/plugins/related-posts-thumbnails/" title="Related Posts Thumbnails Plugin for WordPress">Plugin Homepage</a>
* <a href="http://codex.wordpress.org/Post_Thumbnails" title="Wordpress page about Post Thumbnails feature">Wordpress Post Thumbnails feature page</a>
* <a href="http://wordpress.org/extend/plugins/regenerate-thumbnails/" title="Regenerate Thumbnails plugin">Regenerate Thumbnails</a> - plugin for regenerating images after changing Media settings or theme post thumbnails support options
* <a href="http://wordpress.shaldybina.com/plugins/generate-post-thumbnails/" title="Generate Post Thumbnails Plugin for WordPress">Generate Post Thumbnails Plugin</a> - plugin for assigning post thumbnails for existing posts
* <a href="http://markjaquith.wordpress.com/2009/12/23/new-in-wordpress-2-9-post-thumbnail-images/" title="New in WordPress 2.9: Post Thumbnail Images - Mark on WordPress">New in WordPress 2.9: Post Thumbnail Images &laquo;  Mark on WordPress</a>

== Installation ==

1. Extract zip in the /wp-content/plugins/ directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Customize plugin settings under Settings -> Related Posts Thumbs

== Frequently Asked Questions ==

= How does this plugin decide which image to use as post thumbnail? =

If your theme supports Wordpress Posts Thumbnail feature and post has a specified Post Thumbnail as seen on Edit Post page, when this image will be used as a post thumbnail in related posts. The size of the image is determined by plugin setting 'Post-thumbnails name'.

If your theme does not support Post Thumbnail feature or post has no assigned thumbnail, when the first image on the post will be used as a thumbnail.

= Does plugin support external images, e.g. uploaded on Flickr? =

There is no direct support of external images in the current version of the plugin. You can use custom field option. Or you can use http://wordpress.org/extend/plugins/generate-post-thumbnails/ or similar plugin to save external images as post thumbnails.

= What is the default image URL? =

If there are no images of the specified size in the post, or file does not exist on the server the default image will be used as a post thumbnail. You can upload your image on server and specify its URL in plugin settings.

== Screenshots ==

1. Plugin in action
1. Plugin settings page

== Changelog ==

= 1.2 =
* added php tag for use in theme
* added option to turn off automatic appending
* set title length 0 for no title
* added excerpt
* added sidebar widget
* added shortcode

= 1.1.1 =
* removed PHP warning on settings page somebody may experience
* full HTML support in top text field

= 1.1 =
* removed PHP warnings for getimagesize and file if wrong header was received
* fixed Categories and Tags confusion (when you selected Categories relation was based on Tags and vice versa)
* added Categories option to select specific categories
* added post custom field name option as a source for thumbnails 

= 1.0 =
* Released plugin initial version

== Upgrade Notice ==

= 1.2 =
This version supports php tag, title and excerpt length, sidebar widget.

= 1.1.1 =
This version includes elimination of warning on settings page some may experience, plus full html support in top text field. 

= 1.1 =
This version includes categories/tags confusion in settings, elimination of warnings in case of wrong headers, new features - Categories and custom field support. 

= 1.0 =
The first released version