Simple upcoming

Make an upcoming events calendar. Just add an "Event Date" to any
post, and then use the [upcoming] shortcode to list upcoming events.

Author:Samuel Coskey, Victoria Gitman (profile at wordpress.org)
WordPress version required:3.0
WordPress version tested:3.4.1
Plugin version:0.3
Added to WordPress repository:23-11-2011
Last updated:19-07-2012
Warning! This plugin has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.
Rating, %:100
Rated by:2
Plugin URI:
Total downloads:3 023
Active installs:10+
plugin download
Click to start download

This is another simple plugin to add a little functionality of a calendar to your blog. With this plugin you can specify, for any of your posts, an associated "Event Date" using a new widget in the post editor. Then, elsewhere on your site, you can retrieve a list of future events using the [upcoming] shortcode on any post or page.

The shortcode supports several options:

  • category_name: If defined, show posts only from these categories. You can provide multiple comma-separated category identifiers (slugs).

  • days_old: Show events whose Event Date is no more than this many days past. The default is 0, which shows only events taking place today or later. If you enter a non-numeric value such as infinity, then all matching events will be shown regardless of the Event Date.

  • style: One of list (default) or post. If it is list, then the list style is indented and bulleted. If it is post then the title is promoted to <h2 class="upcoming-entry-title"> and the list style is plain.

  • text: One of none (default), excerpt, or normal. If it is excerpt, then the post excerpt is shown, similar to search results. If it is normal then the full post (up to the [more] tag) is shown.

  • null_text: If no results are returned, shows this text. Defaults to (none).

  • class_name: If defined, adds this class name to the generated <ul> tag. Useful for custom styling.

  • show_date: If defined, the date will precede the post title

  • date_format: If showing the date, this php date format will be used. The default is the Date Format value from the General Settings page. I recommend "F j, Y", which displays as "May 12, 2012".

  • q: Arbitrary additional arguments to pass to the query. See the WP_Query page for available syntax. For example, to show only events with tag "workshop", and only 3 such events, you would write [upcoming q="posts_per_page=3&tag=workshop"].

The output can then be further formatted using CSS. We recommend the plugin Improved Simpler CSS for quickly styling your upcoming events list (and your site)!

Report bugs, give feedback, or fork this plugin on GitHub.


ChangeLog