Displaying Events

Display a list of upcoming events, as sepcified in the edit page section 'event' date entry. This allows events from many different pages to be displayed on a single page. The ending [/events] is required.

[events]6[/events]
The next 6 upcoming events, starting with the current date/time. Any number can be specified.

[events=/page/toshow]6[/events]
Limits the display to the events on the specified page, in this case, the page "/page/toshow". This can be used with any of the methods shown below. To show a page and all lower pages, use the wildcard syntax of [events=/page*]6[/events]

[events]-6[/events]
Specifying a negative number of events results in a list starting with the current date/time and going backward for the specified number of events. This method is similar to a 'blog' and can used for the 'News' page of this site, since there are seldom any upcoming events on this site. This feature could be used to post the results of past events, by editing the event announcement to instead contain meeting minutes, scores for a sporting event, etc.

[events]2004-07-04[/events]
Show events on July 4, 2004, or any other given day.

[events]2002-01-01 to 2002-01-31[/events]
Show all events that occurred in January, 2002, or between any two dates. This could be useful for showing all of the events to take place during a conference or other multi-day event.

[events]+1 month[/events]
Starts with the curent datet/time and goes forward for the specified time period. The example above shows events over the next month (i.e. up to the same date in the next month).
The specified time period is quite flexible
  +12 days
  +2 weeks
  +1 year
  +60 hours
or any combination of these, so

[events]+1 year +1 month +2 weeks -3 days +6 hours[/events]

is legitimate!
The first character must be a '+' and the total expression mst be a positive number of days for anything to be displayed.

Events and Section Headers

If the section that contains the [events] tag has a header, and the event has a header, two headers will be displayed.
If the section that contains the [events] tag is specified as a sidebar item, that section header will be the same as other sidebar headers. The events listed, however, will have their headers formated as regular section headers, withut regard as to whether or not the included events section(s) are specified as sidebars sections or not. Note that this behavior is different than the [include] tag, which always displays included sections as specified in the edit screen setting (i.e. if 'sidebar' is checked, it will display as a sidebar).

To speed processing, only one [events] tag is processed in each section. For more than one [events] on a page, put each one in a separate section. Omission of the ending [/events] or placing more than one [events] in a section will produce unpredictable results.