Remote Publishing with k5nCal

From WebCalendar Wiki

If you are not familiar with k5nCal (aka "k5n Desktop Calendar"), please check out the [k5nCal Home Page. In summary, k5nCal is an open source Java-based desktop calendar application.

Contents 1 Enabling Publishing in WebCalendar 2 Modifying Your Apache Configuration 3 Read-Only Subscribe 4 Read/Publish 5 Notes 5.1 Read-Only Subscribe 5.2 Read/Publish

[edit] Enabling Publishing in WebCalendar

Ok, this part is not k5nCal-specific. But, you need to do this first. Follow the steps below:

1. Go to Settings
2. Select Preferences
3. Click on the Subscribe/Publish tab
4. For read/write publish, turn on Allow remote publishing (requires WebCalendar 1.1+)
5. For read-only subscribe, turn on Allow remote subscriptions. This will allow anyone with knowledge of this URL

[edit] Modifying Your Apache Configuration

For read/write publish, you may need to modify your Apache's configuration file to allow support for HTTP PUT by adding the following to your httpd.conf file:

<Directory "/var/www/html/webcalendar">
Script PUT /icalclient.php
</Directory>

Of course, replace "/var/www/html/webcalendar" with the directory where you installed WebCalendar.

[edit] Read-Only Subscribe

Read-only subscriptions from WebCalendar to k5nCal allow you to view your existing WebCalendar data from within the k5nCal application. You cannot make changes within k5nCal and send those changes back to WebCalendar.

Start by selecting the Calendar menu, and the Subscribe to Remote... menu option. This is shown in the screenshot below:

After you have clicked on the Subscribe to Remote... menu option, a dialog window will appear with options for your subscribed calendar:

You may choose how often you want k5nCal to reload the calendar data from WebCalendar by enabling the Update Interval. If you leave this option set to Never, you can manually refresh a calendar by using the CTRL-Mouse (Mac) or right mouse click (Windows) on the calendar in your list of calendars (upper left corner of the k5nCal window).

[edit] Read/Publish

Please see notes at the bottom of this page for limitations with this approach. k5nCal is still in beta, so some features are not supported yet. (For example, reminders are not yet supported, so your reminders may get removed from all of your WebCalendar events.) And, of course, this is only supported in WebCalendar 1.1 and later.

Below is a screenshot of the remote subscription window with the Mode set to Read/Publish. This configuration will allow you to edit events in either k5nCal or WebCalendar. (Unlike Apple iCal, which requires you to do all edits in Apple iCal when using iCalendar. Apple iCal does support CalDAV, but CalDAV is not yet supported in WebCalendar.)

The Sync before publish option will tell k5nCal that it should download the latest calendar updates from WebCalendar before attempting to publish changes to WebCalendar. For example, if you have modified an event directly with WebCalendar, and then you change a different event in k5nCal, without this option enabled you might overwrite the change made in WebCalendar when you publish. So, it is recommended that you enable this option for use with WebCalendar. For Authentication, choose Basic. And, of course, use your WebCalendar login and password for the Username and Password fields.

---

[edit] Notes

• Note: This page was written using k5nCal 0.9.7.

[edit] Read-Only Subscribe

• There are no known issues with k5nCal and WebCalendar's remote subscriptions.

[edit] Read/Publish

• If you want to delete an event in k5nCal and have it be deleted in WebCalendar when the change is publish, you will need to change the status to "Canceled" rather than actually deleting the event in k5Cal. WebCalendar will treat a canceled event as one that should be deleted in WebCalendar. If you just delete the event in k5nCal, it will reappear after the next sync.
• If you add events to WebCalendar (through the web interface, not through k5nCal), these events will show up in your k5nCal, unlike when you try this with Apple iCal.