1.1 --- a/pages/HelpOnEventAggregator	Mon Jun 08 23:41:01 2009 +0200
     1.2 +++ b/pages/HelpOnEventAggregator	Fri Oct 02 22:42:37 2009 +0200
     1.3 @@ -44,7 +44,7 @@
     1.4   Title:: the preferred name of the event in the calendar
     1.5   Summary:: a synonym for title
     1.6   Topics:: a list of topics related to the event - use a comma (`,`) to separate topic names
     1.7 - Categories:: a synonym for topics
     1.8 + Categories:: a synonym for topics - note that this means "event categories", not "page categories" which are a distinct concept
     1.9   Location:: the location of the event
    1.10  
    1.11  These properties may be incorporated into representations or summaries of events.
    1.12 @@ -116,7 +116,7 @@
    1.13  
    1.14  Without any time period, the calendar would show all events, and there would be no real need to provide navigation, since there would be no events outside the displayed period to navigate to. It is possible to omit either the `start` or the `end` parameter and still provide navigation, however.
    1.15  
    1.16 -== Showing Event Lists ==
    1.17 +== Showing Event Lists and Tables ==
    1.18  
    1.19  A more plain view of events can be displayed by specifying the `mode` parameter as follows:
    1.20  
    1.21 @@ -124,7 +124,25 @@
    1.22  <<EventAggregator(CategoryEvents,mode=list)>>
    1.23  }}}
    1.24  
    1.25 -The `list` value causes a list view to be employed; the `calendar` value causes the default calendar view to be employed.
    1.26 +The `list` value causes a list view to be employed.
    1.27 +
    1.28 +Another alternative view can be chosen by specifying the `mode` parameter with a value of `table` as in the following example:
    1.29 +
    1.30 +{{{
    1.31 +<<EventAggregator(CategoryEvents,mode=table)>>
    1.32 +}}}
    1.33 +
    1.34 +This collects all appropriate events into a single table, applying colouring to the cells belonging to a particular event based on that event's topic (or category) information. By default, only the following topics (or categories) cause cell colouring:
    1.35 +
    1.36 + * `conference` - using the `event-table-category-conference` style
    1.37 + * `special` - using the `event-table-category-special` style
    1.38 + * `training` - using the `event-table-category-training` style
    1.39 +
    1.40 +To define your own topic colours, edit the `event-aggregator.css` file which is provided with the !EventAggregator distribution, and then reinstall that file for each of the Wiki themes of interest. Topics involved in event colouring should be mutually exclusive: more than one such topic should not be specified for any given event.
    1.41 +
    1.42 +=== Note ===
    1.43 +
    1.44 +The `calendar` value causes the default calendar view to be employed.
    1.45  
    1.46  == See Also ==
    1.47