The Events Module Settings

In version 5.1.4, the Events module settings were re-organised to reduce clutter. Also they are accessed via this icon on the Icon bar. In version 6.0.0 the icon has changed to this one . The structure has also been changed to take advantage of the DNN 6 tabs. The screenshots are taken from the latest version.

This page will describe all the groups of settings. Just click on the links below to get to the appropriate section:-

• General
  • General Settings
  • Look & Feel Settings
  • Timezone Settings
• Display
  • Detail View Settings
  • Month View Settings
  • Week View Settings
  • List View Settings
  • Custom Fields Settings
  • Tooltip Settings
  • Image Settings
• Notification
  • Event Email Settings
  • Reminder Settings
• Enrollment & Moderation
  • Enrollment Settings
  • Moderation Settings
• Sub-calendar
  • SubCalendars Settings
• SEO & Sitemap
  • SEO Settings
  • Sitemap Settings
• RSS, iCal & Social
  • RSS Settings
  • Calendar Export Settings
  • Social Integration Settings
• Templates
  • Template Settings

General Settings

Version	Setting	Description
3.3.8	Edit Time Interval	This sets the available time intervals when adding an event. The default is 30, so the times displayed in edit events will start at 00:00 and then go foward in 30 minute slots (00:30, 01:00, 01:30)
3.3.8	Permit Recurring Events	Allows module creators to add recurring events
5.1.4	Max Generated Occurences	Restricts the number of automatically generated instances of a recurring event - to protect against users creating many events and impacting performanmce by putting an end date long in the future.
3.3.8	Prevent Schedule Conflict	When ticked, the module stops an event being created that overlaps with another
5.0.1	Check for Location Conflicts	When ticked, changes the Prevent Schedule Conflict functionality to stop overlapping events at the same location. Events with no location are allowed to overlap.
3.3.8	Enable DNN Search	Allows the core DNN search functionality to index the calendar.
5.0.1	Owner Change Allowed	Allows event moderators to change the event owner.
5.0.1	Delete Events Older Than	When a value is entered, events older than the specfied number of days are cancelled. When all events in a recurring series are cancelled the series is deleted. Requires the 'DNN Events' schedule item to be running.
5.0.1	Private Calendar Message	When a message is entered, this message is displayed in place of the standard event details unless the user is the event owner or is a moderator.
5.1.4	Filter Events by Category	Filters the events displayed in the calendar by this value. If 'Enable Category Select' is ticked in 'Look & Feel Settings', then this is the initial filter and the user may change it using the category box at the top of the module. If 'Enable Category Select' is unticked then this filter is used for all events displayed.
5.2.0	Emails From	This is the email address the majority of emails are sent from. Some items (e.g. Reminders) have specific email addresses, however where one isn't specifically set, this one will be used.

Look & Feel Settings

Version	Setting	Description
3.3.8	Theme/Skin	Allows theme for the module instance to be set. Standard Themes are installed with the module. Admins may upload Custom Themes to the portalroot/DNNEvents directory. A sub directory must be created for each theme containing the css file and any other required items. The css file must be named with the same capitalization as the directory. Any styles that are to be applied to the individual calendar must have the css class .Theme#####, where ##### is the same name and capitalization as the theme directory. (e.g. Sub dir MyTheme, css file MyTheme.css, css class '.ThemeMyTheme .Event'.)
3.3.8	Default Module View	The view displayed when firsting viewing a page.
5.0.1	Module Views Allowed	Displays the appropriate buttons on the Icon Bar ( ) and in the module acetion menu to allow user to change view.
5.0.3	Use Module Container & Skin	The module container and page skin are added to the url so that any module content is displayed in the same skin as the orginal module. Particularly relevant when Event Detail New Page or Event Day New Page are ticked. Otherwise the event content will displayed the the default portal skin and container.
6.0.3	Enable Category Select	Has three options to control the category slection box at the top of the views: Do Not Display - category box is not show, either shows all categories of events or those filtered in module settings. Single Selection - Works as in versions previous to 6.0.3 to show a list where a single category can be selected. Multiple Selection - Shows alist with check boxes where multiple categories can be selected.
6.0.3	Restrict Categories	Restricts the list of categories usable in display and edit views to those defined in the Filter Events by Category setting.
5.0.1	Enable Date Navigation Controls	Displayes date navigation controls at the top of the Month and Week views
5.0.1	Icon Bar	Choose to display the Events module Icon Bar at top right, bottom middle or not at all.
5.1.5	HTML Email	Choose whether emails are sent as HTML, Text or are auto detected by the DNN core mail send routines. Auto detection capabilities vary between different versions of DNN.
5.2.0	First day of Week	For admins who don't want Sunday or Monday as the first day of the week, in the week and month displays, this allows the day to be specifically configured. Using Default sets it to the first day of the week in the logged on users Locale.

Timezone Settings

Version	Setting	Description
3.3.8	Event Time Zone	Sets the timezone of the calendar instance. (Prior to Events 6: All events within the calendar instance are displayed as-is with no correction for system or user timezone. Events displayed from sub-calendars are corrected by the difference in timezone between the two. iCal exports and notifications are created based on the timezone. Note that the module does not accurately support DST since there is currently not DST support within DNN. The module attempts to correct for DST but may not be 100% accurate in all situations.)
3.3.8	Display Time Zone	If enabled the timezone is displayed in the edit view. Other displays of the timezone are controlled via the templates.
6.0.0	Primary Display Time zone	Selects the preferred timezone that events will be displayed in. User is the timezone of the logged in user. Module is the timezone of the module. Portal is the timezone of the portal.
6.0.0	Secondary Display Time Zone	Selects the backup timezone that events will be displayed in.
6.0.0	Per Event Time Zones	Enables timezones to be configured on a per event basis. Default timezone is the module timezone. Detail view will display in the event timezone.

Detail View Settings

Version	Setting	Description
3.3.8	Event Detail New Page	If enabled, when an event is clicked on then the Detail page is opened in a new page with no other modules. Useful for calendars on a home page when you don't want all the rest of the home page modules displayed when looking at the details of an event.
5.0.1	Set Event Detail Page Allowed	Allows a url to an event detail page outside the calendar to be displayed instead of the standard Detail page view. The url is entered via the Edit Events page. The icon is displayed in the different views to allow event editors to access the standard Detail Page and then edit the event.
5.1.4	Enable Enroll Validation Popup	Enables a popup box to be displayed asking if a using is sure they want to enroll to an event.

Month View Settings

Version	Setting	Description
3.3.8	Enable Month View Cell Events	When enabled event details are displayed in the Month view. Otherwise the number of events on the day are displayed (modifiable via template), and the user is taken to the Day view when they click on a day with events.
3.3.8	Show Events in Next/Prev Month	Shows events occuring in the elements of the previous and next months shown at beginning and end of the cuirrent month.
3.3.8	Weekend Starts Friday	Sets the week-end to be Friday and saturday rarher than Saturday and Sunday.
4.0.1	Show Event Start Time in Title	Shows the event start time in the details displayed about the event in Month view.
5.0.1	Event Day New Page	When 'Enable Month View Cell Events' is enabled, and this setting is ticked the Day view is opened in a new page with no other modules. Useful for small calendars on a home page, where there is no space to display the day view.
5.1.4	Enable Selectable Day	Allows the day to be selectable in the Month View calendar
5.0.1	Show Event Icons	Shows the following icons if appropriate. Priority - . Recurrence - . Enrollments - . Reminders -

Week View Settings

Version	Setting	Description
3.3.8	Full Time Scale	Shows full day rather than just the time period over which events occur
4.0.1	Include End Values	Shows the date covering the start and end time periods (e.g. Event from 13:00-13:30 will show against 13:00 and 13:30 time periods. When unticked the event shows against the start.
4.0.1	Show Value Marks	Shows gridlines against the time perios, so display of the evnt aligns with the time period grid lines
5.0.1	Show Event Icons	Shows the following icons if appropriate. Priority - . Recurrence - . Enrollments - . Reminders -

List (& Day) View Settings

Version	Setting	Description
5.2.0	Grid or Repeater	Allows the list view to be configured as a Repeater rather than a traditional Table. Further settings allow the number of rows and columns to be configured. By default the repeater uses html table elements, but can be configured to purely use elements entered into the templates to allow a free form style. Repeater mode does not apply to Day View.
3.3.8	Show Table Header	Shows the column headings.
3.3.8	Select Events by Days	Specifies the days befre and after today for which events should be shown.
3.3.8	Select Events by Number	Specifies the number of events to display over the specified number of days after today.
3.3.8	Events Fields to Display	Selects the columns to be displayed in List and Day views.
5.0.1	Page Size	Sets the number of events to display per page in List View
5.0.1	Defaut sorting	Sets whether to sort ascending of descending by default. User may change sort direction by clicking on header in List view.
5.1.4	Default Sort Column	Sets the initial sort column for List view. User may change the sort column by clicking on the header.
5.0.1	Collapse Recurring	Collapses recurring events within the list to a single row. It is the useful to include the Recurrence Pattern and End date as columns displayed in the list.
5.0.1	Show Event Icons	Shows the following icons if appropriate. Priority - . Recurrence - . Enrollments - . Reminders -
5.2.0	Repeater as Table	By default the Repeater uses html table elements. Advanced users may turn off the use of the table elements, in which case the repeater will purely use the html entered into the relevant repeater temnplates.
5.2.0	Repeater Columns	Specifies the number of columns in the Repeater.
5.2.0	Repeater Rows	Specifies the number of rows in the Repeater.
5.2.0	Use Time in Filter	For increased accuracy of filtering of the list view, the current time can be used to specify the start and end of the displayed time period. By default 00:00 is used.

Custom Fields Settings

Version	Setting	Description
4.0.1	Display Custom Field 1	Enables custom field 1. The text for labels and heading against custom fields can be set in the standard Admin/Languages dialogues.
4.0.1	Display Custom Field 2	Enables custom field 2. The text for labels and heading against custom fields can be set in the standard Admin/Languages dialogues.

Tooltip Settings

Version	Setting	Description
5.1.4	Display Month View Tooltip	Tooltip is displayed when hovering over event when 'Enable Month View cell Events' is enable, or when hovering over a day with events when it is disabled.
5.1.4	Display Week View Tooltip	Tooltip is displayed when hovering over event.
5.1.4	Display Day View Tooltip	Tooltip is displayed when hovering event row.
5.1.4	Display List View Tooltip	Tooltip is displayed when hovering event row.
5.0.3	Tooltip Length	Sets the maximum length of the tooltip.

Image Settings

Version	Setting	Description
3.3.8	Enable Event Image	Allows admins to add and image to an event
5.0.1	Show Month View Event Image	Shows the event image against the event details when 'Enable Month View Cell Events' is enabled.
5.0.1	Show Week View Event Image	Shows the event image against the event details.
6.0.0	Max Thumbnail Width	Sets the maximum size of the thumbnail displayed in month and week views and displayed by the tumbnail tokens.
6.0.0	Max Thumbnail Height	Sets the maximum size of the thumbnail displayed in month and week views and displayed by the tumbnail tokens.

Event Email Settings

Version	Setting	Description
5.1.4	Send New Event Emails	Never - No new event emails are sent. Subscribers - the 'Notify Me' checkbox ( ) is enabled in the Iconbar and a user may subscribe to new event emails. Role - new event emails are sent to users in the specified role.
5.1.4	Allow Email Send by Event Editor	Allows the event creator/editor to send an email to a role specified on the Edit Events view.

Reminder Settings

Version	Setting	Description
3.3.8	Allow Event Reminders	Enables the event reminders options in Edit view. Requires the 'DNN Events' schedule item to be running. Users wanting a reminder must go to the Detail view of the event and click 'Notify Me for this Event @'
3.3.8	Remind Anonymous	Allows anonymous users to request a reminder for an event
5.0.1	Send Reminder Default Value	Sets the default value of Send Reminder tick box on Edit view.
5.0.1	Reminder Email From	Sets the default value of the Reminder Email From setting in Edit view.

Enrollment Settings

Version	Setting	Description
3.3.8	Permit Event Enrollment	Enable enrollment settings in Edit view. The Icon is enabled in the Icon Bar.
6.0.0	Allow Paid Events	If enabled paid for events are allowed. When disabled only free events are allowed.
6.1.1	Allow Anonymous Enrolment	If enabled users are allowed to enrol when not authenticated to the site. Essential user details will be collected as part of the enrolment.
3.3.8	PayPal Account	The default value for the PayPal Account setting in Edit view.
3.3.8	PayPal URL	The url to use for PayPal.
5.0.1	Displays Enroll List by Default	Sets the default value for the 'Enroll List on Detail View setting in edit view. When the enroll list is enable, the list of attendees for the event are displayed on the Detail view.
5.0.3	Hide Full Enrolled Events	When enabled fully enrolled events are not displayed in the the views apart from to an event editor.
5.1.4	Allow Multiple Enrolees	Allows someone enrolling to an event to enter a quantity of enrolees up to this maximum.
5.1.4	Cancel Before Days	Sets the number of days before an event upto which a user may cancel their enrolment to a free event.
6.1.1	My Enrollments Sorting	The order in which the My Enrollments view is sorted.
6.1.1	My Enrollments Days Before	Sets the number of days before today for which enrollments will be displayed.
6.1.1	My Enrollments Days After	Sets the number of days after today for which enrollments will be displayed.
5.0.1	Select the User Fields to Display	Sets the permission level at which various user attributes are displayed in the enrolee list. Display Name allows click through to the user profile, where other information may be visible.
6.1.1	Select Emails To Send	Allows the administrator to selectively enable the emails that are sent as part of the enrolment process.

Moderation Settings

Version	Setting	Description
3.3.8	Moderate Event/Enrollment Changes	When enabled New or Changed events are moderated. Also enrollments to free events are moderate. Paid event enrollments are unmoderated. Moderation is accessed via the icon in the Icon Bar.

SubCalendars Settings

Version	Setting	Description
3.3.8	Include Other Site Event Modules	Enables the additon of other calendars to be displayed through this calendar. Only one level of sub-calendar is supported by the module.
3.3.8	Add Sub-Calendar Name	The sub-calendar name is added to the event name (e.g. Test Event (Sub-calendar)).
5.0.3	Enforce View Permissions	View permissions applied to the sub-calendar are applied to any events retrieved from that sub-calendar. (i.e. if a user does not have view rights to the sub-calendar, any events from that sub-calendar will not be displayed in the master calendar.
3.3.8	Add/Remove Sub-Calendars	Move calendars from the Available to the Selected lists to set them as a sub-calendar.

SEO Settings

Version	Setting	Description
5.2.0	Enable SEO	When enabled the page title and description of the Detail View are set using the relevant templates. Also the category and location are added to the page keyword list.
5.2.0	Description Length	Sets the maximum length of the page description.

Sitemap Settings

Look here for more details on this feature.

Version	Setting	Description
5.2.0	Enable Search Engine Sitemap	Enables sitemap for this module instance. To validate the sitemap is being populated correctly, go to Search Engine Sitemap in the Admin menu, clear the cache on that page, then click on the sitemap link at the top of the page.
5.2.0	Sitemap Priority	Sets the priority configured in the sitemap for each event.
5.2.0	Days Before	Sets the number of days before the current day to include in the Sitemap.
5.2.0	Days After	Sets the number of days after the current day to include in the Sitemap.

RSS Settings

Look here for more details on this feature.

Version	Setting	Description
5.0.1	Enable RSS	Enables the icon in the Icon Bar.
5.0.1	Date to Use	Sets the date to be used as the Publish Date in the RSS feed. Options are - Last Updated, Creation Date or Event Date.
5.0.1	Days to include	Specifies the number of days from today to include in the feed.
5.0.1	Feed Title	Sets the title of the feed.
5.0.1	Feed Description	Sets the description of the feed.

Calendar Export Settings

Look here for more details on this feature.

Version	Setting	Description
5.1.4	Owner Email Address Export	Includes the owner email address in the event export (.ics). If disabled a false email address is generated.
5.0.1	Owner Email for Unregistered User	Includes the owner email address in the event export (.ics) for unauthenticated users. If disabled a false email address is generated.
5.2.0	Show iCal icon on icon bar	Shows the iCal icon on the icon bar. Clicking this icon will generate a .ics file for all events in the module, subject to the filters below.
5.2.0	Enable Event .ics Emailing	Enables the emailing of a .ics file to a specified email address on the detail view. This is displayed near the reminder options, and is separate to the iCal export options shown at the bottom of the detail view.
6.0.0	Show URL in Location	When enabled the location url is included in the location field in the iCal export.
6.0.1	Include Calname in .ics	When enabled the attribute X-WR-Calname is included in the export which is used by Calendar applications to name the imported calendar.
5.2.0	Days Before	Sets the number of days before the current day to include in the iCal export.
5.2.0	Days After	Sets the number of days after the current day to include in the iCal export.
5.2.0	URL to append	Each event in the .ics file has a url element. Entering something in URL to append, adds it to the end of the url for the event. This can be used for supporting Google Analytics source and medium tags for instance.
5.2.0	Enable Default Image	By default the url to the event image (if any) is added in the Attach element in the .ics file. You can specify using this option what the default image is that should be output for events without an image. This is useful for facebook synchronisation where an image on an event makes it more visible.
5.2.0	iCal URL	In situations where you do not wish to display the iCal icon on the icon bar and cannot therefore easily identify the correct url to the module iCal feed, this shows the url. This url can be entered into the calendar synchronisation mechanisms of other calendars such as Google Calendar, Microsoft Outlook and Facebook (e.g. iCalendar to Event).

Social Integration Settings

Version	Setting	Description
6.1.1	Social Module	When set to 'Social Group' the module will suppoprt pages controlled by the Social Group module. When set to 'User Profile' the module will support placement on User Profile pages. Note that all settings will be common across all Social Groups or User Profiles.
5.2.0	Facebook Admins	Any text entered in here will be added to each event display page (Month/View/List/Day/Detail view) as a fb:admins meta property in the pages header.
5.2.0	Facebook App_ID	Any text entered in here will be added to each event display page (Month/View/List/Day/Detail view) as a fb:app_id meta property in the pages header.
6.1.1	Enable Journal Integration	Enables the recording of activities into the DNN core Journal. Activities currently recorded are event creation and user enrollment.

Template Settings

Version	Setting	Description
5.0.1	Event Template	Allows you to select the template to edit. Click 'Update Template' to update, and 'Reset Template' to reset. No need to click 'Update Settings' to save.