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
How to implement Composite.Lists.EventCalendar
- Create a page for displaying events ("Events", for example).
- Add the Composite.Lists.EventCalendar page datafolder to the page.
- 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
- 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>
- 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
- 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>
- 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
- The past and coming events are displayed not only from the current page's datafolder, but also from other pages, too.
- 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