List important past, current or upcoming events

This package implements the typical Events view functionality in a simple and easy way. The events are presented to the viewer as a list with a short description and the dates. You can choose how many events to show on the list at the same time as well as whether to show the current and coming events or past events. By clicking the link in the event's title, the viewer can see the detailed information of the event.
Event subscription and other advanced features are available in the commercial package Composite.Community.EventCalendar.

Technical description

The package installs 2 functions:

  • Composite.Lists.EventCalendar.Detail: shows a detailed description for all the events specific to the page or a singleevent when accessed from the list of events.
  • Composite.Lists.EventCalendar.List: shows a list of events with short descriptions
Events are kept in a page datafolder called Composite.Lists.EventCalendar.

How to implement Composite.Lists.EventCalendar

  1. Create a page for displaying events ("Events", for example).
  2. Add the Composite.Lists.EventCalendar page datafolder to the page.
  3. Add Events as dataitems to this datatype by filling in following fields:
  • Title: the name of the event (required)
  • Short Description: short description of the event
  • Description: full description of the event
  • Start Date: the starting date of the event
  • End Date: the ending date of the event

How to implement Composite.Lists.EventCalendar.Detail

  1. On the Content tab of the page, the Markup Code tab of a template used for this page or the Template tab of an XSLT function used on this page, insert the Composite.Lists.EventCalendar.Detail function ( Insert > Function), or add the following code:
     
    <f:function name="Composite.Lists.EventCalendar.Detail" xmlns:f="http://www.composite.net/ns/function/1.0"> 
      <f:param name="NumberOfEvents" value="5" /> 
    </f:function>
  2. If necessary, specify the following parameter:
  • Number of Events: The number of the events to display on the page (3 by default). Change the value type to "Specify a simple value" to override the default value.

How to implement Composite.Lists.EventCalendar.List

  1. From the Content or Layout perspective, insert the Composite.Lists.EventCalendar.List function ( Insert > Function), or add the following code:
     
    <f:function name="Composite.Lists.EventCalendar.List" xmlns:f="http://www.composite.net/ns/function/1.0"> 
      <f:param name="DisplayMode" value="true" /> 
    </f:function>
  2. If necessary, specify the following parameter:
  • Display Mode: The type of events to show on a page: the "current and coming events" or the "past events" ("current and coming events" ("true") by default). Change the value type to "Specify a simple value" to override the default value.

Important Notes

  1. The past and coming events are displayed not only from the current page's datafolder, but also from other pages, too.
  2. he Composite.Lists.EventCalendar.Detail function should be added to the page, to which the Composite.Lists.EventCalendar datafolder has been previously added.

Customization

You can customize the layout by editing the style sheets:

/Frontend/Composite/Lists/EventCalendar/Styles.css

Requirements

Composite C1 version 2.0 or later

SHARE