====== iCal Plugin ======

---- plugin ----
description: Lets you create iCal events on the fly in your wiki
author     : Esther Brunner
email      : esther@kaffeehaus.ch
type       : syntax
lastupdate : 2011-06-05
compatible : 2011-06-05
depends    : 
conflicts  : 
similar    : icalendar, icalevents
tags       : calendar

downloadurl:
bugtracker :
sourcerepo :
----

===== Description =====

This plugin lets you create iCal events on the fly in your wiki, which other users can download and add to their calendars.

The iCal plugin uses the iCal PHP class by [[flaimo@gmx.net|Michael Wimmer]].

The output produced by this plugin looks like this:

%%{{http://qwik.kaffeehaus.ch/_media/dokuwiki/ical.png}}%% FIXME

===== Usage =====

Example:

  {{ical> 2005-08-18 14:00 -> 16:00 <organizer@host.com> http://www.host.com @ Location | Title : Description}}

E-mail, website and location are optional. Here are the parameters:

  - Date: in yyyy-mm-dd format.
  - Start time: in hh:mm[:ss] format; seconds are optional.
  - End time: after an %%->%% arrow in hh:mm[:ss] format; seconds are optional.
  - E-Mail: of person who is responsible for this event.
  - Website: only http addresses are recognized.
  - Location: any text after an @ sign.
  - Description: any text after a | sign.

===== Installation =====
Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.

 * [[http://​www.semperstudiosus.de/​public/​dokuwiki/​ical.zip]] FIXME

===== History =====

  * 2011-06-05 fixes and enhancements
  * 2006-10-10 [[http://idmi.poly.edu/pdlab/ical-with-fixes-2006-10-10.zip|optimized version ]]

===== Wishes =====

  * **download-file-name**
  * **end-date**
  * **utf-8** to use different charsets
  * more **lightweight renderer**
  * **Aggregation** of events summarized on a page
  * **reminder** option

===== Discussion =====

==== Compatibility ====

=== Icon no-repeat (2006-10-10) ====

syntax.php
replace
<code php>
            $link['style']  = 'background-image: url('.DOKU_BASE.'lib/plugins/ical/ics.png);';
</code>            
with
<code php>
            $link['style']  = 'background-image: url('.DOKU_BASE.'lib/plugins/ical/ics.png); background-repeat:no-repeat;';
</code> 

==== ToDo : Reminder Option ====

FIXME \\
In order to add the reminder option, it seems that in ics file, there is only this option : TRIGGER:-PT360M

**TRIGGER:-PTXXXM** where XXX is a number in minute to indicate time to remind before meeting. (Ex : 360 == 6H) \\
FIXME


FIXME : Download link broken