Setting Up a Feed from the Events@Duke Calendar

Duke's online event calendar, Events@Duke, offers a comprehensive listing of Duke events, including lectures, conferences, performing arts, exhibitions, cultural activities and more. Duke organizations are encouraged to use the calendar as their primary source for entering events. Groups can then "pull" events from the calendar for publication on their own public Web sites using the available feeds. Events@Duke uses Bedework software, developed by RPI.

If you need assistance obtaining or consuming feeds out of Events@Duke, contact the OIT Service Desk.

Types of feeds

 There are two types of feeds available from Events@Duke:

  • RSS - RSS data feeds conform to the RSS 2.0 specification. These feeds do not show any events that are marked with the category local. The feeds can be filtered by a single group and one or many categories.
  • XML - XML data feeds have a custom schema. These feeds are the only way to view a group's events that are marked with the category local. XML data feeds can be requested for one or many groups in a single request.

Note: OIT has developed sample PHP and JavaScript code snippets for departments to use when consuming XML feeds out of the calendar.

The URL Builder can help you construct the correct feed to suit your needs.

Each feed type has a particular strength or feature that makes it unique. The choice of data feed is up to the user and is dependent on the required use case.

Each feed type accepts certain parameters that "tell" Events@Duke how to format the requested feed. Because Events@Duke has sensible defaults for all feeds, many of the parameters are optional. If Events@Duke does not understand a passed parameter, it will use the parameter's default value instead. Read more about feed types and parameters.

Feed styles

Events@Duke offers two styles of data feeds. Both are available for RSS and XML data feeds. See examples of both feed styles using RSS and XML.

  • Calendar style - Calendar style feeds are defined by specifying a view period: day view, week view, and month view. Data feeds requested in calendar style will contain events for the current day, week, or month unless the user specifies an optional date parameter. If the date parameter is used, the calendar style feed will contain events for the day, week, or month that contains the requested date. Events that span multiple days will appear on each day requested in the feed that falls within the range of the date span of the event. Calendar style data feeds can be filtered exactly like the they can be on Events@Duke.
  • List style - List style feeds are defined by specifying a date range and/or a number of days. Data feeds requested in list style will contain an aggregated list of events from date range or number of days specified. Users can use both a date range and a number of days to retrieve a very specific list of events. Read about Bedework's list style data feeds.

Known limitations

Before you request a feed via your browser, clear the browser's cookies and session. If you do not, Events@Duke will apply any filters you clicked during your last visit to Events@Duke (for example, a group or category). You can override filter settings in the feed request URL, but if you omit any filters in the URL, the system will apply the filters from your last session.

Safari is not compatible with Events@Duke RSS feeds.