paul@222 | 1 | The following event sources are defined for !EventAggregator: |
paul@222 | 2 | |
paul@428 | 3 | GriCal:: url http://grical.org/s/?query=%23free-software+{start}+{end}&view=ical ical |
paul@428 | 4 | |
paul@428 | 5 | To add a new source, extend the above definition list, putting the name of the source (to be used with the !EventAggregator macro) as the definition title, and putting the source's URL and the format of the data provided by the source, separated by whitespace, as the definition body. An expected content type can also be specified if the source provides content labelled with an unconventional content type. |
paul@428 | 6 | |
paul@428 | 7 | Other types of sources can be specified by replacing `url` with another source type and using the appropriate parameters. See the syntax description below for details. |
paul@428 | 8 | |
paul@428 | 9 | == Syntax == |
paul@428 | 10 | |
paul@428 | 11 | For a `url` source indicating a source accessible via a specified URL: |
paul@428 | 12 | |
paul@428 | 13 | {{{ |
paul@428 | 14 | name:: url <url> <format> [ <content-type> ] |
paul@428 | 15 | }}} |
paul@222 | 16 | |
paul@428 | 17 | For `store` source types indicating a sources accessible via an item store associated with a wiki page: |
paul@428 | 18 | |
paul@428 | 19 | {{{ |
paul@428 | 20 | name:: store <page-name> <store-name> [ <lock-directory-name> ] |
paul@428 | 21 | }}} |
paul@428 | 22 | |
paul@428 | 23 | == Formats == |
paul@222 | 24 | |
paul@428 | 25 | Currently, the supported formats are: |
paul@428 | 26 | |
paul@428 | 27 | * `ical`: iCalendar ([[http://tools.ietf.org/html/rfc5545|RFC 5545]]) |
paul@428 | 28 | * `xcal`: xCalendar ([[http://tools.ietf.org/html/draft-hare-xcalendar-03|draft-hare-xcalendar-03]]) |
paul@428 | 29 | * `mbox`: [[http://tools.ietf.org/html/rfc2045|multipart]] e-mail messages containing iCalendar or xCalendar content parts |
paul@428 | 30 | |
paul@428 | 31 | == Caching == |
paul@228 | 32 | |
paul@228 | 33 | Events from sources for a particular view are cached in !EventAggregator for a period of time. The default period of 300 seconds (5 minutes) can be changed by defining the `event_aggregator_max_cache_age` in the [[HelpOnConfiguration|Wiki configuration]], specifying a number of seconds to be used for the maximum age of a cache entry. |