Recent Posts Widget Extended


This plugin will enable a custom, flexible and super advanced recent posts, you can display it via shortcode or widget. Allows you to display a list of the most recent posts with thumbnail, excerpt and post date, also you can display it from all or specific or multiple taxonomy, post type and much more!

Features Include

  • Taxonomy support!
  • Post status option.
  • Custom html or text before and/or after recent posts.
  • Available filter for dev. Please read FAQ.
  • Shortcode feature. Please read Other Notes
  • Better image cropping.
  • Allow you to set title url.
  • Display by date, comment count or random.
  • Display thumbnails, with customizable size and alignment.
  • Display excerpt, with customizable length.
  • Display from all, specific or multiple category.
  • Display from all, specific or multiple tag.
  • Display post date.
  • Display modification date
  • Display comment count
  • Exclude current post
  • Read more option.
  • Post type option.
  • Custom CSS.
  • Multiple widgets.



Developed by Theme Junkie

Shorcode Explanation

Explanation of shortcode options:

Basic shortcode


Display 10 recent posts

[rpwe limit="10"]

Display 10 recent posts with thumbnail

[rpwe limit="10" thumb="true"]

Here’s the full default shortcode arguments

readmore_text="


  • The widget settings


Through Dashboard

  1. Log in to your WordPress admin panel and go to Plugins -> Add New
  2. Type recent posts widget extended in the search box and click on search button.
  3. Find Recent Posts Widget Extended plugin.
  4. Then click on Install Now after that activate the plugin.
  5. Go to the widgets page Appearance -> Widgets.
  6. Find Recent Posts Extended widget.

Installing Via FTP

  1. Download the plugin to your hardisk.
  2. Unzip.
  3. Upload the recent-posts-widget-extended folder into your plugins directory.
  4. Log in to your WordPress admin panel and click the Plugins menu.
  5. Then activate the plugin.
  6. Go to the widgets page Appearance -> Widgets.
  7. Find Recent Posts Extended widget.


How to filter the post query?

You can use rpwe_default_query_arguments to filter it. Example:

add_filter( 'rpwe_default_query_arguments', 'your_custom_function' );
function your_custom_function( $args ) {
    $args['posts_per_page'] = 10; // Changing the number of posts to show.
    return $args;
How to filter the post excerpt?

Post excerpt now comes with filter to easily dev to change/customize it. apply_filters( 'rpwe_excerpt', get_the_excerpt() )

Ordering not working!

Did you installed any Post or Post Type Order? Please try to deactivate it and try again the ordering. (related question)

No image options

Your theme needs to support Post Thumbnail, please go to to read more info and how to activate it in your theme.

How to add custom style?

First, please uncheck the Use Default Style option then place the css code below in the Custom CSS box, then you can customize it to fit your needs

.rpwe-block ul {
    list-style: none !important;
    margin-left: 0 !important;
    padding-left: 0 !important;
.rpwe-block li {
    border-bottom: 1px solid #eee;
    margin-bottom: 10px;
    padding-bottom: 10px;
    list-style-type: none;
.rpwe-block a {
    display: inline !important;
    text-decoration: none;
.rpwe-block h3 {
    background: none !important;
    clear: none;
    margin-bottom: 0 !important;
    margin-top: 0 !important;
    font-weight: 400;
    font-size: 12px !important;
    line-height: 1.5em;
.rpwe-thumb {
    border: 1px solid #eee !important;
    box-shadow: none !important;
    margin: 2px 10px 2px 0;
    padding: 3px !important;
.rpwe-summary {
    font-size: 12px;
.rpwe-time {
    color: #bbb;
    font-size: 11px;
.rpwe-alignleft {
    display: inline;
    float: left;
.rpwe-alignright {
    display: inline;
    float: right;
.rpwe-aligncenter {
    display: block;
    margin-left: auto;
    margin-right: auto;
.rpwe-clearfix:before,.rpwe-clearfix:after {
    content: "";
    display: table !important;
.rpwe-clearfix:after {
    clear: both;
.rpwe-clearfix {
    zoom: 1;
Why so many !important in the css code?

I know it’s not good but I have a good reason, the !important is to make sure the built-in style compatible with all themes. But if you don’t like it, you can turn of the Use Default Styles and remove all custom css code in the Custom CSS box then create your own style.

Available filters

Default arguments


Post excerpt


Post markup


Post query arguments



Categories Feature Didn’t Work for Me

Maybe it’s just me but when I tried the filter by category option, it always returned a grey empty box, even though I tried it with the slugs of each of my categories. IMPORTANT:I’m only using the shortcode option, so if you’re using a widget you may not have this problem. In fact, I tested the widget just to see, and it worked fine.

Additionally I didn’t feel like the default style was very appealing: an ugly font, tiny thumbnails, and a grey box. (Again, speaking of shortcode, the widget looked different)

Otherwise, lots of specific features I needed and more, but won’t be using because I need to separate categories. Didn’t seek support for this issue, because I’m just trying it out and it’s simpler to move on to another plugin, so I can’t condemn their handling of the bug.

Read all 128 reviews

Contributors & Developers

“Recent Posts Widget Extended” is open source software. The following people have contributed to this plugin.


“Recent Posts Widget Extended” has been translated into 4 locales. Thank you to the translators for their contributions.

Translate “Recent Posts Widget Extended” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog – June 9, 2016

  • Updated languages
  • Bump Requires at least to version 4.5
  • Support selective refresh
  • Updated widget sanitization – Nov 09, 2015

  • Sanitize before and after element for better security – 19/09/2015

  • Change text-domain to matches the plugin slug
  • Add: Exclude post option – 13/08/2015

  • Add: Brazilian portuguese translation. Props Gil Barbara
  • Add: Option to show modification date. Props kurt-hectic
  • Add: Option to show comment count. Props Oliver Larsen
  • Improve: Add validation to the Order and Orderby option before saving the widget. – 12/07/2015

  • Prepare to support WordPress 4.3
  • Update: Limit the number of tags and categories displayed in the widget

0.9.9 – 29/11/2014

  • Fix: for “cssID” attribute in shortcodes. Props Ikart
  • Fix: Thumbnail fallback uses get_the_post_thumbnail
  • Add: rpwe-img to the thumbnail.
  • Add: css class option.
  • Improve: Move use styles default option to above the custom css. I’m sorry for the incosistency.
  • Update: Language

0.9.8 – 26/11/2014

  • Fix: Compatibility issue with Get The Image plugin/extension.
  • Fix: Issue with html or text before and after recent posts, now it allow all HTML tags.

0.9.7 – 13/09/2014

  • Add: Relative date option eg: 4 days ago. Props George Venios
  • Add: Featured Video Plus plugin support.
  • Add: Hide widget if no posts exist.
  • Add: Fallback to the image attachment if no image url exist in the resizer script.
  • Fix: Compatibility issue if the user theme use the same code library(Aqua Resizer) and causing blank screen.