WordPress.org

Plugin Directory

Recent Posts Widget Extended

Provides flexible and advanced recent posts. Display it via shortcode or widget with thumbnails, post excerpt, taxonomy and more.

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 http://codex.wordpress.org/Post_Thumbnails 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

rpwe_default_args

Post excerpt

rpwe_excerpt

Post markup

rpwe_markup

Post query arguments

rpwe_default_query_arguments

Requires: 3.7 or higher
Compatible up to: 4.0.3
Last Updated: 2014-12-6
Active Installs: 80,000+

Ratings

4.7 out of 5 stars

Support

2 of 45 support threads in the last two months have been resolved.

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2 100,1,1 100,1,1 100,1,1
100,1,1 100,2,2 100,1,1
100,1,1 100,1,1
100,1,1 100,1,1
100,1,1
100,1,1
100,1,1
83,6,5
100,1,1
0,1,0
100,1,1 100,2,2
100,2,2 100,2,2
0,2,0
0,1,0 63,8,5
75,4,3 50,2,1
78,9,7
89,9,8