1.1 --- a/pages/HelpOnEventAggregator Sun Nov 18 19:22:17 2012 +0100
1.2 +++ b/pages/HelpOnEventAggregator Sun Nov 18 21:16:00 2012 +0100
1.3 @@ -17,7 +17,7 @@
1.4
1.5 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.6
1.7 -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.8 +Each event must be created on a new page belonging to the appropriate event category, if the calendar has been configured to only look for events in particular categories. The following action can be used to create a new event page (using [[HelpOnEventAggregatorNewEvent|EventAggregatorNewEvent]]) without looking at a calendar:
1.9
1.10 (!) <<Action(EventAggregatorNewEvent,Add an event)>>
1.11
1.12 @@ -142,9 +142,15 @@
1.13 <<Anchor(PreparingACalendar)>>
1.14 == Preparing a Calendar ==
1.15
1.16 -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.17 +Before trying to show a calendar or trying to create any events, you must decide on where those events will come from. This can be one or more of the following:
1.18
1.19 -You can create a new category for the purpose of managing events by filling out and submitting this form:
1.20 + * A category in the Wiki containing pages for your events
1.21 + * An event source which will provide events to the Wiki
1.22 + * Pages that can be found using a particular search pattern
1.23 +
1.24 +You can choose to show a calendar based on categories, event sources and a search pattern, obtaining events from each of these things and combining them into a single view.
1.25 +
1.26 +If you decide to organise your events using categories, you can create a new category for the purpose of managing events by filling out and submitting this form:
1.27
1.28 <<NewPage(CategoryTemplate,Add a new category,,Category%s)>>
1.29
1.30 @@ -175,6 +181,15 @@
1.31 <<EventAggregator(source=GriCal,source=FSFE)>>
1.32 }}}
1.33
1.34 +To use a search pattern instead of categories or sources, specify it using the `search` parameter. For example:
1.35 +
1.36 +{{{
1.37 +## Show events in pages below the MonthCalendarEvents page.
1.38 +<<EventAggregator(search="title:MonthCalendarEvents/")>>
1.39 +}}}
1.40 +
1.41 +This example lets !EventAggregator behave somewhat like the [[HelpOnMacros/MonthCalendar|MonthCalendar]] macro, although new events created using the "New event" link do not currently create appropriately named pages.
1.42 +
1.43 Categories can be combined with sources, thus aggregating "internal" and "external" events:
1.44
1.45 {{{