1.1 --- a/pages/HelpOnEventAggregator Sun Jul 24 00:02:18 2011 +0200
1.2 +++ b/pages/HelpOnEventAggregator Sun Jul 24 00:32:20 2011 +0200
1.3 @@ -5,12 +5,14 @@
1.4
1.5 == EventAggregator ==
1.6
1.7 -The !EventAggregator macro for !MoinMoin can be used to display event calendars or listings which obtain their data from pages belonging to specific categories (such as CategoryEvents).
1.8 +The !EventAggregator macro for !MoinMoin can be used to display event calendars or listings which obtain their data through "aggregation" from pages belonging to specific categories (such as CategoryEvents) or from remote event sources.
1.9
1.10 -<<TableOfContents(2,3)>>
1.11 +<<TableOfContents(3)>>
1.12
1.13 == Creating Events ==
1.14
1.15 +(!) This documentation discusses only the creation of events on Wiki pages. It is also possible to collect or "aggregate" events from other sources, but the use of such sources is beyond the scope of this text.
1.16 +
1.17 The easiest way to create an event is to hover over a day number in a calendar and to follow the "New event" link, or if the calendar is being shown as a list, map or table, to select the "New event" link below the calendar content. If you do not have a calendar set up, take a look at the instructions for [[#PreparingACalendar|preparing]] and [[#ShowingEventCalendars|showing]] calendars first.
1.18
1.19 Each event must be created on a new page belonging to the appropriate event category. The following action can be used to create a new event page (using [[HelpOnEventAggregatorNewEvent|EventAggregatorNewEvent]]) without looking at a calendar:
1.20 @@ -138,11 +140,19 @@
1.21 <<Anchor(PreparingACalendar)>>
1.22 == Preparing a Calendar ==
1.23
1.24 -Before trying to show a calendar or trying to create any events, first decide on a category for your events. You can create a new category for this purpose by filling out and submitting this form:
1.25 +Before trying to show a calendar or trying to create any events, you must either decide on a category for your events or on an event source which will provide events to the Wiki. Or you can choose to show a calendar based on both categories and event sources.
1.26 +
1.27 +You can create a new category for the purpose of managing events by filling out and submitting this form:
1.28
1.29 <<NewPage(CategoryTemplate,Add a new category,,Category%s)>>
1.30
1.31 -It is not strictly necessary to have a dedicated category for events, but having such categories can make event management easier by preventing event pages getting mixed up with other kinds of pages. And since pages can belong to more than one category, you can still assign event pages to other categories and yet isolate the event pages via their own category when you need to.
1.32 +Available event sources should be defined on the [[EventSourcesDict|event sources]] page, and the source name is the piece of information to be noted when preparing a calendar.
1.33 +
1.34 +Where categories are to be used, it is not strictly necessary to have a dedicated category for events, but having such categories can make event management easier by preventing event pages getting mixed up with other kinds of pages. And since pages can belong to more than one category, you can still assign event pages to other categories and yet isolate the event pages via their own category when you need to.
1.35 +
1.36 +=== Defining Event Sources ===
1.37 +
1.38 +!EventAggregator uses a page called EventSourcesDict to define providers of event information (unless the `event_aggregator_sources_page` configuration setting has been changed). Follow the instructions on the EventSourcesDict page to define new event sources.
1.39
1.40 <<Anchor(ShowingEventCalendars)>>
1.41 == Showing Event Calendars ==
1.42 @@ -156,6 +166,20 @@
1.43
1.44 The calendar, shown by default, is automatically filled out with the details of each event in the specified category (or categories), colouring each event period in an automatically generated colour.
1.45
1.46 +To use event sources instead of categories, specify them using `source` parameters. For example:
1.47 +
1.48 +{{{
1.49 +## Show events from the GriCal and FSFE sources.
1.50 +<<EventAggregator(source=GriCal,source=FSFE)>>
1.51 +}}}
1.52 +
1.53 +Categories can be combined with sources, thus aggregating "internal" and "external" events:
1.54 +
1.55 +{{{
1.56 +## Show events from the Events category and the GriCal source.
1.57 +<<EventAggregator(CategoryEvents,source=GriCal)>>
1.58 +}}}
1.59 +
1.60 Specific periods can be defined using the `start` and `end` parameters. For example:
1.61
1.62 {{{