Super Recent Posts Widget

plugin banner

A prettier, filterable and more functional recent posts widget that allows you to choose a custom post type or specific taxonomy.

Author:Mat Gargano, StatenWeb (profile at
WordPress version required:3.6
WordPress version tested:5.3.3
Plugin version:0.3.0
Added to WordPress repository:23-01-2014
Last updated:21-01-2020
Rating, %:100
Rated by:2
Plugin URI:
Total downloads:3 694
Active installs:100+
plugin download
Click to start download

Drag and drop the widget and fill out the appropriate fields. Some notes:

To display posts from a specific post type leave Taxonomy as “– No Specific Taxonomy –“

If you leave order by and/or order as “– Choose order parameter –” and/or “– Choose orderby parameter –” it will go with WordPress’ default(s), see here for more information.

The following filters are available:

  • srpw_get_args to override arguments of main query for the widget.
  • srpw_template to override the output template for the widget, see below for more information.
  • srpw_WIDGET_NAME_template to override the output template for the widget on a widget by widget basis, the WIDGET_NAME appears on the back-end in the widgets window see below for more information.
  • widget_title this is a WordPress core filter see here for more information.
  • srpw_post_types to override the post types available for this widget.
  • srpw_taxonomies to override the taxonomies available for this widget.

Usage of srpw_template filter

Add a “views” directory and file named “custom-srpw.php” to your template directory. The “custom-srpw.php” file will be your custom template for this example.

Example of using a custom template from within your theme pre-PHP 5.3


        function customize_srpw_template_filter( $template ){
            $template_dir = get_template_directory();
            return $template_dir . '/views/custom-srpw.php';
        add_filter( 'srpw_template', 'customize_srpw_template_filter' );

Example of using a custom template from within your theme PHP 5.3+ which allows anonymous functions


        add_filter( 'srpw_template', function ( $template ){
            $template_dir = get_template_directory();
            return $template_dir . '/views/custom-srpw.php';
        } );


This plugin takes advantage of Grunt for validating JavaScript, SASS compilation and minification. To take advantage of Grunt you have to have both npm and Grunt installed. Visit the respective sites for the applications and make sure they are installed. Once installed, if you want to edit/fork this plugin, it will be helpful to be familiar with these two tools.