=== Special Recent Posts ===
Contributors: lgrandicelli
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=PZD4ACBRFR9GS
Tags: recent, post, wordpress, plugin, thumbnails, widget, recent posts
Requires at least: 3.0
Tested up to: 3.1.2
Stable tag: 1.6
License: GPLv3 or later


Special Recent Posts (SRP) is a simple but very powerful plugin/widget for WordPress which displays your recent posts with thumbnails.

== Description ==

<p>Special Recent Posts (SRP) is a simple but very powerful plugin/widget for WordPress which displays your recent posts with thumbnails.
You can drag multiple widget instances and configure each one with different settings.
You can also use custom PHP code to insert the widget in any part of your theme.</p>

<p>Special Recent Posts is fully configurable and lets you administrate almost everything about your blog’s recent posts.</p>

<strong>Special features</strong>:
<ul>
	<li>Thumbnails automatic selection and generation</li>
	<li>Thumbnails adaptive resize with GD libraries support</li>
	<li>Thumbnails custom sizes option for every widget instance</li>
	<li>Posts/Pages display option</li>
	<li>Posts/Pages inclusion/exclusion</li>
	<li>Title and content trimming</li>
	<li>Custom Image StringBreak</li>
	<li>Content Tags filtering</li>
	<li>Random mode visualization</li>
	<li>Posts date visualization</li>
	<li>Category filtering</li>
	<li>Current post filtering</li>
	<li>Configurable custom CSS</li>
	<li>Multiple widgets configurations</li>
	<li>Specific PHP function call for theme customization</li>
</ul>

<strong>Plugin's homepage</strong><br />
http://www.lucagrandicelli.com/special-recent-posts-plugin-for-wordpress/

<strong>Credits</strong>
Thumbnail generation is handled by the brilliant PHP Thumb Class
http://phpthumb.gxdlabs.com/

== Installation ==

The automatic plugin installer should work for most people. Manual installation is easy and takes fewer than five minutes.

1. Download the plugin, unpack it and upload the '<em>specialrecentposts</em>' folder to your wp-content/plugins directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to Settings -&gt; Special Recent Posts to configure the basic options.
4. On the widgets panel, drag the Special Recent Posts widget onto one of your sidebars and configure its specific settings.
5. You're done. Enjoy.

If you wish to put the Special Recent Posts in another part of your theme which is not widget-handled, you can put the following snippet:

`<?php if(function_exists('special_recent_posts')) { special_recent_posts($args); } ?>`

$args is an array of options:

`
// Post Type (default: 'posts')
srp_post_type            => post/page

// The Widget Title (default: 'Special Recent Posts')
srp_widget_title         => text

// Display thumbnails? (default: yes)
srp_thumbnail_option     => yes|no

// Thumbnail Width
srp_thumbnail_wdg_width  => numeric

// Thumbnail Height
srp_thumbnail_wdg_height => numeric

// How many posts to display. (default: 5)
srp_number_post_option   => numeric

// Select display order. (default: DESC)
srp_order_post_option    => ASC|DESC

// Want to randomize posts order? (default: no)
srp_orderby_post_option  => rand|no

// Insert the category ID to filter result posts. (default: -1 = none)
srp_filter_cat_option    => -1

// Choose wheter to display only title or both title and excerpt. (default: titleexcerpt = displays both title and text 5)
srp_content_post_option  => titleonly|titleexcerpt

// Show post date? (default: yes)
srp_post_date_option     => yes|no

// Posts/pages to include?
srp_include_option       => numeric

// Posts/pages to exclude?
srp_exclude_option       => numeric

`

Example:
Show last 5 posts in random order without thumbnail.
`
<?php
// Manually defining widget options.
$args = array(
	'srp_number_post_option'  => 5,
	'srp_orderby_post_option' => 'rand',
	'srp_thumbnail_option'    => 'no'
);


// Function call.
special_recent_posts($args);
?>
`
== Changelog ==

= 1.6 =
* Added a new option to include specific posts/pages in widgets.
* Fixed issue: Now thumbnail images paths are dinamically generated from the WP DB options, in case the default "uploads" folder is changed.

= 1.5.1 =
* Fixed some compatibility issue.

= 1.5 =
* Added a new general option which allows to use a button image as stringbreak.
* Added a new general option which allows to display a linked category title instead of the widget custom one when category filter is on.
* Added a new general option which allows particular html tags to be displayed in the generated excerpt text.
* Added an update method which automatically updates db options with newer plugin versions.
* Fixed Bug: Removed unwanted slashes when saving urls in general options
* Fixed Bug: Fixed some compatibility issue with qTranslate.
* Minor bugs fixed

= 1.4 =
* Fixed issue in the deactivation hook. Now plugin settings will be destroyed only when uninstalling and not when deactivating.
* Added custom thumbnails sizes. Now every widget instance has its own thumbnail sizes which will override the default ones.

= 1.3 =
* Added posts/pages exclusion from display view.

= 1.2 =
* Added an option to select whether to display posts or pages.
* Added a simple sanitize function to clear all outputs, avoiding unwanted slashes/backslashes or string breaks.

= 1.1 =
* Fixed issue that displays image captions inside generated excerpt.
* Minor bugs fixed.

= 1.0 = 
* Initial release

== Frequently Asked Questions ==

= Plugin works but i see no thumbnails =

Thumbnails are rendered using the PHP GD libraries. These should be enabled on your server. Do a phpinfo() on your host to check if they're installed properly. Contact your hosting support to know how to enable them.

== Requirements ==

In order to work, Special Recent Posts plugin needs the following settings:

1. PHP version 5+
2. GD libraries installed and enabled on your server.