Get Upcoming or Past Posts

Display upcoming or past posts in an easily customizable manner.

“Upcoming” is defined as a post that is published or scheduled to be published today or in the future. “Past” is defined as a post that has been published anytime prior to today. “Today” is defined as midnight (00:00:00) of the current day according to the blog’s server and current time zone.

This plugin is a supplement to the Customizable Post Listings plugin, which means that you must have the Customizable Post Listings plugin activated in order for this plugin to operate. Customizable Post Listings can be found at coffee2code.com/wp-plugins/customizable-post-listings/. You will need at least version 3.0.1 of that plugin. If CPL is not activated, the template tags provided by this plugin will simply do nothing (nothing will be displayed and no error will be triggered).

The arguments of the two provided template tags, when they match up with those for c2c_get_recent_posts() from Customizable Post Listings, are identical in usage. Please see the documentation and examples related to the Customizable Post Listings plugins to see how to use the arguments, particularly for the formatting.

NOTE: It is not recommended for future posts to use a percent-substitution tag that includes a link to that post’s permalink page (such as by using ‘%post_URL%’, ‘%post_link%’, ‘%comments_count_URL%, etc) as the permalink page for a future post won’t exist until the post’s publish date has occurred.

Functions

• Lists upcoming posts (posts published or set to be published today or in the future) :

  function c2c_get_upcoming_posts(                                                                                                   $num_posts = 5,
    $format = "<li>%post_date%: %post_title%</li>",
    $categories = '',
    $orderby = 'date',
    $order = 'ASC',
    $offset = 0,
    $date_format = 'm/d/Y',
    $authors = '',                                                                                                                             
    $post_type = 'post',
    $include_passworded_posts = false )

• Lists past posts (posts occurring before today) :

  function c2c_get_past_posts( $num_posts = 5,
    $format = "<li>%post_date%: %post_URL%</li>",
    $categories = '',
    $orderby = 'date',
    $order = 'DESC',
    $offset = 0,
    $date_format = 'm/d/Y',
    $authors = '',
    $post_type = 'post',
    $include_passworded_posts = false )

Arguments

See the Customizable Post Listings plugin for documentation and examples related to the various arguments.

Thanks to all those who have contributed feedback and support!