{"id":15813,"date":"2011-11-23T23:42:12","date_gmt":"2011-11-23T23:42:12","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/simple-upcoming\/"},"modified":"2012-07-19T18:54:26","modified_gmt":"2012-07-19T18:54:26","slug":"simple-upcoming","status":"publish","type":"plugin","link":"https:\/\/twd.wordpress.org\/plugins\/simple-upcoming\/","author":8078108,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"0.3","stable_tag":"0.3","tested":"3.4.2","requires":"3.0","requires_php":"","requires_plugins":"","header_name":"Simple upcoming","header_author":"Samuel Coskey, Victoria Gitman","header_description":"","assets_banners_color":"","last_updated":"2012-07-19 18:54:26","external_support_url":"","external_repository_url":"","donate_link":"http:\/\/boolesrings.org","header_plugin_uri":"","header_author_uri":"http:\/\/boolesrings.org","rating":5,"author_block_rating":0,"active_installs":10,"downloads":3504,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"2"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.0","0.1","0.1.1","0.1.2","0.1.3","0.2","0.2.1","0.3"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[416,2431,1486,11426],"plugin_category":[40],"plugin_contributors":[84452,90184],"plugin_business_model":[],"class_list":["post-15813","plugin","type-plugin","status-publish","hentry","plugin_tags-calendar","plugin_tags-event","plugin_tags-events","plugin_tags-upcoming","plugin_category-calendar-and-events","plugin_contributors-sgcoskey","plugin_contributors-vgitman","plugin_committers-sgcoskey"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/simple-upcoming.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>This is another simple plugin to add a little functionality of a\ncalendar to your blog.  With this plugin you can specify, for any of\nyour posts, an associated \"Event Date\" using a new widget in the post\neditor.  Then, elsewhere on your site, you can retrieve a list of\nfuture events using the <code>[upcoming]<\/code> shortcode on any post or page.<\/p>\n\n<p>The shortcode supports several options:<\/p>\n\n<ul>\n<li><p><strong>category_name<\/strong>: If defined, show posts only from these\ncategories.  You can provide multiple comma-separated category\nidentifiers (slugs).<\/p><\/li>\n<li><p><strong>days_old<\/strong>: Show events whose Event Date is no more than this many\ndays past.  The default is <code>0<\/code>, which shows only events taking place\ntoday or later.  If you enter a non-numeric value such as <strong>infinity<\/strong>,\nthen all matching events will be shown regardless of the Event Date.<\/p><\/li>\n<li><p><strong>style<\/strong>: One of <em>list<\/em> (default) or <em>post<\/em>.  If it is <em>list<\/em>, then\nthe list style is indented and bulleted.  If it is <em>post<\/em> then the\ntitle is promoted to <code>&lt;h2 class=\"upcoming-entry-title\"&gt;<\/code> and the list\nstyle is plain.<\/p><\/li>\n<li><p><strong>text<\/strong>: One of <em>none<\/em> (default), <em>excerpt<\/em>, or <em>normal<\/em>.  If it is\n<em>excerpt<\/em>, then the post excerpt is shown, similar to search results.\nIf it is <em>normal<\/em> then the full post (up to the <code>[more]<\/code> tag) is\nshown.<\/p><\/li>\n<li><p><strong>null_text<\/strong>: If no results are returned, shows this text.\nDefaults to <code>(none)<\/code>.<\/p><\/li>\n<li><p><strong>class_name<\/strong>: If defined, adds this class name to the generated <code>&lt;ul&gt;<\/code>\ntag.  Useful for custom styling.<\/p><\/li>\n<li><p><strong>show_date<\/strong>: If defined, the date will precede the post title<\/p><\/li>\n<li><p><strong>date_format<\/strong>: If showing the date, this php date format will be\nused.  The default is the Date Format value from the General Settings\npage.  I recommend <code>\"F j, Y\"<\/code>, which displays as \"May 12, 2012\".<\/p><\/li>\n<li><p><strong>q<\/strong>: Arbitrary additional arguments to pass to the query.  See the\n<a href=\"http:\/\/codex.wordpress.org\/Class_Reference\/WP_Query\/#Parameters\">WP_Query<\/a>\npage for available syntax.  For example, to show only events with tag\n\"workshop\", and only 3 such events, you would write <code>[upcoming\nq=\"posts_per_page=3&amp;tag=workshop\"]<\/code>.<\/p><\/li>\n<\/ul>\n\n<p>The output can then be further formatted using CSS.  We recommend the\nplugin <a href=\"http:\/\/wordpress.org\/extend\/plugins\/imporved-simpler-css\/\">Improved Simpler\nCSS<\/a> for\nquickly styling your upcoming events list (and your site)!<\/p>\n\n<p>Report bugs, give feedback, or fork this plugin on\n<a href=\"http:\/\/github.com\/scoskey\/Simple-upcoming-wordpress-plugin\">GitHub<\/a>.<\/p>\n\n<!--section=installation-->\n<p>Nothing unusual here!<\/p>\n\n<!--section=changelog-->\n<p>0.3 added shortcode parameter <strong>days_old<\/strong>.<\/p>\n\n<pre><code>0.2.1 bug fix: the default event date was the start of 1970 rather\n<\/code><\/pre>\n\n<p>than no date at all.<\/p>\n\n<pre><code>0.2 Unfortunately I have changed the way dates are stored in the\n<\/code><\/pre>\n\n<p>database.  This means you will have to open and re-save any posts you\nhave with the \"Event Date\" set.  I have also changed the shortcode\nparameters slightly with <strong>style<\/strong> becoming both <strong>style<\/strong> and <strong>text<\/strong>.\nPlease have a look at the syntax.  I apologize for the inconvenience!<\/p>\n\n<p>big fixes: dates in different years were sorted incorrectly.  the\ntimezone was not respected.<\/p>\n\n<p>new features: added the q and text parameters<\/p>\n\n<pre><code>0.1.3 bug fix: added nopaging so all relevant posts appear\n\n0.1.2 bug fix: sticky posts were always appearing\n\n0.1.1 bug fix: non-empty input to the \"event date\" box wasn't working\n<\/code><\/pre>\n\n<p>(accidentally introduced in the last bug fix)<\/p>\n\n<pre><code>0.1 bug fix: empty input to the \"event date\" box wasn't working\n\n0.0 initial release\n<\/code><\/pre>","raw_excerpt":"Make an upcoming events calendar.  Just add an &quot;Event Date&quot; to any post, and then use the [upcoming] shortcode to list upcoming events.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/15813","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=15813"}],"author":[{"embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sgcoskey"}],"wp:attachment":[{"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=15813"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=15813"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=15813"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=15813"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=15813"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/twd.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=15813"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}