Calendar (Events) Module Help

The Events module displays upcoming events as a list in chronological order or in calendar format. Each event listing includes a title, description, and date. Display of an image and the event time is optional.  Each event can be set to automatically expire on a particular date, or re-occur by any specified number of days, weeks, months or years. Height and width properties for calendar cells can be set.

View full details of an event.

1. Click the linked event title. 
2. Export Event to Desktop Event 

Export an event to your computer and save to your Microsoft Outlook calendar.

1. Click the linked event title. 
2. Click the Export Event to Desktop Event link. 
3. Save the file to your computer. The event is now saved on your computer. 
4. To save the event to your calendar. Open the saved file and click Save and Close. 
5. Click OK. 

Add An Event

1. Select Add New Event from the module menu. 
2. In the Title field, enter a title for the event. 
3. In the Description field, enter a description of the event. 
4. At Image (optional), perform one of the following: 
   
   1. If the image has already been uploaded to the Admin > File Manager: 
1. At Image / File Location, select the folder where the image is located. 
2. At Image / File Name, select the image from the drop down list. 
1. If the file has not been uploaded to the Admin > File Manager: 
1. Click Upload New File. 
2. At Image / File Location, select a folder to upload the image to. 
3. At Image / File Name, click Browse. 
4. Locate and select the required image. 
5. Click Upload New File. 
5. In the Alternate Text (required field when Image is set) field, enter the text that will appear as a 'tool tip' when the image is moused over by a visitor. 
6. At Occurs Every (optional), select how frequently the event reoccurs. Select either Days, Weeks, Months, Years from the dropdown box and enter a number to the left. Please Note: reoccurrence only works in calendar display (see 1.) In list display only the start date is displayed. 
7. At Start Date, click Calendar and select the start date for the event. 
8. At Time (optional), enter a time in this format: 09:00 AM. 
9. At Expiry Date (optional), click Calendar and then select the expiry date for the event. The event will expire on this date. 
10. Click Update. 
    Note: If the Event module is set to Calendar view, the calendar will display the current month, not the month of the new event. 

Configure Event Module Using Default Settings

The settings for the Events module must be configured before the module can be used. This tutorial explains how to accept the default settings. 

1. Select Settings from the Events module menu. 
2. Click Update to accept the standard settings. Note that the module menu now displays a range of new options and tasks. 
   See Event Settings for details of the available settings. 

Manage Event Categories

Add or delete event categories. Categories cannot be edited. Event categories will be listed on the Edit Events page. 

1. Select Edit Categories from the events module menu. 
2. Perform the following: 
3. To Add a category: 
   
   1. In the Category field, enter a category name. 
   2. At Color (optional), select a color from the drop down box. 
   3. Click Update. 
4. To Delete a category :  Click the Delete button beside it. 
5. Click Return. 

Manage Event Locations

Add or delete event locations. Locations cannot be edited. Event categories will be listed on the Edit Events page. 

1. Select Edit Locations from the events module menu. 
2. Perform one of the following: 
3. To Add a location: 
   
   1. In the Location field, enter the location name. 
   2. In the Map URL field (optional), enter the URL link to a map of the location. 
   3. ClickUpdate. 
4. To Delete a location, click the Delete button beside it. 
5. Click Return. 

Add An Event

1. Select Add Event from the module menu. 
2. In the Title field, enter a title for the event. 
3. At Start Date/Time click Calendar and select the start date of the event and then select a start time from the drop down selection box. 
4. At End Date/Time click Calendar and select the end date of the event and then select an end time from the drop down selection box. 
5. At Time Zone (optional), select a time zone for the event. The time zone of the person adding the event will be used by default. If the person adding the event is an unauthenticated user, the portal time zone will be used. 
6. At Importance (optional), select the importance of the event from the drop down selection box. Options are Low, Normal or High. 
7. At Category (optional), select a category for the event. 
8. At Location (optional), select a location for the event. 
9. In the Notes field, enter any additional note or a description of the event. 
10. To display an image for the event, perform the following: 
    
    1. At Image Settings, click the Maximize button to view image settings. 
    2. At Display Image?,click the Yes check box. 
    3. At Link Type (optional), select the link to the file. See Link Control for more details. 
    4. In the Width field (optional) enter a pixel amount if you want to override the original size of the image. 
    5. In the Height field (optional) enter a pixel amount if you want to override the original size of the image. 
11. Click Update. 

Display Events In A CalendarcDisplays events in a monthly calendar. The calendar display is the default setting.

1. Select Settings from the module menu. 
2. At Events Settings click the Maximize button. 
3. At Display Format, select Calendar. 
4. At Calendar Cell Width, set the width of each cell by entering a pixel value, e.g. 50. 
5. At Calendar Cell Height, set the height of each cell by entering a pixel value, e.g. 150. 
6. Click Update. 

Display Events In A List 

Events displayed in a List are displayed in a vertical list down the page. The oldest event is listed first and the most recent event is listed last. Only the first date of a reoccurring event is displayed in the List View. 

1. Select Settings from the module menu. 
2. At Events Settings click the Maximize button. 
3. At Display Format, select List. 
4. Click Update. 

Edit An Event 

There are two ways to edit an existing event.Option One:

1. Click the Edit button beside the event record displayed below the calendar 
2. Edit the event details. 
3. Click Update. 

Option Two: 

1. Click the link event title. 
2. Click the Edit link. 
3. Edit the event details. 
4. Click Update. 

Delete An Event

Permanently delete an event.

1. Click the linked event title. 
2. Click the Delete link. A dialog box reading "Are you sure you wish to Delete this entry?" will be displayed. 
3. Click OK. 

Troubleshooting: Newly Added Event Not Displaying

When the Events module is set to Calendar view, the calendar always displays the current month by default. Therefore, when you save an event that occurs on a month other than the current month, when you update the event it will not be displayed. To view the event, use the Calendar navigation, Event Settings, General Event Settings

Working with the General Settings of the Events module>

1. Select Settings from the Events module menu.
2. Click the Maximize button at Event Module Settings. 
3. Modify any of the following settings: 
   
   1. Edit Time Interval: Set the time interval displayed when adding events. The default is 30 minutes. Change the number to set another interval period. E.g. entering 15 will display time periods of 8:00am, 8:15am, 8::30am, etc. Note: This setting must be set before any events are added. If events exist in the module you will be unable to edit this field.
   2. Display Tooltip: Check to display a tool tip for each event. The tool tip will display additional event details, depending on overall settings. 
   3. Disable Month View Cell Display: Check to disable the display of events in the calendar cell. To view events in this set up, the user is required to click on a day cell which will display any related events below.
   4. Set Event Cell Background Color: Select a color to it as the background color of any day cell with an event. This is especially useful where Disable Month View Cell Display has been selected. 
   5. Disable Event Month View Inline Styles: Check to disable inline styles being applied to the monthly calendar. This will disable settings such as Event Cell Background Color, and remove cell width settings. 
   6. Disable Event Month View Navigation Controls: Check to remove the View Week, Today and View Date links displayed on top of the calendar. 
   7. Disable Event Month View Table for non-edit users: Check to hide the list of events being displayed below the calendar for users who don't have editing rights on the module. 
   8. Permit Re-occurring Events: Check to add a new section titled Recurring Settings to the Edit Events page. 
   9. Prevent Schedule Conflict: Check to disallow events being added within the same date and time period. A "Conflict with existing Event! Change Date/Time" message will be displayed if the event date and time conflicts with an existing event. 
   10. Show Events on Next Month (or Prev Month): Check to display events which occur in the month before or after the displayed month in the monthly calendar. E.g. If the displayed month is July and July 31st is on a Monday, any events which occur at the start of August will be displayed in the cells for August. 
   11. Enable DNN Search: Check to enable the DNN search modules to search events. 
   12. Weekend Starts Friday: Check to use Fri/Sat instead of Sat/Sun as the weekend. 
4. Click Update. 

Edit Time Interval

Edit the time interval for events. This setting controls the time periods displayed at both the Start Date/Time and End Date/Time fields. Modifying this setting updates these field according. Note: This setting cannot be modified once one or more events has been added to the module

1. Select Settings from the Events module menu. 
2. Click the Maximize button at Event Module Settings. 
3. At Edit Time Interval, edit the time interval in minutes. E.g. Enter 15 to set 15 minute intervals. This will display as 10:00 AM, 10:15 AM, 10:30 AM, 10:45 AM, etc. The default setting is 30. 
4. Click Update. 

Event List Settings

Working with the List settings of the Events module. To use the list view, you must place two Events modules on the page. Do not enable List mode on the first module, only in the second events module.

1. Select Settings from the Events module menu. 
2. Click the Maximize button at Event Module Settings. 
3. Click the Maximize button at Event List Settings. 
4. At Enable List Mode, check to use the event list. 
5. At Selected Event, select the title of Events module that will function as the Calendar for this list. 
6. The following optional settings are also available: 
   
   1. Show Table Header: Displays a header above event list. (Unsure how to edit this item) 
   2. Choose from the following options to set the number of events displayed by either a number of days or a number of events: 
1. Selected Days: select this option to set displayed events by days. 
1. Enter the number of days before current date. 
2. Enter the number of days after current date; OR Select Number of Events: select this option to set the number of events to be display.
7. Enter the number of events to be displayed from the current date.
8. Enter the number of days in which to display events from. E.g. Next 10 events from current date within the next 14 days. This example will display a maximum of 10 events and will not display events more than 2 weeks in advance.
9. Event Fields to Display: Add fields to the Selected box to display them in the list.
10. Click Update. 

Notification Settings

Working with the notification settings of the Events module.

1. Select Settings from the Events module menu. 
2. Click the Maximize button at Event Module Settings. 
3. Click the Maximize button at Notification Settings. 
4. At Allow Event Notification, check to enable event notifications to be automatically sent. 
5. At Notification Message, edit the notification message. The following tokens are used: 
   
   1. {0} = Event Name 
   2. {1} = Event Date 
   3. {2} = Event Location 
6. Click Update. 

Enrollment Settings

Working with the enrollment settings of the Events module.

1. Select Settings from the Events module menu. 
2. Click the Maximize button at Event Module Settings. 
3. Click the Maximize button at Enrollment Settings. 
4. At Permit Event Enrollment (may be moderated - see below), check to enable authorized users to sign up for events. 
5. At PayPal Account (paid enrollments), enter your PayPal account number if you are collecting fees to paid events. 
6. Click Update. 

Moderation Settings

Enable moderation of events/enrollments for an Events module.

1. Select Settings from the Events module menu. 
2. Click the Maximize button at Event Module Settings. 
3. Click the Maximize button at Moderation Settings. 
4. At Moderator Role (Other than Portal Admin - 'None' = not moderated: select a role from the drop down box. To disable moderation, select None. 
5. At Moderate ALL Event/Enrollment Changes, check to moderate all event changes and not just newly added events. 
6. Click Update. 

Master Settings

Set an events module as a master module which can display events from other events modules.

1. Select Settings from the Events module menu. 
2. Click the Maximize button at Event Module Settings. 
3. Click the Maximize button at Master Settings. 
4. At Master Event Module: check the check box to set this as the master Events module. 
5. At Add Event Module to Master, perform the following:
   1. Select an Events module to be displayed within this master events module 
   2. Click Add to add the module to the master. 
6. Repeat Steps a-b to add additional events modules.
7. Click Update.