Event Calendar Admin's Manual

3. Setting-up a Calendar

3.3. Month View

This is where you control the appearance and behavior of the calendar's Month views.

Main Template

The whole calendar generated by Conversant will be embedded into this template. Thus, you can use this template to display anything in the page, above or below the calendar.

Note: The calendar comes into this template through the <!--#eventCalendarMainBody--> macro call. So this call must be in the template.

Day Template

Each day in the calendar will flow through this template. So you can use it to define how each day will look. By default, it contains the opening and closing tags of an html table.

Note: The data for the day comes into this template through the <!--#eventDayText--> macro call. So this call must be in the template.

Item Template

Each event in a day will flow through this template. So you can use it to define how each event will be displayed. Since the default Day Template defines the opening and the closing tags of an html table (see above), the default Item Template defines the <tr> and <td> tags.

Several macro calls can be used in this template:

• eventName
  This will be replaced with the event name (also called title). It will be truncated, if necessary, to the length defined in the "Name Length" attribute (see below).
• eventMsgNum
  This will be replaced with the DG msgNum of the event (each event is linked to a message in the Discussion Group). You might use this macro to make a link pointing to the DG message, for example.
• eventFirstCategoryColor
  This will be replaced with the category color of the category, from the first category group^*, attached to the event. By default, it's used to display the background color of events with a category from "Priority".
• eventFirstCategoryTextColor
  This will be replaced with the category text color of the category, from the first category group^*, attached to the event. By default, it's used to change the color of the text of events with a category from "Priority".
• eventFirstCategoryName
  This will be replaced with the name of the category, from the first category group, attached to the event. Use it if you want to display the name of the category (it's not used by default).
• eventCategoryIcons
  This will be replaced with all the icons of the categories attached to the event. It's used by default.
• eventEditLink
  This will be replaced with a Javascript link (showing a pen icon) pointing to the Event Editor dialog (see Editing an Event in the User's Manual). This link will be displayed only the users who are allowed to edit the event.
• eventViewLink
  This will be replaced with a Javascript link (showing the event name) pointing to the Event Viewer dialog (see Viewing an Event in the User's Manual).

^*: Note that only the first category group is considered, here. See Displaying Categories for more infos.

Name Length

This is the maximum length for displaying event names. Names that are longer will be truncated.

Cols Width

This is the minimum width of the days columns.

Lines Number

This is the minimum number of lines per day.

Week Links

This is the text to use for the week links of the month calendar.

Max number of Category icons

This is the maximum number of category icons to display in one event.

View in DG