Recent Changes - Search:

Cookbook

PmWiki

pmwiki.org

HandleICal

Summary: Add-on for wikicalendars to export/import events to/from ical-files
Version: 2008-01-24
Prerequisites: PmWiki 2.2 beta
Status: Beta
Last-tested-with: 2.2.0 beta65 and PmCalendar
Maintainer:
Categories: Calendar, PIM

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

See Also

ICalExport

Contributors

Comments

Edit - History - Print - Recent Changes - Search
Page last modified on January 25, 2008, at 05:11 AM