Calendar

Overview

The Calendar web part provides a responsive, accessible calendar with two views (Month and List/Agenda) to display calendar events from a SharePoint calendar list. This web part supports events, all-day events, multi-day events, & recurring events and can display an unlimited amount of additional columns in the Event Details dialogue.

Requirements

• Oregon Starter Template 4.9+
• JavaScript must be enabled
• Browser must meet the statewide minimum requirements
• SharePoint Calendar list type (Custom lists are not supported)

Accessibility

This web part passes both WCAG 2.0 and Section 508 website standards. The calendar view is a properly structured HTML table with Table headings. Each event is marked up in an unordered list, and multi-day events (while displayed as s spanned event), are broken out by occurrence in each daily listing as a list item.

Features & Functionality

• Select a source Calendar list (which uses the SharePoint Calendar list type)
• Two display types: Month and List (Agenda)
• Fully accessible for screen readers and keyboard access
• Supports:
• Events (<= 24 hours)
• All-Day Events
• Multi-Day Events
• Recurring Events
• Event Details modal dialog
• File Attachment support (enabled File Attachments in your Calendar list's Advanced settings)

Tutorials

Create a Calendar list

1. While logged in to your site, and on the subsite you wish to create a new list, select the cog menu in the upper right > add an app
2. Select Calendar under the heading Apps you can add
3. Name your Calendar
4. Add events as necessary

Add the Calendar web part

1. Visit the page where you wish to add a Calendar web part
2. Edit Page
3. Insert the Calendar web part in the appropriate location of the page using the Insert menu in the Ribbon (Insert > Web Part > Oregon (Category) > Calendar.
4. Open the web part’s properties, and select a Calendar list as the List's data source
5. Select the correct View
6. Select the column to be used to describe the Location
7. Select all columns which should be visible to visitors as the Description (hold Ctrl or Cmd to select more than one option)
8. Select OK
9. Publish the Page

Known Limitations

• Calendar list type must be used (Custom lists are not supported)
• Limited to two display types
• Limited to a single SharePoint as a data source (Socrata is on the way)

Common Questions

List of common questions and answers about this web part

Question

Answer

Do I have to use the Description column? I can't create links in it! :/

No. You can add as many additional columns to your Calendar list as you require, including types which support HTML (e.g. Multiple Lines of Text). To do so: Create a new column in your Calendar list which utilizes the Multiple Lines of Text type and its Enhanced rich text subtype. Once it's created and available in your list, add it to your View(s) and order it appropriately. In your web part properties (not your list settings), select your new column as one of the Description columns (and consider de-selecting the Description column).

Frameworks/Libraries Dependencies

• jQuery 3.x
• Bootstrap 3.x
• FullCalendar.io

Screenshots

Fig.1 Calendar View

Fig.2 List/Agenda View

Fig.3 Event Details

Report a Bug or Request a Feature

To report bugs and request features, please contact the E-Government Service Desk.

Still have questions?  

You can:

• Search the Knowledge Base for what you are looking for: 

• You can find more articles in the V4.x Article Index
• You can submit a question to the Oregon E-Government Service Desk