UPDATE: Version 3.1 is now available.
EventCalendar 3.0 is now available. Use WordPress to manage future events as an online calendar. Display upcoming events in a dynamic calendar, on a listings page, or as a list in the sidebar. You can subscribe to the calendar from iCal (OSX) or Sunbird.
Choose one WordPress category as the ‘event’ category, and then add posts for dates in the future. Add the calendar or event list functions to your template, or just use the ‘Event Category’ page to list your forthcoming events.
Latest version: 3.0.4
Released on: 4th February, 2006.
Download it here: http://blog.firetree.net/wp-content/plugins/eventcalendar30.zip
EventCalendar 3.0 is compatible with WordPress 1.5.2. No hacks or source code editing are required. It sort of works with WordPress 2.0, but a patch is required. Details here, or in the readme.txt. If you have any questions or comments, then please subscribe to the mailing list.
- Upload to your plugins folder:
- Activate the plugin on the plugin screen.
- Change settings on the Event Calendar Options screen. You must choose which Wordpress category to use for events. Do this before you change the template.
ec3_get_events()to your template.
Display Events in a SIDEBAR CALENDAR
Add the following code to your
<li> <?php ec3_get_calendar(); ?> </li>
If you are using an older template, then you should check that your HTML header contains the following tag:
<?php wp_head(); ?>
Caution: The Event Calendar must be unique. If you try to show more than one calendar on a page, then only the first will be displayed.
Display Events on a FULL PAGE
Your events are all in the same WordPress category, so you can see them all on the normal ‘Event Category’ page. By default you will also see events on your front page just like normal posts, once their date arrives.
If you want to use the category page for listings then go to the ‘Event Calendar Options’ page and set Show events as blog entries: to Keep Events Separate. This keeps event posts off the front page, and converts the category page into a more useful form.
Display Events in a SIDEBAR LIST
You can show an abbreviated version of the full page event listing on every page
of your site. The template function:
ec3_get_events() shows a
list of upcoming events. Add the following code to your
<li><?php _e('Events'); ?> <?php ec3_get_events(5); ?> </li>
The function takes several parameters:
limit. The maximum number of future events to list.
template_event (OPTIONAL) DEFAULT=
<a href="%LINK%">%TITLE% (%TIME%)</a>. A template for the formating of each event. The following placeholders are available:
%TITLE%– the title of the event.
%LINK%– the URL of the event post.
%TIME%– the time of the event.
%AUTHOR%– the post’s author.
template_day (OPTIONAL) DEFAULT=
%DATE%:. A template for the formatting of a header for each day. If you don’t want this header, then set this to an empty string. The following placeholders are available:
%DATE%– The date of the post.
%SINCE%– Time until the event (Only available when Dunstan’s ‘Time Since’ plugin is active).
date_format (OPTIONAL). A PHP date format string used to calculate the value of
%DATE%. If this option is not provided, then WordPress’ normal date format is used.
Here’s an example that uses all of the parameters:
<li><?php _e('Events'); ec3_get_events(3,'%DATE%: <a href="%LINK%">%TITLE%</a>','','j F'); ?> </li>
Subscribe to the vCalendar
The vCalendar feature is now fully integrated into the plugin. This allows you to view the event calendar in iCal, Sunbird and other modern calendar applcations. You can now subscribe to the
calendar at the address
The ‘Event Calendar Options’ page is in the administration area. Click on ‘Options’, and then click on the ‘Event Calendar’ tab. The following settings are available:
Event category: Set the category you use for upcoming events.
Show events as blog entries: Set this to ‘Keep Events Separate’ in order to use the Event Category page to show future events, in date order. Events do not appear on front page.
Number of months: How many monthly calendars should be drawn by the
ec2_get_calendar()function. This is useful for looking forward to upcoming events.
Show all categories in calendar: Choose whether the calendars should show all posts, or just events.
Show day names as: Day names in calendar can be abbreviated down to 3 letters (‘Mon’, ‘Tue’, etc.) or just one letter (‘M’, ‘T’, etc.).
Show Event Calendar logo: Normally, a little ‘EC’ logo is shown on the calendar.
Position of navigation links: The navigation links are more usable when they are above the calendar, but you might prefer them below it for aesthetic reasons.
Popup event lists: When you hover the mouse over a calendar day, a popup usually appears listing the events (and other posts) on that day. Some ‘Nicetitles’ scripts are not written to work well with others, so you might want to use this option to disable the Event Calendar popups if you have trouble.
The first day of the week is set on WordPress’ ‘General Options’ screen.
How to make an Event Post
An event post is a normal blog post that is assigned to the ‘Event’ category.
In order to set the date, you need to go to the ‘Advanced’ editing screen and scroll down until you find the ‘Edit time:’ field. Select the ‘Edit timestamp’ checkbox, set the date and time of your event and click ‘Save’. These controls are only available if your user level is 5 or higher.
If you subscribe to the vCalendar using iCal or Sunbird, then you can set the duration of the event in hours by creating a new custom field: ‘duration’.
Live Calendar updating without the need to refresh the whole page. (Thanks to Jon Abad for the inspiration of his LiveCalendar.)
Keep Events Separate mode. Keeps event posts off the front page. Turns the Event category page into a properly ordered listing of forthcoming events. This feature is off by default. Activate it on the Event Calendar Options page.
Custom Popup replaces the usual tooltip with a popup that lists each event on its own line. The popup is always positioned below the calendar, to ensure that you can still see the whole month.
There is no need to edit your CSS files. All essential stylesheet definitions are now part of the plugin.
Plus many more minor usability issues.
Some enhancement haven’t made it into this first release, but they are planned for the future:
Repeating events (good for birthdays).
Frequently Asked Questions
Q: Can I disable your headers on pages with no calendar?
A: Yes. Remove the filter before your template’s call to
< ?php remove_filter('wp_head','ec3_action_wp_head'); ?>
Q: Can I supply my own CSS?
A: Yes. To disable the plugin’s CSS, just insert the following code before your template’s call to
< ?php global $ec3; $ec3->nocss=true; ?>