=== 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 == 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*: `

[frp_title]

` **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*: `
[frp_excerpt]
`, `[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*: `
[frp_date format="Y/m/d g:i:s A"]
`, `
[frp_date time_since="1"]
` **Link** [frp_link] Displays post permalink. *Example*: `read more` **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.