Event Module Functionality

Initial Event Module Configuration Using Default Settings

Introduction to the Events Module

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.

The Event Module enables Users to view, maintain, publish and subscribe to Events.

When you add an Events module to a page, before you can use the Events Module, you may need to configure it. Below figure displays an un-configured Event module looks like. 

The settings for the Events module must be configured before the module can be used. This tutorial explains how to accept the default settings. For the full range of Settings, please see section  “Events Module 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.

Adding an Event

This function allows an Authorised User to Add an Event to the Event Calendar.

1. Select Add Event from the module menu or Add Event from the bottom left side of the module. If you select one of the days on calendar before you select Add Event your data entry for Start and End date of the event will be easier (Step 3)
    
2. In the Title field, enter a title for the event.
3. At Start Date/Time click Calendar, select the start date of the event, and then select a start time from the drop down selection box. If you have selected a date before adding the event you default start date will be the date that you have selected and the default time will be 12:15 AM.
4. At End Date/Time click Calendar, select the end date of the event, and then select an end time from the drop down selection box. If you have selected a date before adding the event you default end date will be the date that you have selected and the default time will be 12:30 AM.
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. If your category has a colour the event title in Month view will be highlighted with the category color.
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. By checking the Send Reminder checkbox you can send reminder email for users that they have asked for by clicking the link Notify Me for this Event @. a. Set the Email From for the send reminder email b. Set the Email Subject. c. Set the Email Message. Note that in Email Subject and Email Message you can use: {0} = Event Title {1} = Event Start Date {2} = Event Start Time {3} = Event Time Zone http://www.dnnguide.com Page 8 of 22 It means that in the email sent to the enrolled user for example {1} will be replaced with the title of the event.
11. To display an image for the event, perform the following: a. At Image Settings, click the Maximize button to view image settings. b. At Display Image, click the Yes check box. c. At Link Type (Optional), select the link to the file. See Link Control for more details. d. In the Width field (Optional), enter a pixel amount if you want to override the original size of the image. e. In the Height field (Optional), enter a pixel amount if you want to override the original size of the image.
12. You can set the Recurring Settings for the event. When you set the recurrence time the event will be populated in the calendar considering it. For example if you set an event for the first Monday of the month, started at 8:00 AM and finished at 9:00 AM and set the recurrence end date to the end of this month and select it as a Weekly Event and Repeated every 1 week on Monday and click update you will see the event is repeated for all of the Monday of this month.
13. If you need to know who is going to take part in the event you need to use Enrollment Settings section. When you check the Allow Enrollment checkbox then the users with the role that you have specified in Enrollment Role will be able to see Enroll for this Event link in the description of the event. You can also set if the enrolment is free or the user needs to pay for enrolling. In addition, you can have a max number of the enrolled users in the event. Under Enrolled Users: the list of enrolled users is shown. You can see that you are able to delete enrolled users or email them the notification email that you have set in Email Message in Event Settings.
14. Click Update.

Tip: If you select an image for the event and do not enter Width and Height it will be filled in automatically. Then if you change the event image and do not change the Width and Height the previous image’s Width and Height will be used to show the new image and it may change the shape of you image. What you need to do to fix this problem is just remove the entries for Width and Height or enter appropriate data.

Editing an Event

This function allows an Authorised User to Edit an Event in the Event Calendar.

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

Deleting an Event

This function allows an Authorised User to 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.

View Events

This function allows a User to view the Events that exist in the Event Module. There are three different options available for viewing the events. View Month, View Week and List Events. The options are available in the module drop down menu (for authorised users) and at the button of the module. These options will not available if the default view has been chosen as the only view in the Settings> Event Module Settings> General Settings.

View an Event

This function allows a User to View full details of an Event.

1. Click the linked event title.

Notify Me for this Event

This function allows a User to subscribe for a reminder to be sent. Note: The Send Reminder option for the Event needs to be set, for the User to see the Notify Me for this Event @ link.

1. Enter a valid email address that you want to get the notify email
2. Click the link. (The link will disappear after clicking)

Enroll for this Event

If enrollment for an event is enabled, the Users with the Enrollment Security Role will see the Enroll for this Event link. By clicking this link, the User will be listed in enrolled Users in the Enrollment Settings section of the event.

1. View the Full Details of an Event
2. Click the Enroll for this Event Link

Manage Event Categories

This function allows an Authorised User to Add or delete event categories. Categories cannot be edited. Event categories are displayed on the Edit Events page.

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

Manage Event Locations

This function allows a User to 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: a. In the Location field, enter the location name. b. In the Map URL field (Optional), enter the URL link to a map of the location. c. Click Update.
4. To Delete a location: Click the Delete button beside it.
5. To Edit select the item link.

Events Module Settings

This function allows an Authorised User to Maintain and Configure the Events Module.

General Event Settings

1. Select Settings from the Events module menu.
2. Click the Maximize button at Event Module Settings.
3. Modify any of the following settings:
   a. 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 times 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.
   b. Event Time Zone: Set the Time Zone that will be used as the Time Zone of all events in this specific Event Module Instance.
   c. Display Tooltip: Check to display a tool tip for each event. The tool tip will display additional event details, depending on overall settings.
   d. Theme/Skin: Select the Theme for a look and feel of the module.
        1. Default: Stretches cells to fit the image and information
        2. Fixed blue: Cells are fixed and will scroll if does not fit
        3. Gray: Stretches to fit the image and information. It is the default but in gray.
        4. Small: Narrow rows and columns. Stretches to fit the image and information
   e. Default Module View: Set the default view of the event module to be List, Week or Month. If you do not check the Only View checkbox at the bottom of the event module there will be a list available for the user to choose a different view for the event module. Otherwise, the default view for the module will be the only view available for the user. For the below module the default view is Week and the Only View is unchecked. If you check the Only View? Checkbox you will not have the View Month, View Week and List Events available.
   f. Disable Month View Cell Events: 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 that will display any related events below. Although in this version, it does not work properly and when you click on the link, it will take you to a page with no information.
   g. Event Detail New Page: Checking this checkbox is supposed to open up the Event Detail page in a new page but it is not working in this version.
   h. Week View Full Time Scale: Check to see the full time scale for the week. If it is not checked, just the time scale with events will be shown.
   i. Disable Event Month View Navigation Controls: Check to hide Event Month View Navigation. j. Disable Category Select: Check to hide Category Selection controls.
   k. Permit Recurring Events: Check this to see the Recurring Settings section in Edit Event page and be able to define recurring event.
   l. 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.
   m. 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.
   n. Disable Event Month View Navigation Controls: Check to remove the View Week, Today and View Date links displayed on top of the calendar.
   o. Disable Event Month View Table for non-edit users: Check to hide the list of events being displayed below the calendar for users who do not have editing rights on the module.
   p. Permit Re-occurring Events: Check to add a new section titled Recurring Settings to the Edit Events page.
   q. Prevent Schedule Conflict: Check to disallow events being added within the same date and time. A "Conflict with existing Event! Change Date/Time" message will be displayed if the event date and time conflicts with an existing event. (It does not work properly for version 03.03.08)
   r. Show Events on Next Month (or Prev Month): Check to display events that 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.
   s. Enable DNN Search: Check to enable the DNN search modules to search events.
   t. Weekend Starts Friday: Check to use Fri/Sat instead of Sat/Sun as the weekend.
   u. Enable Event Image: Check to enable images for event. The image will be shown in the Month view and the Event Detail. The Image Settings section will be shown in the Edit Event page.
   v. Display Time Zone: Check to show the Time Zone in the Event Detail page.
4. Click Update.

Event List Settings

These settings are for the List View of the Event 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. Select Show Table Header if you want to displays a header above event list.
5. Choose from the following options to set the number of events displayed by either a number of days or a number of events:
   Selected Days: select this option to set displayed events by days.
   i. Enter the number of days before current date.
   ii. Enter the number of days after current date.
   Select Number of Events: select this option to set the number of events to be display.
   iii. Enter the number of events to be displayed from the current date.
   iv. 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.
6. Event Fields to Display: Add fields to the Selected box to display them in the list.
7. Click Update.