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 settings.gif on the Icon bar. In version 6.0.0 the icon has changed to this one EditTab_16X16_Standard.png. 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 Settings

General Settings.png
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

Look and Feel Settings.png
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 (cal-month.gif cal-week.gif cal-list.gif) 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

Timezone Settings.png
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

Detail View Settings.png
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 view.gif 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 cal-month.gif

Month View Settings.png
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 - HighPrio.gif LowPrio.gif. Recurrence - Rec.gif. Enrollments - enroll.gif enrollfull.gif. Reminders - Bell.gif


Week View Settings cal-week.gif

Week View Settings.png
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 - HighPrio.gif LowPrio.gif. Recurrence - Rec.gif. Enrollments - enroll.gif enrollfull.gif. Reminders - Bell.gif


List (& Day) View Settings cal-list.gif

List View Settings.png
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 - HighPrio.gif LowPrio.gif. Recurrence - Rec.gif. Enrollments - enroll.gif enrollfull.gif. Reminders - Bell.gif
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

Custom Fields Settings.png
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

Tooltip Settings.png
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

Image Settings.png
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 Email_16X16_Standard.png

Event Email Settings.png
Version Setting Description
5.1.4 Send New Event Emails Never - No new event emails are sent. Subscribers - the 'Notify Me' checkbox (false.gif true.gif) 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 bell.gif

Reminder Settings.png
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 cal-enroll.gif

Enrollment Settings.png
Version Setting Description
3.3.8 Permit Event Enrollment Enable enrollment settings in Edit view. The cal-enroll.gif 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 moderate.gif

Moderation Settings.png
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 moderate.gif icon in the Icon Bar.


SubCalendars Settings

SubCalendars Settings.png
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

SEO Settings.png
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

Sitemap Settings.png
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 rss.gif

RSS Settings.png
Look here for more details on this feature.

Version Setting Description
5.0.1 Enable RSS Enables the rss.gif 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 iCal.gif

Calendar Export Settings.png
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 Facebook.png

Social Integration Settings.png
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.
6.1.2 Private User Calendar When the module is place on the User Profile page and the Social Module setting configured to 'User Profile' then the module can be configured for the user events to be visible only to the individual user or public to anyone visiting the usersprofile. Enable this setting for the events to be private to the individual user.
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

Template Settings.png
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.

Last edited Jun 14, 2013 at 3:33 PM by RogerSelwyn, version 92

Comments

tescom Jan 15, 2016 at 9:13 PM 
It's a few years back when you start developing this module. In the mean while is there a language option ?

asosa2000 Sep 1, 2013 at 7:17 PM 
can i enable multi language in event module, or can i add column and hid column?

RogerSelwyn Apr 11, 2013 at 3:40 PM 
Sorry, I don't get notifications when people post here.

@seklein - there is currently no built in method, but it is possible to do this using SQL exports and imports with some manipulation

@modulopedia - you are free to download the source from the downloads page,

modulopedia Mar 19, 2013 at 1:14 AM 
Any chance of getting a basic code template to add an event to a calendar? I need to make a simple add event form without all the complexity for the user

seklein Feb 4, 2013 at 9:45 PM 
How can I export the contents of an Events module from one DNN5 install to use in a new DNN7install?

RogerSelwyn Jan 27, 2013 at 8:56 AM 
It is not possible to change the order of the fields displayed in Event List Settings. If you want more flexibility of styling either use the Template for the Description field, or use the Repeater view which is fully templateable.

MinalVithalani Jan 14, 2013 at 8:55 AM 
How to change the order of Events Fields to Display in Event List Settings?

kconroy Jun 15, 2012 at 7:07 PM 
Is there a setting to have a maximum number of attendees for an event?

imran_2020 May 17, 2012 at 5:22 AM 
why Event List Settings is not here