Provides theme developers with simple extensions to sites with events as a custom post type.
Author: | Steve Taylor (profile at wordpress.org) |
WordPress version required: | 3.0 |
WordPress version tested: | 3.7.1 |
Plugin version: | 0.2 |
Added to WordPress repository: | 08-05-2011 |
Last updated: | 08-11-2013
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, %: | 0 |
Rated by: | 0 |
Plugin URI: | http://wordpress.org/extend/plugins/simple-ev... |
Total downloads: | 1 950 |
Active installs: | 90+ |
Click to start download |
If the plugin detects that there is a custom post type registered with a particular name (either 'event' or '*_event'), it steps in and does a number of useful additional things:
- For front-end queries fetching events, returned posts are sorted chronologically, the oldest first.
- For front-end queries fetching events, by default only future events are returned. This can be overridden by setting the custom parameter
slt_all_events
in your posts query totrue
. Alternatively, useslt_past_events
(set totrue
) to get only past events. - By default the current time is used to compare dates for selecting past or future events. To change the time used for the cut-off, use the filter
slt_se_listing_time_offset
. It defaults to0
(no change from the current time). To set the cut-off to 24 hours ahead of the current time, hook a function to this filter that returns that value in seconds, i.e.60 * 60 * 24
. - By default events are ordered chronologically. To reverse the order, set
slt_reverse_events
totrue
. - In the admin listing page for events, an 'Event date' column is added.
- For particular queries, all actions performed by this plugin can be disabled by setting the custom parameter
disable_simple_events
in your posts query totrue
.
IMPORTANT: The automatic event filtering only kicks in with front-end queries done using WP_Query
. Use this rather than get_posts
.
In addition, this function is provided for convenience. If an event date exists for the post in question, it returns that; if not, it returns the standard post date.
<?php slt_se_get_date( $the_post = null ) ?>
- $the_post (object) (optional) (default: global $post object)
NOTE: An Event Date custom field will be added to the event edit screen automatically if my Custom Fields plugin is active. Otherwise, make sure your event post type supports custom-fields
(see [register_post_type](http://codex.wordpress.org/Function_Reference/register_post_type)
, and add dates to events with the format YYYY/MM/DD, e.g. 2011/12/21 - this format is required to allow sorting by this field.
NOTE: The filtering performed by this plugin currently doesn't work well with get_posts
- for now, create custom loops with WP_Query
.
Development code hosted at GitHub.