Help:Eventcalendar format

The result format eventcalendar makes use of the "jquery.fullcalendar" plugin to generate an event calendar with different views to choose from (see  below).

Data model
It is recommended that an event entity is represented by an subobject to allow individual events to be placed within the same page source and to separate source from data.

An event is specified as a single entity represented by a title, start date, end date (optional), color (optional), icon (optional), and/or description (optional). This data model stipulates that a subject (page) contains one event or in case it contains several events those events are represented as individual subobjects within the same page.

If you want to generate recurring events, please have a look at parser function.

Styling
A property can describe a color or icon and be assigned to an individual event.

Icons are expected to be uploaded and available within the wiki itself. The event calendar will not make any transformations of icons and therefore any icon uploaded should have an appropriated size to enable a normal display behavior.
 * Icon

Properties that carry a special meaning can be variable within a query while its identifier remain fixed without the need for extra parameters (Fixed identifiers are title, icon, color) resulting in a query like

Minimum height is 350 px. The class only get's applied for height >= 350 px. See here.
 * Height

Calendar start
The parameter  is responsible for the initial calendar start of dates shown.

"current" (default setting) determines the initial calendar start as the current year, month or day. "earliest" can be used where planned events are outside of the current month and the calendar display should reflect the earliest event within those selected events. This option allows to show events beyond the current month without having to browse its earliest entity. "latest" can be used analog but reflects the latest event.

Calendar filtering
In case the calendar uses the color option to indicate different typological content (events), a filtering option can be used to filter events through a property (location, type etc.) that is semantically linked by its color.

Calendar legend
The parameter  is responsible for the positioning of the portlet that is used to display the content. Available options are "top", "bottom", "tooltip", "pane" or "none".

User preferences
Event calendar user preferences are described here.

Examples

 * SMWCon Fall 2012/Calendar demonstrates how events are handled on a page to page basis
 * clicktarget parameter example