Ultimate Posts Widget


Try it out on your free dummy site: Click here => https://tastewp.com/plugins/ultimate-posts-widget.
(this trick works for all plugins in the WP repo – just replace “wordpress” with “tastewp” in the URL)

UPDATE: Plugin ownership changed for this plugin. We are currently evaluating possible enhancements for it. Stay tuned! If you have any suggestions yourself, please let us know in the Support Forum.

Note: This is a classic widget type, in order for it to work on the latest version of WordPress you will need Classic Widgets plugin installed on your site.

The ultimate widget for displaying posts, custom post types or sticky posts with an array of options to customize the display.

Designed for both the average user and developer, Ultimate Posts Widgets aims to provide flexibility and ease of use for displaying any kinds of posts within your widget areas. An array of widget options are available as well as hooks, filters and custom templates for more advanced customization.


  • Filter by categories
  • Filter by current category
  • Filter by tags
  • Filter by current tag
  • Filter by custom post types
  • Filter by sticky posts
  • Select number of posts to display
  • Display title
  • Display publish date/time with custom format options
  • Display post author and link
  • Display post comment count
  • Display excerpt or full content
  • Display read more link with custom label
  • Display featured image and at any size
  • Display post categories
  • Display post tags
  • Display custom fields
  • Add text or HTML before and after posts list
  • Add CSS class to widget
  • Add widget title link
  • Change excerpt length (in words)
  • Order by date, title, number of comments, random or a custom field
  • Exclude current post from the list


See the FAQ tab for documentation on custom templates, hooks, common issues, and more.


For help please ask in the Support Forum

Enjoy this plugin? Send a tip to support development.

This plugin is part of the Inisev product family – check out our other products.


  • Example with TwentyTwelve theme with the default widget options
  • General options tab
  • Display options tab
  • Filter options tab
  • Order options tab


  1. Download and extract the zip archive
  2. Upload ultimate-posts-widget folder to /wp-content/plugins/
  3. Activate the plugin through the ‘Plugins’ menu in WordPress
  4. Add the widget to a sidebar and configure the options as desired



upw_enqueue_styles (boolean)
Allows changing whether to load the template CSS file(s).

upw_wp_query_args (array)
Allows changing the WP_Query arguments for the widget.

upw_custom_template_path (string)
Allows changing the default custom template path.


As of version 2.0.0 we changed the widget HTML markup. For installs prior to 2.0.0 you can use the legacy template to retain the old HTML markup and compatibility.

The new standard template as of version 2.0.0. It features better HTML5 markup, improved styling on various themes without the need for custom CSS, and hfeed microformat.

As of version 2.0.0 you can now provide your own custom template files. To do this, create a directory named upw in your theme and copy a template from the plugin’s templates directory. Edit as needed.

Then, in the widget settings under the Display tab, choose Custom from the Template drop down. In the Custom Template Name field that appears and enter the file name of your template (excluding .php). For example, if your template is named custom.php then enter custom in the Custom Template Name field.

Images sizes

As of version 2.0.0, the plugin no longer supports setting custom image sizes from the widget options panel.

To change image sizes you can either edit the built-in sizes (thumbnail, medium, and large) or define a custom image size in your theme functions.php.

Edit built-in image sizes: Go to Settings > Media and change the image sizes as desired. Once image sizes are changed you will need to regenerate thumbnails to update any existing images. This can be done with AJAX Thumbnail Rebuild or Regenerate Thumbnails plugins. Note that this will affect image sizes for the entire site.

Define a custom image size: Edit your functions.php file and add a new image size with the add_image_size function. See the WordPress codex for documentation. Once the function is added, your custom size will be available to select from the widget options. Like editing a built-in size, you will need to regenerate thumbnails for existing images.


<?php add_image_size( 'my-custom-size', 800, 600, false ); ?>

Thumbnail images are not displaying

As of version 2.0.0 timthumb is no longer used.

This plugin uses the timthumb library to resize post thumbnails. Please review these requirements and troubleshooting tips if you are having problems displaying thumbnails.

  • Right click > view image – If an image isn’t loading then this is the first thing you should do. 9 times out of 10 it will tell you what the problem is in an easy to read error message.
  • JetPack plugin – There is a known conflict between JetPack’s “Photon” component, please disable it for compatibility with timthumb.
  • Server requirements – PHP and the GD image library must be installed on your web server. Normally most web servers include them by default.
  • Cache permissions – The cache directory wp-content/plugins/ultimate-posts-widget/cache should be set to 777 or if that doesn’t work, you may find 755 is ok.
  • Image sizes – timthumb is configured to only work for images smaller than 1500 x 1500. The plugin and automatically selects the “Large” size from Settings > Media, if it is greater than 1500 x 1500 you will need to reduce the size or modify the configuration in thumb.php to support larger image sizes.
  • Tilde(~) in url – timthumb has a known issue with this, please use a url without a tilde until a fix is available. Bug report
  • Thumbnail images only work with WordPress’ native post thumbnail / featured image. Many theme use a custom image field for thumbnails, these are not supported.

Still stuck? See additional troubleshooting tips from the timthumb author.


2022 年 11 月 28 日
This plugin recently became a spam address harvester, sending automated emails to registered users asking them to ‘confirm their address’. Don’t install.
2020 年 5 月 22 日
Really love this widget, looks great on my sidebar, once it’s configured. However, that configuration is a bit of a gotcha, as the visibility settings keep reverting to defaults with everything enabled (I only need the titles visible), so any time I change another tab’s settings, I also have to go to the Visibility tab and turn the default stuff back off again as well. It’s like the plugin isn’t reading the current visibility settings, and simply shows its own default selections whenever it loads its view, so that’s what gets submitted on save if you don’t go back in and set them right again.
2018 年 4 月 25 日
This didn’t work at all for me. The Display, Filter, and Order tabs were not clickable, leaving no way to tell it which post(s) to use.
2018 年 2 月 6 日
This is an awesome plugin. It causes issues if you are using the widget on a Divi Sidebar module, it puts part of the sidebar code into the wp-admin dashboard on any pages with that module and widget on it. Unfortunately, I can’t change themes, so I couldn’t use, but overall this is a great plugin with lots of options.
2017 年 4 月 6 日
Thanks for your great plugin Doesn’t your plugin have shortcode? I think, that would be great if you put shortcode for your plugin.
閱讀全部 56 則使用者評論


以下人員參與了開源軟體〈Ultimate Posts Widget〉的開發相關工作。


〈Ultimate Posts Widget〉外掛目前已有 3 個本地化語言版本。 感謝全部譯者為這個外掛做出的貢獻。

將〈Ultimate Posts Widget〉外掛本地化為台灣繁體中文版


任何人均可瀏覽程式碼、查看 SVN 存放庫,或透過 RSS 訂閱開發記錄



  • [NOTE] Adjusted sanitization for widget fields even further
  • [NOTE] Tested up with WordPress 6.4.3


  • [NOTE] Upgraded analyst module to latest version
  • [NOTE] Improved sanitization of widget fields
  • [NOTE] Tested up with WordPress 6.4.2


  • Resolved issue related to “exclude_current” missing index
  • Updated “Try it out” module


  • Fixed incorrect calls to plugins_url
  • Updated banner module
  • Updated opt-in module
  • Tested with WordPress 6.4
  • Resolved issues with PHP 8.2


  • Forced “Try it out” module to be disabled by default, user can still enable it manually.


  • Tested with WP 6.3 RC
  • Updated all shared modules to their latest versions


  • Tested with WordPress 6.2
  • Adjusted old database versions compatibility
  • Updated carrousel module


  • Adjusted PHP compatibility


  • Added try it out module


  • Tested up to WordPress 6.1-RC5
  • Adjusted carrousel module
  • Updated try it out URL in readme to properly setup demo site


  • Tested up to WordPress 6.0
  • Tested with PHP 8.1


  • Tested up to WordPress 5.7.1
  • Added support for PHP 8
  • Updated banner


  • Tested up to WordPress 5.4.2
  • Updated Opt-in


  • Tested up to WordPress 5.4.1
  • Changed info


  • Plugin has been updated up to WordPress 5.4


  • Hotfixed issue


  • Serval improvements


  • Added possibility to exclude current post from the list
  • Tested update WordPress 5.3.3 (beta)+


  • Added possibility for changing custom message when no posts.
  • Increased stability of the plugin
  • Fixed filtering
  • Tested update WordPress 5.3.2+


  • Replaced deprecated code


  • Plugin revival
  • Feedback system integrated
  • Readme updated


  • Tested update WordPress 4.8


  • Fix PHP notice (thanks @rhyswynne)
  • Search custom template both in child theme and in parent (thanks @groucho75)


  • Adds menu order sort by option


  • Updated class constructor for WordPress 4.3 compatibility (thanks @JustB)


  • Adds link to thumbnail images
  • Adds option to show all categories, tags, or types for better usability
  • Improve spacing and font sizes on some themes for the standard template
  • Document adding custom image sizes
  • Add option to display full size post thumbnail
  • Remove post_class() from legacy template for better backwards compatibility


  • Reverts back to using widget_title filter
  • Fixes number of posts setting to allow unlimited amounts
  • Adds instance and widget ID variables to filters for more control


  • Fixes issue loading multiple widgets on the same page and using the same template
  • Adds a default title to the widget for new instances
  • Documentation improvements


  • Added a new standard template and custom template support
  • Added basic CSS styles for better formatting
  • Add hfeed microformat into new standard template
  • Improved widget options interface
  • Add option to filter by tags or current tag
  • Remove timthumb in favor of using built-in WordPress image sizes
  • Remove widget “More Button” options
  • Change date display options to now accept any custom date formats
  • Add before and after posts HTML fields
  • Add option for widget CSS class (thanks @avenirer)
  • Add option to display comment count
  • Set better defaults for newly created widgets
  • Various bug fixes and optimizations

Upgrading from an earlier version?

  • Upgrades from prior to 2.0.0 we retain the “legacy” template for you. To change which template to use, find the “Template” option under the “Display” tab.
  • If you used the “More Button”, you will need to add in your own HTML into one of the new fields since the more button is now removed.
  • If you used custom thumbnail settings you will need to update them. You can now choose from pre-defined sizes available to WordPress. If you need an additional image size please see how to add image sizes.
  • Date formatting has changed, you will need to update your settings. By default it uses WordPress’ date/time options.


  • Adds option to order by custom field (thanks @enekochan)
  • Remove “Permalink to:” from link titles (thanks @wirelessgizmo)
  • Swedish translation (thanks @brstp)


  • Add content display option


  • Add custom field display
  • Re-organized widget options
  • Use proper alt tag for image thumbnails
  • Better title attribute for links


  • Added show author option
  • Added class to highlight current post
  • Fixed PHP error notices


  • Added localization support
  • Added show post categories option
  • Added show post tags option
  • Added custom widget title URL option
  • Improved filter controls for sticky posts
  • Bug fixes


  • Upgrade timthumb to 2.8.11
  • Load “Large” size post thumbnails which should eliminate large image errors
  • Improved FAQ for thumbnail troubleshooting


  • Adds crop mode option
  • Add show published time option
  • Now uses date / time format settings
  • Bug fixes


  • Updates screenshot


  • Fixes show_readmore function
  • Adds more button link option


  • Cleaner widget options
  • Code refactoring and fixes
  • Adds order by option


  • Sticky posts only now optional


  • Added post type filter option.
  • Code cleanup.
  • Better selection mechanism for categories.


  • Added category filter option.


  • First release.