We're merging with GenerateBlocks! Learn more here.

WP Show Posts 1.2.0

This is an alpha version. Please test it, but only on test and staging sites – not sites with a lot of live traffic.

Learn how to install beta versions here.

This our first feature release in quite a while. This version adds some new features and fixes some existing bugs.

This is likely the last feature release until we release our WPSP block, which we’re very excited for.

Image Sizes

Image resizing in WordPress is hard. WPSP has always used Aqua Resizer for on-the-fly image resizing. However, we’ve grown to dislike this method due to various incompatibilities and performance issues.

In 1.2.0, we simply allow you to choose from the existing sizes generated by WordPress. Of course, you can add your own sizes using the add_image_size() function.

If you’re already using the legacy image resizer, it will continue to work as it is now.

Better Code

We went through the code to make sure the plugin is as extendable as possible. This meant passing the individual list settings to every single hook and filter, which allows for better extendability when you need to go beyond the options.

We also cleaned up a lot of the overall code to be better escaped for easier readability.

Full Changelog


  • Add wpsp_before_comments_link hook


  • Pass $image_string variable to wpsp_date_output filter


  • New: Image size selection option
  • New: Add shortcode to post list Dashboard view
  • New: wpsp_content_more_link filter
  • New: wpsp_title_href filter
  • New: wpsp_post_date_show_updated_only filter
  • New: wpsp_query_args filter
  • New: Change read more button border size to 1px
  • New: Microdata option
  • Fix: Broken orderby option
  • Fix: AJAX pagination notice if there aren’t enough posts
  • Fix: Exclude current bug if the ID is set in the IDs field
  • Fix: Bug where exclude ID option was ignored on single posts
  • Tweak: Show empty categories in taxonomy list
  • Tweak: Add $settings parameter to AJAX pagination function
  • Tweak: Escape values later
  • Tweak: Remove “WP” from admin menu item title
  • Tweak: Add field description to Columns gutter option
  • Tweak: Pass $settings to wpsp_default_image_size
  • Tweak: Remove matchHeight.js
  • Tweak: Remove clear element inside columns
  • Tweak: Better updated time calculation
  • Tweak: Deprecate old image resizer
  • Tweak: Harden AJAX security
  • Tweak: Make sure all filters have settings passed to them

WPSP Pro 1.0

WP Show Posts Pro 1.0.0 is now available! This update has a lot of small fixes and some new exciting features.


We’ve implemeted a handful of pre-built card styles thanks to David Beckwith at Flint Skin. These cards make it easier to accomplish various complicated designs.

You can check out demos of the available cards here.


You can now display your posts within a simple carousel! Carousels work with your existing list settings, including all the styling options and even the new cards!

You can check out demos of some carousels here.



  • New: Carousel option
  • New: Card Presets
  • New: Title font size
  • New: Section classes option
  • New: Image color overlay (not on hover)
  • New: RGBA color pickers for image overlay colors
  • Tweak: Open social sharing links in small windows
  • Tweak: Remove Google+ option
  • Tweak: Add GDPR message to Love it option
  • Tweak: Use full image in lightbox
  • Tweak: Add support for button class option in AJAX pagination button
  • Tweak: Fix padding option label
  • Tweak: Improve how pro options get list settings
  • Tweak: Update the updater
  • Tweak: Overall code cleanup
  • Tweak: Add wpsp_pro_love_icon_disable_ip_store filter
  • Tweak: Minify featherlight scripts and styles
  • Tweak: Improve hover icon placement
  • Tweak: Improve license key page
  • Tweak: Deprecate wpsp_pro_update_read_more_values()
  • Tweak: Make sure featured image exists before outputting Pinterest icon
  • Tweak: Add $settings parameter to wpsp_featherlight_gallery_args filter
  • Tweak: Add $settings parameter to wpsp_ajax_pagination_button_output filter
  • Tweak: Add $settings parameter to wpsp_ajax_load_more filter
  • Tweak: Add post-load trigger to AJAX pagination script
  • Tweak: Serve minified AJAX pagination script
  • Fix: Lightbox/gallery getting confused on pages with multiple lists
  • Fix: Make social icon colors list-specific
  • Fix: Order comments options better in list settings

WPSP 1.1

WP Show Posts 1.1 has been released.

This is a major code re-write which will allow us to update and add to the pro version more freely.


  • New: Button class option
  • Fix: Duplicate post classes
  • Fix: Post classes PHP notice in some themes
  • Fix: PHP 7.2 PHP warning while editing lists
  • Tweak: Pass $settings to wpsp_wrapper_atts filter
  • Tweak: Remove font-size and line-height CSS (allow themes to handle it)


  • Fix: Performance issue dealing with lots of terms in list admin
  • Fix: Post class clashes with GP Premium
  • Tweak: Allow name in shortcode instead of ID
  • Tweak: Use theme defined font size for title elements (removes the default 30px)


  • Fix: Fix image hover effects in WPSP Pro


  • New: Allow multiple taxonomy terms to be selected
  • New: Choose the title HTML element
  • New: wpsp_disable_title_link filter
  • New: wpsp_disable_image_link filter
  • New: wpsp_read_more_output filter
  • New: wpsp_inside_wrapper hook
  • New: wpsp_image_attributes filter
  • New: wpsp_term_separator filter
  • New: Option to add comments number/link in post meta
  • New: Allow override of settings within shortcode parameter
  • New: Add standard post classes to each post
  • Tweak: Remove many function_exists() wrappers – check your custom functions!
  • Tweak: Pass list settings through hooks instead of using global
  • Tweak: Clean up code considerably
  • Tweak: Use the_excerpt() instead of custom function
  • Tweak: Remove border radius from read more buttons
  • Fix: Broken author setting
  • Fix: Remove image float on mobile
  • Fix: Missing color labels in WP 4.9

WPSP Pro 0.5

WP Show Posts Pro has been released with a focus on more styling features.

Take a look at what changed here:

  • New: Background color + hover
  • New: Title color + hover
  • New: Meta color + hover
  • New: Text color + hover
  • New: Link color + hover
  • New: Read more background + hover
  • New: Read more text + hover
  • New: Read more border + hover
  • New: Twitter color + hover
  • New: Facebook color + hover
  • New: Google+ color + hover
  • New: Pinterest color + hover
  • New: Love icon color + hover
  • Tweak: Remove old fixed read more colors – your chosen color will be brought over to your new color options
  • Tweak: Show license key area only to administrators
  • Tweak: Move styling options from “Styling” tab into their respective sections
  • Tweak: Improve licensing system
  • Fix: WooCommerce style conflict
  • Fix: Only add negative margin when columns are active

WPSP 1.0

  • Add new hook inside image container: wpsp_inside_image_container
  • Fix issue with pagination and random post ordering
  • Clean up defaults to only include free options
  • Add margin to the top of pagination
  • Use manual excerpt if it’s set

WPSP 0.7

  • Prevent direct access to files
  • Add prefix to all column classes to avoid conflicts
  • Use wp_trim_words() function for excerpts
  • Fix conflict with Maintenance plugin
  • Make columns full width on mobile
  • Allow more tag usage when excerpt is set
  • Add blank option in widget to fix bug in Customizer/Elementor

WPSP 0.6

  • Add height: auto to images to prevent image stretching in Beaver Builder
  • Prevent horizontal scrolling when posts are in columns
  • Change “More query args” section name to “More settings”
  • Allow multiple IDs in “Post ID” option
  • Add “Exclude IDs” option
  • Add “No results message” option
  • Add “WP Show Posts” widget to add posts in widget areas

WPSP Pro 0.4

WPSP Pro 0.4 has been released with the following fixes and additions:

  • Apply filter to load more text and make translatable
  • Apply filter to loading text in ajax pagination
  • Fix bug where image gallery wasn’t working on items loaded via ajax
  • Add next/prev arrows to image gallery
  • Add .pot file for translations