EventAggregator

Description

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). The start and end dates are read from the page describing each event, and the calendar is automatically filled out with the details of each event, colouring each event period in a specially generated colour.

Download & Release Notes

Usage

Put <<EventAggregator(CategoryEvents)>> (for Moin 1.5 use [[EventAggregator(CategoryEvents)]]), substituting your preferred category names as the arguments to select categories from which events will be aggregated and shown.

See also ActionMarket/EventAggregator for documentation on the EventAggregatorSummary action which provides iCalendar and RSS 2.0 download support for this macro, together with details of the EventAggregatorNewEvent action which provides convenient event creation through a form displayed on the currently shown page.

Examples

## Show multiple categories:
<<EventAggregator(CategoryEvents,CategoryTraining)>>

## Show a category's events as a list:
<<EventAggregator(CategoryEvents,mode=list)>>

## Show a category's events repeating the name in every consecutive day of an event:
<<EventAggregator(CategoryEvents,names=daily)>>

## Show a category's events for this and next month:
<<EventAggregator(CategoryEvents,start=current,end=current+1)>>

## Show a category's events for this and next month with navigation controls:
<<EventAggregator(CategoryEvents,start=current,end=current+1,calendar=events)>>

Screenshots

Copyright

Copyright (C) 2008, 2009, 2010 Paul Boddie <paul AT boddie DOT org DOT uk>

Some patches provided by the following contributors:

Copyright (C) 2009 Cristian Rigamonti <rigamonti AT fsfeurope DOT org>

Some pieces of MoinMoin code were used in this work - typically pieces which demonstrate how to perform certain common tasks (as found in various macros and actions) - and are thus covered by the following copyrights:

Copyright (C) 2000-2004 Juergen Hermann <jh AT web DOT de>

Copyright (C) 2003-2008 ThomasWaldmann

Copyright (C) 2004-2006 AlexanderSchremmer

Copyright (C) 2007 ReimarBauer

License

GNU General Public License version 2 or later

Important Notices

In release 0.6, support for event times has been introduced. Due to the complicated nature of times, time zones, time regimes, and so on, the behaviour of the software may change in future versions to support common use-cases in a more convenient fashion. Please be aware that implicitly chosen or generated time or time zone information may change for events, particularly those whose times are ambiguous or ill-defined. It is highly recommended that the pytz library be installed - see the documentation regarding dependencies for more information.

In release 0.5, the "download this calendar" and "subscribe to this calendar" links have been fixed to return only events within the specified period and to work with day- and month-relative calendars. Users who have bookmarks in their Web browser or feed reader should replace these bookmarks by visiting the bookmarked page and acquiring new versions of these links, once EventAggregator has been upgraded.

Bugs

• EventAggregator does not yet work with MoinMoin 1.9, although the repository version is very close to working fully.

• Calendars (as opposed to views of calendars) for download and subscription don't readily reflect what the download/subscription will contain, nor is there a convenient link to customise their content.
• Event metadata should support Wiki text so that links (for example) are shown correctly in the table view.

• Fixed in 0.5: Perhaps event colours should be based on the label instead of the page name, so that identically labelled events have identical colours.

• Fixed in 0.2: Event regions sometimes don't maintain the same height across multiple days, despite hacks to attempt to produce event boxes with a consistent height across consecutive days without using fixed dimensions.

Suggestions

• Views should expose more metadata such as topics and locations and possibly permit filtering according to such metadata.

• Support for recurring events would be nice. -- MelaEckenfels 2010-01-02 22:03:46

  • Multiple events per page is now supported - not quite recurring events, but movement in that direction. -- PaulBoddie 2010-02-16 23:38:02

• Support localised keywords when describing events.
• Styles should be obtained from a theme-independent stylesheet, if possible.
• Events at different times within the same day could be shown in order, possibly using a day view.

Discussion

The Xapian search software is highly recommended, if not technically essential, for the acceptable performance of the EventAggregator macro since the macro makes use of search routines in MoinMoin that can dominate the time spent processing requests. See HelpOnXapian for installing Xapian and getting acceptable performance.