Previous Topic

Next Topic

Book Contents

Book Index

Internet Calendar (iCal RFC-5545) Export

Description of iCal

If you have installed software that acts as a handler for the webcal protocol, you should be able to click on the webcal link. This should open your calendar software and create a remote calendar link.

If you do not have a webcal protocol handler installed (it does nothing when you click on the link), copy the http:// link onto the clipboard and paste it into your calendar software.

If your calendar requires a login or the calendar you want to subscribe to is not publicly visible, you can still subscribe to the iCal data from other programs. To do this, add ?username=youruser&password=yourpassword to the URL. For example:

https://www.mhsoftware.com/caldemo/iCal/calendar_id/22.ics?username=demo&password=demo

If you're doing this, you should use SSL for your request. In other words the URL should start with https://.

Additional URL Options

Parameter Name

Description

include_past

The default behavior is to export future events, and those that happened within the last 30 days. If you want all events regardless of date, add "include_past=1" as a URL argument.

htmldescription

Default 0. The default behavior for iCal export is to strip HTML from the long description of an event. If this parameter is present and set to 1, the iCal event will have the HTML formatted description returned.

nodefaultcontact

If this argument is present, and the value is 1, then the event owner will not be added to the iCal entry as the ORGANIZER/CONTACT.

noresourcesindesc

If this argument is present and the value is 1, then the resources used by the event will not be added as text to the event description.

rollup

By default, the iCal export routine will follow the calendar's setting of whether to include rollup calendars as part of the exported calendar. If you do not want events from included calendars to be displayed, append add rollup=0 to the URL. To force rollup events, add rollup=1.

password

Password to use to transparently login to the calendar for access to the data.

username

User Name to use to transparently login to the calendar for access to the data.

See Also: Filtering on Multiple Options

Caveats

iCal is a very complex specification and it can be difficult for programs to inter-operate. We are aware of the following issues:

Windows Calendar (Vista)

No known issues.

Evolution (2.8.2)

Specific Date (RDATE) events do not work.

Apple iCal

All Versions (2.0-6.0)

  • RDATE (Specific Date Events) does not work.
  • If time zone support is enabled, the detailed event display shows one time events relative to GMT.

Version 3.06

  • Last Weekday does not work.

Version 2.05

  • Last Weekday does not work.
  • The mere presence of an RDATE entry can cause iCal to terminate with an error.
  • First Weekday does not work.

Google Calendar

It may take up to 24 hours for changes in Connect Daily to be reflected in Google Calendar. This is because Google Calendar infrequently checks for updates.

See Also: Appendix D - Importing Data From Connect Daily Into Google Calendar

KOrganizer (4.1.0)

KOrganizer 3.x doesn't handle time zones correctly. Unless all events are in the same time zone, times will be wrong. This is certain to happen because Connect Daily exports one time events in GMT. Versions 3.5.7 and later will handle one time zone and GMT correctly, but not two time zones and GMT.

As a general note, KOrganizer converts times for recurring events into GMT and stores them. This can cause problems with recurring event calculations.

Microsoft Outlook
(2000-2003)

There are two methods of importing events into Outlook. Double-clicking on an individual ICS file or using the import screen. If you double click on an ICS file, or URL for an ICS file, then only one event from that file will be imported and most forms of recurrence won't work.

If you use the Import screen to import an ICS file, then things will work pretty smoothly.

Microsoft Outlook 2007

Outlook 2007 supports subscription to remote calendars. You can subscribe to a Connect Daily iCal calendar feed. Please note the following:

  • RDATE is not supported by Outlook.
  • When subscribing to the calendar, use the default option for refresh. If you do not use the default, Outlook will reload the calendar each time it sends/receives messages.

Mozilla Lightining 1.9

No known issues.

PHPiCalendar 2.23 rc1

Specific Date events (RDATE) don't work.

See Also

Exporting Data

Comma Separated Value/CSV

JSON Export

RSS Export

Filtering on Multiple Options