• View
• Edit
• History
• Attach
• Print
• Backlinks

HandleICal

Questions answered by this recipe

How can I export events of an specific date from an existing wikicalendar?
How can I export all events of my whole wikicalender?
How can I import ical-files to my wiki?

Description

Import/Export ical-files from/to a wikicalendar.

The script adds two action ("?action=fromics" and "?action=toics") to the wiki, which permit to import events from a given ical-file to a wikicalender or export events from a wikicalendar to a ics-file.

Installation:

This script assumes that you have installed a calendarsolution for PmWiki (like PmCalendar, WikiCalendar or Logbook) using a separate WikiGroup und pagenames like "group/yyyymmdd"

1. download handleical.phpΔ and copy it to your cookbook folder
2. include it into your config.php using: "include_once("$FarmD/cookbook/handleical.php");"
3. set the following parameter before including the Recipe in your config.php:
   1. $ICalCalendarGroup - the name of your wikilog group - default:"Calendar"
   2. $ICalTimeZone - the time zone the events belong to - default:"Europe/Berlin"
   3. $ICalFileName - the name of calendarfile - default:"PmWiki_Cal"

Usage:

The recipe expects each calendar entry to be seperated by a horizontal rule and to use keywords ("Von:", "Bis:", "Wo:", "Beschreibung") for the single parts of the event.

    !!!title of the first event
    Von: hh:mm 
    Bis: hh:mm 
    Wo: 
    Beschreibung: 

    ----
    !!!title of the next event
    ...

To export events from your calender the scripts adds the action "?action=toics" to your wiki, which will create a file and store it in the Uploaddirectory of the calendargroup.

• to export the events of the shown page use "?action=toics" without any further parameter
• to export the events of a specific date use "?action=toics&date=yyyymmdd"
• to export all events of all pages in your wikicalender use "?action=toics&date=all"

To import events from an ical-file (.ics, RFC2445) use the action "?action=fromics", which will add all events from a previously uploaded file (with the name "events.ics") to your wikicalendar-pages. To import a specific file, use the "?action=fromics&file=filename" (without extension) to get all events from a ical-file named "filename.ics".

Notes

The whole recipe is mainly in German and the keywords are hardcoded at the moment, what will change in a following version.

Release Notes

• 2008-01-24 initial release
• 2009-10-03 minimal bug fixes (Von: / Bis: where exchanged)
• 2009-10-04 minimal bug fixes (limit the listpages()-function to the needed pages for events of the Calendar group only)

See Also

ICalExport

Contributors

• schroe?
• MarkusS?

Comments

See discussion at HandleICal-Talk