Event Calendar Admin's Manual

3. Setting-up a Calendar

3.6. Event View

This is where you control the appearance and behavior of the event views (Event Viewer and Event Editor).

Template for viewing events

This template controls the look and contents of the Event Viewer.

Event Viewer

The data comes into the page via several macro calls (using the same "<!--#macroName--> form as usual):

• eventSubject
  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).
• eventBodyThis will be replaced with the event's body (also called description). It will be truncated, if necessary, to the length defined in the "Description Length" attribute (see below).
• eventCategories
  This will be replaced with a piece of html that displays all the categories of the event, showing their name, icon, color and textcolor. See Displaying Categories for more infos.
• eventAuthorName
  This will be replaced with the name of the event creator.
• eventAuthorAddress
  This will be replaced with the email address of the event creator (if he didn't chose to keep it private).
• eventStartDate
  This will be replaced with the date of the first instance of the event.
• eventStartTime
  This will be replaced with the time of each instance of the event.
• eventInstance
  This will be replaced with date of the current instance of the event.
• eventDuration
  This will be replaced with the duration setting of the event.
• eventRepetitions
  This will be replaced with the repetitions setting of the event.
• eventId
  This will be replaced with the unique identifier of the event in the calendar.
• msgNum
  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.
• editLink
  This will be replaced with a link allowing to edit the event. It will be visible only to Contributors and Editors.
• eventMsgUrl
  This will be replaced with the url of the event's message in the Discussion Group.
• eventReplyUrl
  This will be replaced with the url to reply to this event in the Discussion Group.
• feedbackLine
  This will be replaced with the error message that could be returned by Conversant.
• eventCategorySelector
  This will be replaced with a popup menu or a list box displaying the categories in a category group, depending on parameters (See Displaying Categories).
• eventCategoryName
  This will be replaced with the name of the categoryGroup whose id is passed as parameter (See Displaying Categories).

Template for creating/editing events

This template controls the look and contents of the Event Editor.

Event Editor

The data comes into the page via several macro calls (using the same "<!--#macroName--> form as usual):

Note: All the macro calls are required in the template.

• formTag
  This will be replaced with the needed <form> tag
• eventId
  This will be replaced with the eventId.
• msgNum
  This will be replaced with the DG msgNum of the event (each event is linked to a message in the Discussion Group).
• eventSubject
  This will be replaced with a text field allowing to edit the event's subject (or title).
• eventBody
  This will be replaced with a textarea element allowing to edit the event's description (or body).
• eventDay
  This will be replaced with a popup menu allowing to set the day when the event occurs.
• eventMonth
  This will be replaced with a popup menu allowing to set the month when the event occurs.
• eventYear
  This will be replaced with a popup menu allowing to set the year when the event occurs.
• eventTime
  This will be replaced with a popup menu allowing to set the hour when the event occurs.
• eventMinutes
  This will be replaced with a popup menu allowing to set the minute when the event will occur.
• eventDuration
  This will be replaced with a text field allowing to set the event's duration time.
• eventDurationType
  This will be replaced with a popup menu allowing to set the type of the duration value (minutes, hours, days, weeks, months).
• eventRepeatNone
  This will be replaced with a radio button for setting the repetition to None.
• eventRepeatEvry
  This will be replaced with a radio button for setting the repetition to Every [n] [period].
• eventEvryFreq
  This will be replaced with a text field for setting the frequency ([n]) of the repetition above.
• eventEvryType
  This will be replaced with a popup menu for setting the type ([period]) of the repetition above (days, weeks, months, years).
• eventRepeatWork
  This will be replaced with a radio button for setting the repetition to Every Workday.
• eventRepeatWknd
  This will be replaced with a radio button for setting the repetition to Every Weekend.
• eventRepeatOffs_end
  This will be replaced with a radio button for setting the repetition to Every [n] [period] from the end of the month.
• eventOffs_end_n
  This will be replaced with a text field for setting the frequency ([n]) of the repetition above.
• eventOffs_end_day
  This will be replaced with a popup menu for setting the type ([period]) of the repetition above (days, Sunday, etc.)
• eventRepeatOffs_ordn
  This will be replaced with a radio button for setting the repetition to Every [n] [period].
• eventOrdn_freq
  This will be replaced with a text field for setting the frequency ([n]) of the repetition above.
• eventOrdnType
  This will be replaced with a popup menu for setting the type ([period]) of the repetition above (Sunday, Monday, etc.)
• eventRepeatDurationNone
  This will be replaced with a radio button for setting the repeat duration to None.
• eventRepeatDurationIndef
  This will be replaced with a radio button for setting the repeat duration to Indefinitely.
• eventRepeatDurationDef
  This will be replaced with a radio button for setting the repeat duration to [n] [period]
• eventRepeatDuration
  This will be replaced with a radio button for setting the repeat duration frequency ([n]) of repeat duration above.
• eventRepeatDurationUnits
  This will be replaced with a popup menu for setting the type ([period]) of repeat duration above (days, weeks, etc.)
• deleteButton
  This will be replaced with the Delete submit button.
• submitButton
  This will be replaced with the main submit button ("Create Event" or "Update Event" depending on the case).
• feedbackLine
  This will be replaced with the feedback message returned by Conversant (either a confirmation or an error message).
• eventCategorySelector
  This will be replaced with a popup menu or a list box displaying the categories in a category group, depending on parameters (See Displaying Categories).
• eventCategoryName
  This will be replaced with the name of the categoryGroup whose id is passed as parameter (See Displaying Categories).

Note: The Event Dialog uses CSS positioning and Javascript to switch between panels and to submit the data. If you edit this template, be careful to not break anything (that's very easy!). See in Displaying Categories how to add (or remove) category groups in that dialog. Also, most macro calls above (if not all of them) are required.

Description Height

This is the number of rows the description textarea will have in the Event Editor.

Description Width

This is the number of columns (or characters) the description textarea will have in the Event Editor.

Dialog Height and Width

The height and width of the Event Viewer and Event Editor window were previously set from here, but we moved them to make shorter Javascript urls (and lighter pages). Now, to change them, you'll have to edit the "editEvent" Javascript (don't worry, that's very easy: just locate the declarations "var winwidth" and "var winheight and change the values ).