1.1 --- a/pages/HelpOnEventAggregator Sun Mar 23 01:15:21 2014 +0100
1.2 +++ b/pages/HelpOnEventAggregator Sun Mar 23 01:33:55 2014 +0100
1.3 @@ -261,15 +261,21 @@
1.4
1.5 === Navigation Controls ===
1.6
1.7 -The above examples have all provided fixed views of known events. However, a set of controls can be added to a calendar in order to let users navigate different time periods. This is done by providing a `calendar` parameter, indicating the name of the calendar, and by specifying a period of time:
1.8 +The above examples have all provided fixed views of known events. However, a set of controls can be added to a calendar in order to let users navigate different time periods. This is done by specifying a period of time:
1.9
1.10 {{{
1.11 ## Provide a navigable calendar.
1.12 <<EventAggregator(CategoryEvents,start=current,end=current,calendar=monthly)>>
1.13 }}}
1.14
1.15 +Here, an optional `calendar` parameter, indicating the name of the calendar, is used to distinguish between this calendar and any others that might be displayed on the same page. Without it, any navigation might cause other such calendars to change their positions, too.
1.16 +
1.17 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.18
1.19 +=== Limits on Displayed Calendars ===
1.20 +
1.21 +So that the display of a calendar does not result in a very large Web page being produced, a limit is enforced on the number of months or days that a calendar will show at any one time. This limit is defined in the `event_aggregator_max_duration` configuration setting or is given a default of 31 (months in the calendar view, days in the day view).
1.22 +
1.23 === Showing Calendar Days ===
1.24
1.25 To view the individual days in a calendar, it is possible to hover over or select a day number and select the "View day" link. However, a calendar view can be set up using the macro as follows: