=== Flexible Recent Posts ===
Contributors: TheSteelRat
Donate link: https://flattr.com/thing/646464
Tags: recent, post, posts, widget, template, flexible, universal
Requires at least: 3.0
Tested up to: 3.9.1
Stable tag: 1.0.4
License: GPLv2 or later

Displays recent posts using flexible template system. Define template for each post entry, set needed taxonomy and much more.

== Description ==

= Looking for maintainer. Write me to paul.annekov@gmail.com =

Flexible Recent Posts (FRP) plugin gives you possibility to add widget to your blog with recent posts using user-defined template.

**The main features are:**

* **Template** for each post in widget. You can write your HTML-template or overwrite default in widget form.
* **Shortcodes** support in template. You can use built-in shortcodes to insert info related to current post in widget: `title`, `featured image`, `excerpt`, `date`, `permalink`, `author`, `comments`.
* **Restrict terms** from which you want to display posts. Display posts from all terms or from selected only.
* **Number of posts** to display. Set number of latest posts that will be displayed in widget.
* **All posts links**. Select option to display link near the title or/and after all posts that will open selected posts category page. Set link title or custom link URL.

**Useful links:**

* [Template shortcodes](http://wordpress.org/extend/plugins/flexible-recent-posts/other_notes/)
* [Feature requests](http://frp.idea.informer.com/)
* [Bugs](http://wordpress.org/tags/flexible-recent-posts?forum_id=10#postform)
* [Donate (Flattr)](https://flattr.com/thing/646464)

**Translators:**

* Russian (ru) - [Paul Annekov](http://www.steelrat.info/en/)

**Licenses**

* Uses [FatCow Icon Set](http://www.fatcow.com/free-icons) licensed under [Creative Commons Attribution 3.0 License](http://creativecommons.org/licenses/by/3.0/us/).

== Installation ==

1. Upload `flexible-recent-posts` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. Go to `wp-admin/widgets.php` page, move `Flexible Recent Posts` widget to any sidebar and change its defaults

== Frequently Asked Questions ==

= How can I change visual style of widget? =

You can edit `style.css` file in your theme adding needed styles. I will made some predefined styles in feature.

= I have created language pack or updated existing one. How can I send it to you? =

Send [gettext PO and MO files](http://codex.wordpress.org/Translating_WordPress) to me. You can find out my contacts [here](http://www.steelrat.info/en/contacts/).

== Screenshots ==

1. Widget options form
2. Widget on frontend

== Shortcodes ==

Plugin template system supports 5 shortcodes related to current widget post, that you can use in your template:

**Title** [frp_title]

Displays post title.

*Example*: `<h4>[frp_title]</h4>`

**Excerpt** [frp_excerpt length=""]

Displays post excerpt using [get_the_excerpt](http://codex.wordpress.org/Function_Reference/get_the_excerpt "Visit function reference page") function.
You can specify excerpt length using `length` attribute. If not specified - default WordPress excerpt length used.

*Example*: `<div class="excerpt">[frp_excerpt]</div>`, `[frp_excerpt length="15"]`

**Date** [frp_date format="F j, Y" time_since="0"]

Displays post date. You can add `format` shortcode parameter to change date format. Read about format value [here](http://codex.wordpress.org/Formatting_Date_and_Time "Visit customizing time and date reference page").
Add `time_since` parameter with 1 as value to display amount of elapsed time: `30 seconds ago`, `5 minutes ago`, `12 hours ago`, `3 Jun`.

*Example*: `<div class="date">[frp_date format="Y/m/d g:i:s A"]</div>`, `<div class="elapsed">[frp_date time_since="1"]</div>`

**Link** [frp_link]

Displays post permalink.

*Example*: `<a href="[frp_link]">read more</a>`

**Featured image** [frp_thumbnail size="32x32"]

Displays featured post image. Add `size` shortcode parameter to change image size. You can define size using WIDTHxHEIGHT as value or size name (built-in or defined in theme).

*Examples*: `[frp_thumbnail]`, `[frp_thumbnail size="thumbnail"]`, `[frp_thumbnail size="128x128"]`, `[frp_thumbnail size="full"]`

**Author** [frp_author link="1"]

Displays name of the post's author. Set `link` parameter to 0 if you want to disable link (author's site) from author name.

*Examples*: `[frp_author]`, `[frp_author link="1"]`, `[frp_author link="0"]`

**Comments** [frp_comments no_text="1"]

Displays the number of comments. Set `no_text` parameter to 1 if you want to disable comment text (just "23" instead of "23 Comments").

*Examples*: `[frp_comments]`, `[frp_comments no_text="1"]`, `[frp_comments no_text="0"]`

== Changelog ==

= 1.0.4 =
* Increased priority of excerpt length filter.

= 1.0.3 =
* Fixed problem with CSS stylesheet in page content and not in the head section.

= 1.0.2 =
* Fixed problem with missing compressed JS file.

= 1.0.1 =
* Added [frp_comments] shortcode.
* Fixed [bug](http://wordpress.org/support/topic/global-variable-post-and-id-clobbered) when main posts Loop was broken by widget.
* Added `length` attribute to [frp_excerpt] shortcode.

= 1.0.0 =
* Added taxonomies and custom posts support. Now you can use not only categories and regular posts, but custom taxonomies and custom posts.
* More native posts querying procedure.
* Fixed [bug](http://wordpress.org/support/topic/author-not-shown-when-on-search-results-page) when author was not shown on search results page.

= 0.3 =
* Added `[frp_author]` shortcode.
* Added `time_since` parameter to frp_date shortcode to display amount of elapsed time (like on twitter).

= 0.2 =
* Added global post replacement to make shortcodes more native. Now you can use plugin shortcodes in post content.
* Added categories list disable if 'All categories' checkbox is checked.
* Fixed PHP Notices if featured image exists in template with size defined as WIDTHxHEIGHT.
* Fixed shortcodes insert after widget form save.
* Fixed buttons actions on just created widgets on Widgets page.

= 0.1 =
* Init version.