Title: SOUP – Show off Upcoming Posts
Author: Dave Clements
Published: <strong>May 28, 2011</strong>
Last modified: October 1, 2019

---

Search plugins

![](https://ps.w.org/soup-show-off-upcoming-posts/assets/banner-772x250.png?rev=
570390)

This plugin **hasn’t been tested with the latest 3 major releases of WordPress**.
It may no longer be maintained or supported and may have compatibility issues when
used with more recent versions of WordPress.

![](https://ps.w.org/soup-show-off-upcoming-posts/assets/icon-256x256.png?rev=984374)

# SOUP – Show off Upcoming Posts

 By [Dave Clements](https://profiles.wordpress.org/thewanderingbrit/)

[Download](https://downloads.wordpress.org/plugin/soup-show-off-upcoming-posts.2.3.zip)

 * [Details](https://wordpress.org/plugins/soup-show-off-upcoming-posts/#description)
 * [Reviews](https://wordpress.org/plugins/soup-show-off-upcoming-posts/#reviews)
 *  [Installation](https://wordpress.org/plugins/soup-show-off-upcoming-posts/#installation)
 * [Development](https://wordpress.org/plugins/soup-show-off-upcoming-posts/#developers)

 [Support](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/)

## Description

**Like this plugin?** Consider [leaving a quick review](https://wordpress.org/support/view/plugin-reviews/soup-show-off-upcoming-posts)
or writing about how you’ve used it on your site – [send me a link](https://www.theukedge.com/contact/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=contact)
to that write up if you do.

This plugin is maintained on [GitHub](https://github.com/theukedge/soup-show-off-upcoming-posts),
so feel free to use the repository for reporting issues, submitting feature requests
and submitting pull requests.

SOUP creates a widget in your sidebar which allows you to display your upcoming 
posts (scheduled, drafts, or both) to your readers. The idea is to entice your readers
to come back and read the article once it gets published, or better yet, subscribe
to your RSS feed and/or newsletter.

Here are the configurable options for the widget:

 * Title of sidebar widget
 * Number of upcoming posts to display (always in ascending order – newest first)
 * Choose whether to show date of upcoming post
 * Display order of the posts (next post first or random order)
 * Message to display for when there are no scheduled posts or drafts
 * Show/hide newsletter link
 * Include link to sign up to newsletter

I’ve got plans to continue developing and updating this plugin. If you have any 
suggestions on revisions that you’d like to see made, please [get in touch](https://www.theukedge.com/contact/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=contact)
or [find me on Twitter](http://www.twitter.com/daclements).

I also run [Do It With WordPress](https://www.doitwithwp.com/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=my-other-sites),
which has an array of tutorials for managing, modifying and maintaining your WordPress
sites, as well as [The WP Butler](https://www.thewpbutler.com/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=wordpress-services),
a service for keeping your site maintained, backed up, updated and secure.

## Screenshots

[⌊An example of the widget in use.⌉⌊An example of the widget in use.⌉[

An example of the widget in use.

## Installation

 1. Upload `soup-show-off-upcoming-posts` folder to the `/wp-content/plugins/` directory
 2. Activate the plugin through the ‘Plugins’ menu in WordPress
 3. Go to Appearance > Widgets to put the widget in your selected sidebar.
 4. Set your settings, hit Save and go to your site to see it in action.

## FAQ

  How do I modify WP_Query to get more specific results

There is a filter (`soup_query`) for the [WP_Query](https://codex.wordpress.org/Class_Reference/WP_Query)
args, so you can add and modify args as needed to get the result you need.

For example, to limit your results to posts in category 3, you might add something
like the function below to your [functionality plugin](https://github.com/theukedge/functionality-plugin):

    ```
    function limit_soup( $args ) {
        $args['cat'] = 3;
        return $args;
    }

    add_filter( 'soup_query', 'limit_soup' );
    ```

  Are there more features planned in future?

Absolutely. I’ll be providing more options and upgrades in the near future. You 
can stay up to date by following me on [Twitter](http://www.twitter.com/daclements).
If you have an idea for a new feature, you can create a new feature request on [GitHub](https://github.com/theukedge/soup-show-off-upcoming-posts/issues).
If you don’t have a GitHub account, then [tell me](https://www.theukedge.com/contact/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=contact)
what this widget should do that it doesn’t currently.

  I don’t have a newsletter. Is this functionality lost on me?

Many WordPress users send their RSS feed through FeedBurner, which has the option
to deliver your latest posts by email to anyone who subscribes. Just log in to FeedBurner,
go to the Publicize tab and select Email Subscriptions where you’ll be able to grab
the link.

  I’m having issues. What do I do?

The best thing to do is to submit an issue on [GitHub](https://github.com/theukedge/soup-show-off-upcoming-posts/issues).
If you don’t have a GitHub account, then [get in touch with me](https://www.theukedge.com/contact/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=contact)
and I’ll see about getting it fixed.

## Reviews

![](https://secure.gravatar.com/avatar/99350693e2bed88ffa0dd7ab917df85023a151403405f3ac17cfbb9c3e211cf8?
s=60&d=retro&r=g)

### 󠀁[Would love to see a thumbnail of the featured image added to this plugin!](https://wordpress.org/support/topic/would-love-to-see-a-thumbnail-of-the-featured-image-added-to-this-plugin/)󠁿

 [plumpprodigy](https://profiles.wordpress.org/plumpprodigy/) September 3, 2020

As we all know the sidebar can look a bit stale with text alone. I would love to
see the addition of show featured image thumbnail to the left of the Post Name and
Date in the future. Or Featured image thumbnail, POST name Line one Date Line two
to balance out image. Other than that this works great!

![](https://secure.gravatar.com/avatar/7629e8e16d9e5b75c978a40b65062f56d023243660a58fb4908d30eb13b896f0?
s=60&d=retro&r=g)

### 󠀁[Amazing Plugin!!!](https://wordpress.org/support/topic/amazing-plugin-1391/)󠁿

 [bluebit](https://profiles.wordpress.org/bluebit/) February 23, 2020

Very simple and easy to use. Love it!!!

![](https://secure.gravatar.com/avatar/5c1e44f92625801cf58fe299710c34e015c18ee3df6215d388dc8d27081c34db?
s=60&d=retro&r=g)

### 󠀁[Great Widget.](https://wordpress.org/support/topic/great-widget-56/)󠁿

 [sky2827](https://profiles.wordpress.org/sky2827/) April 11, 2017 1 reply

I love this widget and the ease with which it works. Just wish I could add pages
to it too.

![](https://secure.gravatar.com/avatar/ec7a2b3cea5d54549da6b05ce55d54afc80ee47307b5767beb404fad277ffd06?
s=60&d=retro&r=g)

### 󠀁[Incredibly Useful](https://wordpress.org/support/topic/incredibly-useful-27/)󠁿

 [Thomas Rendleman](https://profiles.wordpress.org/thomasrendleman/) March 11, 2017

Allows your visitors to see future posts. It gives them something to look forward
to. Shows that you keep content coming in on your website.

![](https://secure.gravatar.com/avatar/c98eb7c2dc4d284aa66afa96305323a6afc5247588e9ed78014ffb5770ef5629?
s=60&d=retro&r=g)

### 󠀁[Soup Just Works](https://wordpress.org/support/topic/soup-just-works/)󠁿

 [Gary.Bartlett](https://profiles.wordpress.org/garybartlett/) September 3, 2016

SOUP is simple, straightforward and just works. It's easy to configure – and I like
being able to build my followers' anticipation of what's to come. I needed support
after a month or so and Dave was quick to respond. It turned out that the problem
was unrelated to SOUP and was fixed immediately. 'Can’t imagine how the service 
could have been any better! Thanks, Dave. ('Looks as if Do It With WordPress – Dave's
site – has some good stuff WP on it , too…)

 [ Read all 6 reviews ](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/)

## Contributors & Developers

“SOUP – Show off Upcoming Posts” is open source software. The following people have
contributed to this plugin.

Contributors

 *   [ Dave Clements ](https://profiles.wordpress.org/thewanderingbrit/)

“SOUP – Show off Upcoming Posts” has been translated into 2 locales. Thank you to
[the translators](https://translate.wordpress.org/projects/wp-plugins/soup-show-off-upcoming-posts/contributors)
for their contributions.

[Translate “SOUP – Show off Upcoming Posts” into your language.](https://translate.wordpress.org/projects/wp-plugins/soup-show-off-upcoming-posts)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/soup-show-off-upcoming-posts/),
check out the [SVN repository](https://plugins.svn.wordpress.org/soup-show-off-upcoming-posts/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/soup-show-off-upcoming-posts/)
by [RSS](https://plugins.trac.wordpress.org/log/soup-show-off-upcoming-posts/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 2.3

Release date: May 23, 2016

 * **Breaking changes for sites using < v2.2.1** See changelog for changes in previous
   versions.
 * Improve coding standards
 * Properly implemented i18n
 * Removed RSS icon image and replaced with dashicon

#### 2.2.1

Release date: May 20, 2016

 * **Breaking change**: args for category, post status and post type removed from
   WP_Query. If you wish to continue using these, you need to use the `soup_query`
   filter. See the [FAQ tab](https://wordpress.org/plugins/soup-show-off-upcoming-posts/faq/)
   for details on how to use this.
 * Added support for wordpress.org language packs

#### 2.1

Release date: January 26, 2016

 * Removed settings for category, post status and post types from the widget control
   panel. **To modify the category, post status or post types that SOUP displays,
   you now need to use the filter provided.** See the [FAQ tab](https://wordpress.org/plugins/soup-show-off-upcoming-posts/faq/)
   for details on how to use this, or [file a support ticket](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts).

#### 2.0

Release date: October 1, 2015

 * Refactored query in widget to use WP_Query class. **This will allow for the deprecation
   of certain settings in the widget in the next release (2.1)**. The intent is 
   to use the soup_query filter instead (see FAQs for example). Settings will be
   removed in 2.1 and the args will be removed from the query in 2.2.1.

## Meta

 *  Version **2.3**
 *  Last updated **7 years ago**
 *  Active installations **70+**
 *  WordPress version ** 3.8 or higher **
 *  Tested up to **5.2.28**
 *  Languages
 * [English (UK)](https://en-gb.wordpress.org/plugins/soup-show-off-upcoming-posts/),
   [English (US)](https://wordpress.org/plugins/soup-show-off-upcoming-posts/), 
   and [Vietnamese](https://vi.wordpress.org/plugins/soup-show-off-upcoming-posts/).
 *  [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/soup-show-off-upcoming-posts)
 * Tags
 * [Future](https://wordpress.org/plugins/tags/future/)[posts](https://wordpress.org/plugins/tags/posts/)
   [scheduled](https://wordpress.org/plugins/tags/scheduled/)[upcoming](https://wordpress.org/plugins/tags/upcoming/)
   [widget](https://wordpress.org/plugins/tags/widget/)
 *  [Advanced View](https://wordpress.org/plugins/soup-show-off-upcoming-posts/advanced/)

## Ratings

 4.5 out of 5 stars.

 *  [  4 5-star reviews     ](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/?filter=5)
 *  [  1 4-star review     ](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/?filter=4)
 *  [  1 3-star review     ](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/reviews/)

## Contributors

 *   [ Dave Clements ](https://profiles.wordpress.org/thewanderingbrit/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/soup-show-off-upcoming-posts/)

## Donate

Would you like to support the advancement of this plugin?

 [ Donate to this plugin ](https://www.theukedge.com/donate/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=donate)