Advanced Queries

EventCalendar supports a few extra HTML parameters that allow you to customise the event posts that are listed. The results only show (upcoming) event posts, and they are always sorted with the nearest event at the top, and future events further down the page.

You might like to put links to these queries into your WordPress ‘links’ section.

http://blog.address/?ec3_today=1

Shows only today’s events.

http://blog.address/?ec3_days=7

Shows the next seven days of events. You can change the parameter value to show as many future days as you wish.

http://blog.address/?ec3_after=2008-10-15

Shows all events on or after the day specified, or ‘today‘.

http://blog.address/?ec3_before=2008-11-15&order=desc

Shows all events on or before the day specified, or ‘today‘.

You can combine these last two to show only events in a particular range. For example…

http://blog.address/?ec3_after=2008-10-15&ec3_before=2008-11-15

…lists all events between 15th October and 15th November, inclusive.

[v3.2+] You can get even more control of how your posts are selected and sorted by using the ec3_listing parameter:

http://blog.address/?ec3_listing=events

Only show events, sorted by start date. E.g. Combine this with a category or tags query to show only events in the category or tag.

http://blog.address/?ec3_listing=posts

Only show posts (filter out events). E.g. Combine this with ec3_before and ec3_after to search for posts made betweek two dates.

http://blog.address/?ec3_listing=all

Show a mix of posts and events, sorted by post date & event start date.

http://blog.address/?ec3_listing=disable

Turn off Event-Calendar’s fiddling.

Feeds

You can combine these queries with WordPress’ RSS or Atom feeds to make customised feeds. For example, this this an RSS feed that lists the next 7 days of events:

http://blog.address/wp-rss.php?ec3_days=7

Subscribe to iCalendar

You can view the event calendar in iCal, Sunbird and other modern calendar applications. You can now subscribe to the calendar at the address:

http://blog.address/?feed=ical [v3.2+]
http://blog.address/feed/ical [v3.2+, with permalinks]
http://blog.address/?ec3_ical [v3.1-]