Title: iCal Events Author: Daniel Westermann-Clark Published: March 10, 2005 Last modified: October 2, 2011 --- Search plugins This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://s.w.org/plugins/geopattern-icon/ical-events.svg) # iCal Events By [Daniel Westermann-Clark](https://profiles.wordpress.org/dwc/) [Download](https://downloads.wordpress.org/plugin/ical-events.1.14.zip) * [Details](https://pcd.wordpress.org/plugins/ical-events/#description) * [Reviews](https://pcd.wordpress.org/plugins/ical-events/#reviews) * [Installation](https://pcd.wordpress.org/plugins/ical-events/#installation) * [Development](https://pcd.wordpress.org/plugins/ical-events/#developers) [Support](https://wordpress.org/support/plugin/ical-events/) ## Description Note: The plugin should work with any version of WordPress but it is no longer being updated. You may wish to try [amr-ical-events-list](https://wordpress.org/extend/plugins/amr-ical-events-list/) instead. Fetch and display events from an iCalendar (`.ics`) URL in your blog. This plugin uses [import_ical.php](http://cvs.sourceforge.net/viewcvs.py/webcalendar/webcalendar/import_ical.php?rev=HEAD) from the [WebCalendar](http://sourceforge.net/projects/webcalendar/) project. A slightly modified version of their parser is provided with this plugin. ## Installation 1. Upload `ical-events.php` and `import_ical.php` to your plugins folder, usually ` wp-content/plugins`. 2. Activate the plugin on the Plugins screen. 3. Place the following in your template: This example displays three events from the University of Florida calendar, from the current time forward. For more information, see below. ## FAQ How can I control the output of this plugin? The `display_events` function takes the following arguments: * `url`: The URL of the iCalendar file. * `gmt_start` (optional): Only events from this time forward are displayed. If not specified, the earliest events are displayed. * `gmt_end` (optional): Only events before this time are displayed. * `limit` (optional): The maximum number of events to display. * `date_format` (optional): The format string used to format dates (see [strftime documentation](http://php.net/strftime)). Default: `%a %b %e`. * `time_format` (optional): The format string used to format times. Default: `% l:%M %p`. * `before` (optional): HTML or text to display before each event. Default: HTML` li` start tag. * `after` (optional): HTML or text to display after each event. Default: HTML ` li` end tag. * `before_date` (optional): HTML or text to display before each event’s date. Default: HTML `strong` start tag. * `after_date` (optional): HTML or text to display after each event’s date. Default: HTML `strong` end tag followed by `:` (colon and space). * `use_summary` (optional): Whether or not to use the event summary in the output. Default: `true`. * `before_summary` (optional): HTML or text to display before each event’s summary. Default: Empty string. * `after_summary` (optional): HTML or text to display after each event’s summary. Default: Empty string. * `use_description` (optional): Whether or not to use the event description in the output. Default: `true`. * `before_description` (optional): HTML or text to display before each event’s description. Default: `-`. * `after_description` (optional): HTML or text to display after each event’s description. Default: Empty string. * `replace_newlines_with` (optional): String with which to replace newlines in the description. Default: HTML `br` tag. * `use_location` (optional): Whether or not to use the event location in the output. If false, only the summary is used. Default: `true`. * `before_location` (optional): HTML or text to display before each event’s location. Default: `(`. * `after_location` (optional): HTML or text to display after each event’s location. Default: `)`. * `use_url` (optional): Whether or not to use the event URL in the output. If true, the event URL is made into a link around the event summary. Default: `true`. * `echo` (optional): Whether or not to directly display the events. Default: `true`. For example, if you want to hide the description and location, you could use something like the following: ``` ``` If you need more control over the output, use the `get_events` function, which takes the following arguments: * `url`: The URL of the iCalendar file. * `gmt_start` (optional): Only events from this time forward are displayed. If not specified, the earliest events are displayed. * `gmt_end` (optional): Only events before this time are displayed. * `limit` (optional): The maximum number of events to display. The function returns an array of events, as parsed by `import_ical.php`. For example usage, refer to the `display_events` function in the plugin. How often is the calendar checked for new events? Once a day. You can change this using the `ICAL_EVENTS_CACHE_TTL` (time to live) near the top of the plugin to the desired number of seconds in between checks. For example, to load events every hour, use the following: ``` define('ICAL_EVENTS_CACHE_TTL', 3600); ``` Loading calendars too frequently can get your server banned, so use your best judgment when setting this value. Why aren’t my events showing up correctly? This plugin makes an attempt to support as many event definitions that follow the iCalendar specification (RFC 2445) as possible. However, not all recurrence rules are implemented in the parser. There may also be bugs in how the plugin interprets the parsed data. If an event is showing up correctly in your calendar application (iCal, Google Calendar) but not on your blog, try turning on debugging: ``` define('ICAL_EVENTS_DEBUG', true); ``` Put that line above the line in the plugin that reads: ``` if (! defined('ICAL_EVENTS_DEBUG')) define('ICAL_EVENTS_DEBUG', false); ``` Now reload your blog. You may see various lines about unsupported iCal values; if this is the case, and you’re interested in getting it fixed, take a look at the ` import_ical.php` file. Where can I find iCalendar files? There are many iCalendar sources, such as: * [Apple’s iCal library](http://www.apple.com/ical/library/) * [iCalShare](http://www.icalshare.com/) * [Google Calendar](http://calendar.google.com/) My server does not support `fopen` on URLs. Can I still use this plugin? As of version 1.9, this plugin supports usage of cURL via WordPress’ `wp_remote_fopen` function. Previous versions required the `url-cache` plugin for cURL support, but this is no longer the case. The calendar I loaded is broken or didn’t load completely; what can I do? If you are an administrator of your WordPress site, you can force the plugin to reload it. Just add `?ical_events_reload=1` to the end of the URL (or `&ical_events_reload =1` if the URL already contains a question mark). Note: Your user account must have the `activate_plugins` role for this to work. The text comes out garbled or looks encoded incorrectly. How do I fix this? As of version 1.13, you can explicitly set the calendar’s character set for conversion to HTML: ``` ICalEvents::display_events('url=...&charset=EUC-JP'); ``` The conversion defaults to your blog’s character set, which is usually UTF-8. The supported character sets are listed in the [htmlentities](http://php.net/htmlentities) documentation. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “iCal Events” is open source software. The following people have contributed to this plugin. Contributors * [ Daniel Westermann-Clark ](https://profiles.wordpress.org/dwc/) [Translate “iCal Events” into your language.](https://translate.wordpress.org/projects/wp-plugins/ical-events) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/ical-events/), check out the [SVN repository](https://plugins.svn.wordpress.org/ical-events/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ical-events/) by [RSS](https://plugins.trac.wordpress.org/log/ical-events/?limit=100&mode=stop_on_copy&format=rss). ## Meta * Version **1.14** * Last updated **15 years ago** * Active installations **30+** * WordPress version ** 2.0 or higher ** * Tested up to **3.0.5** * Language * [English (US)](https://wordpress.org/plugins/ical-events/) * Tags * [calendar](https://pcd.wordpress.org/plugins/tags/calendar/)[events](https://pcd.wordpress.org/plugins/tags/events/) * [Advanced View](https://pcd.wordpress.org/plugins/ical-events/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/ical-events/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/ical-events/reviews/) ## Contributors * [ Daniel Westermann-Clark ](https://profiles.wordpress.org/dwc/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/ical-events/)