=== 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.2
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>Posts/Pages selection</li>
	<li>Title and content trimming</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

// 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
`

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.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.