A separate script is needed if you want to publish iCalendar data to Calcium. It's called iCalPublish.pl, and is available from the Calcium Enhancements page.

Like Calcium itself, the script that handles the publish requests is a Perl CGI script. Put it in the same place as your main Calcium script, and make sure file permissions are set so the user that the web server runs as can read and execute it. If the BEGIN line in your main Calcium script was modified, you'll need to make a similar modification to the iCalPublish script too.

There are a few configuration options you can set; edit the file, and look for the USER CONFIGURATION section near the top. There, you'll find options for:

• Maximum Size - you can set a limit for the size of published files; default is 500,000 bytes.
• Email Address for Error Reporting - most programs that you can publish from - like Apple's iCal, or the Google calendar - don't provide much in the way of diagnostics when things go wrong. So, the iCalPublish script can be set to mail error messages to an address you choose. If something doesn't work, this can be a very useful way to find out why. (Common problems include incorrectly specified passwords or calendar names.)