{"id":48528,"date":"2011-05-28T19:32:22","date_gmt":"2011-05-28T19:32:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/soup-show-off-upcoming-posts\/"},"modified":"2019-10-01T16:40:38","modified_gmt":"2019-10-01T16:40:38","slug":"soup-show-off-upcoming-posts","status":"publish","type":"plugin","link":"https:\/\/fao.wordpress.org\/plugins\/soup-show-off-upcoming-posts\/","author":3757877,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"2.3","stable_tag":"2.3","tested":"5.2.24","requires":"3.8","requires_php":"","requires_plugins":"","header_name":"SOUP - Show Off Upcoming Posts","header_author":"Dave Clements","header_description":"","assets_banners_color":"ffffff","last_updated":"2019-10-01 16:40:38","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.theukedge.com\/donate\/?utm_source=wordpress.org&utm_medium=plugin&utm_campaign=donate","header_plugin_uri":"https:\/\/github.com\/theukedge\/soup-show-off-upcoming-posts","header_author_uri":"https:\/\/www.theukedge.com","rating":4.5,"author_block_rating":0,"active_installs":80,"downloads":18138,"num_ratings":6,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":{"2.3":"<ul>\n<li><strong>Breaking changes for sites using &lt; v2.2.1<\/strong> See changelog for changes in previous versions.<\/li>\n<li>Coding standards and translation improvements.<\/li>\n<\/ul>","2.2.1":"<ul>\n<li><strong>Breaking changes included<\/strong>. See changelog for more details.<\/li>\n<li>Removed args for category, post types and post status from WP_Query.<\/li>\n<li>Prepared for use of wordpress.org language packs.<\/li>\n<\/ul>","2.1":"<ul>\n<li>Removed settings for category, post types and post status from widget settings in favour of filter.<\/li>\n<li><strong>Breaking changes included and more forthcoming. See changelog<\/strong><\/li>\n<\/ul>","2.0":"<ul>\n<li>Refactored code to use WP_Query<\/li>\n<li><strong>Breaking change forthcoming. See changelog<\/strong><\/li>\n<\/ul>"},"ratings":{"1":0,"2":0,"3":"1","4":"1","5":"4"},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":"984374","resolution":"128x128","location":"assets","locale":""},"icon-256x256.png":{"filename":"icon-256x256.png","revision":"984374","resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-772x250.png":{"filename":"banner-772x250.png","revision":"570390","resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.01","1.1","1.10","1.10.0","1.2","1.2a","1.3","1.3.1","1.3.2","1.3.3","1.4","1.5","1.5.1","1.6","1.6.1","1.6.2","1.6.3","1.7","1.7.1","1.7.2","1.8","1.9","2.0","2.1","2.2.1","2.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"2166490","resolution":"1","location":"plugin"}},"screenshots":{"1":"An example of the widget in use.","2":"The widget control panel."},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[4927,166,6502,11426,162],"plugin_category":[42,43,59],"plugin_contributors":[79916],"plugin_business_model":[],"class_list":["post-48528","plugin","type-plugin","status-publish","hentry","plugin_tags-future","plugin_tags-posts","plugin_tags-scheduled","plugin_tags-upcoming","plugin_tags-widget","plugin_category-contact-forms","plugin_category-customization","plugin_category-utilities-and-tools","plugin_contributors-thewanderingbrit","plugin_committers-thewanderingbrit"],"banners":{"banner":"https:\/\/ps.w.org\/soup-show-off-upcoming-posts\/assets\/banner-772x250.png?rev=570390","banner_2x":false,"banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/soup-show-off-upcoming-posts\/assets\/icon-128x128.png?rev=984374","icon_2x":"https:\/\/ps.w.org\/soup-show-off-upcoming-posts\/assets\/icon-256x256.png?rev=984374","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/soup-show-off-upcoming-posts\/trunk\/screenshot-1.png?rev=2166490","caption":"An example of the widget in use."}],"raw_content":"<!--section=description-->\n<p><strong>Like this plugin?<\/strong> Consider <a href=\"https:\/\/wordpress.org\/support\/view\/plugin-reviews\/soup-show-off-upcoming-posts\" title=\"Review SOUP\">leaving a quick review<\/a> or writing about how you've used it on your site - <a href=\"https:\/\/www.theukedge.com\/contact\/?utm_source=wordpress.org&amp;utm_medium=plugin&amp;utm_campaign=contact\" title=\"Contact Dave\">send me a link<\/a> to that write up if you do.<\/p>\n\n<p>This plugin is maintained on <a href=\"https:\/\/github.com\/theukedge\/soup-show-off-upcoming-posts\">GitHub<\/a>, so feel free to use the repository for reporting issues, submitting feature requests and submitting pull requests.<\/p>\n\n<p>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.<\/p>\n\n<p>Here are the configurable options for the widget:<\/p>\n\n<ul>\n<li>Title of sidebar widget<\/li>\n<li>Number of upcoming posts to display (always in ascending order - newest first)<\/li>\n<li>Choose whether to show date of upcoming post<\/li>\n<li>Display order of the posts (next post first or random order)<\/li>\n<li>Message to display for when there are no scheduled posts or drafts<\/li>\n<li>Show\/hide newsletter link<\/li>\n<li>Include link to sign up to newsletter<\/li>\n<\/ul>\n\n<p>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 <a href=\"https:\/\/www.theukedge.com\/contact\/?utm_source=wordpress.org&amp;utm_medium=plugin&amp;utm_campaign=contact\" title=\"Contact Dave\">get in touch<\/a> or <a href=\"http:\/\/www.twitter.com\/daclements\" title=\"Dave on Twitter\">find me on Twitter<\/a>.<\/p>\n\n<p>I also run <a href=\"https:\/\/www.doitwithwp.com\/?utm_source=wordpress.org&amp;utm_medium=plugin&amp;utm_campaign=my-other-sites\" title=\"WordPress Tutorials\">Do It With WordPress<\/a>, which has an array of tutorials for managing, modifying and maintaining your WordPress sites, as well as <a href=\"https:\/\/www.thewpbutler.com\/?utm_source=wordpress.org&amp;utm_medium=plugin&amp;utm_campaign=wordpress-services\" title=\"WordPress Maintenance Services\">The WP Butler<\/a>, a service for keeping your site maintained, backed up, updated and secure.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload <code>soup-show-off-upcoming-posts<\/code> folder to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Go to Appearance &gt; Widgets to put the widget in your selected sidebar.<\/li>\n<li>Set your settings, hit Save and go to your site to see it in action.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>How do I modify WP_Query to get more specific results<\/dt>\n<dd><p>There is a filter (<code>soup_query<\/code>) for the <a href=\"https:\/\/codex.wordpress.org\/Class_Reference\/WP_Query\">WP_Query<\/a> args, so you can add and modify args as needed to get the result you need.<\/p>\n\n<p>For example, to limit your results to posts in category 3, you might add something like the function below to your <a href=\"https:\/\/github.com\/theukedge\/functionality-plugin\">functionality plugin<\/a>:<\/p>\n\n<pre><code>function limit_soup( $args ) {\n    $args['cat'] = 3;\n    return $args;\n}\n\nadd_filter( 'soup_query', 'limit_soup' );\n<\/code><\/pre><\/dd>\n<dt>Are there more features planned in future?<\/dt>\n<dd><p>Absolutely. I'll be providing more options and upgrades in the near future. You can stay up to date by following me on <a href=\"http:\/\/www.twitter.com\/daclements\" title=\"Dave on Twitter\">Twitter<\/a>. If you have an idea for a new feature, you can create a new feature request on <a href=\"https:\/\/github.com\/theukedge\/soup-show-off-upcoming-posts\/issues\">GitHub<\/a>. If you don't have a GitHub account, then <a href=\"https:\/\/www.theukedge.com\/contact\/?utm_source=wordpress.org&amp;utm_medium=plugin&amp;utm_campaign=contact\" title=\"Contact The UK Edge\">tell me<\/a> what this widget should do that it doesn't currently.<\/p><\/dd>\n<dt>I don't have a newsletter. Is this functionality lost on me?<\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt>I'm having issues. What do I do?<\/dt>\n<dd><p>The best thing to do is to submit an issue on <a href=\"https:\/\/github.com\/theukedge\/soup-show-off-upcoming-posts\/issues\">GitHub<\/a>. If you don't have a GitHub account, then <a href=\"https:\/\/www.theukedge.com\/contact\/?utm_source=wordpress.org&amp;utm_medium=plugin&amp;utm_campaign=contact\" title=\"Contact The UK Edge\">get in touch with me<\/a> and I'll see about getting it fixed.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.3<\/h4>\n\n<p>Release date: May 23, 2016<\/p>\n\n<ul>\n<li><strong>Breaking changes for sites using &lt; v2.2.1<\/strong> See changelog for changes in previous versions.<\/li>\n<li>Improve coding standards<\/li>\n<li>Properly implemented i18n<\/li>\n<li>Removed RSS icon image and replaced with dashicon<\/li>\n<\/ul>\n\n<h4>2.2.1<\/h4>\n\n<p>Release date: May 20, 2016<\/p>\n\n<ul>\n<li><strong>Breaking change<\/strong>: args for category, post status and post type removed from WP_Query. If you wish to continue using these, you need to use the <code>soup_query<\/code> filter. See the <a href=\"https:\/\/wordpress.org\/plugins\/soup-show-off-upcoming-posts\/faq\/\">FAQ tab<\/a> for details on how to use this.<\/li>\n<li>Added support for wordpress.org language packs<\/li>\n<\/ul>\n\n<h4>2.1<\/h4>\n\n<p>Release date: January 26, 2016<\/p>\n\n<ul>\n<li>Removed settings for category, post status and post types from the widget control panel. <strong>To modify the category, post status or post types that SOUP displays, you now need to use the filter provided.<\/strong> See the <a href=\"https:\/\/wordpress.org\/plugins\/soup-show-off-upcoming-posts\/faq\/\">FAQ tab<\/a> for details on how to use this, or <a href=\"https:\/\/wordpress.org\/support\/plugin\/soup-show-off-upcoming-posts\">file a support ticket<\/a>.<\/li>\n<\/ul>\n\n<h4>2.0<\/h4>\n\n<p>Release date: October 1, 2015<\/p>\n\n<ul>\n<li>Refactored query in widget to use WP_Query class. <strong>This will allow for the deprecation of certain settings in the widget in the next release (2.1)<\/strong>. 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.<\/li>\n<\/ul>","raw_excerpt":"Displays your upcoming posts in a sidebar widget to tease your readers","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/48528","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=48528"}],"author":[{"embeddable":true,"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/thewanderingbrit"}],"wp:attachment":[{"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=48528"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=48528"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=48528"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=48528"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=48528"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/fao.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=48528"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}