Skip to main content

Information for Developers

PlanIt Purple provides a variety of ways to export data to external systems, including iCal, JSON, and XML feeds. Web Communications recommends caching event data outside PlanIt Purple, syncing it no more frequently than every hour and no more than every 4-6 hours if using Cascade.

If you are using the Cascade Web Content Management System, an XML feed is the easiest way to include PlanIt Purple events in your site. There are two ways to create a feed:

  1. Click the "Add/Manage Events" button from the PlanIt Purple homepage, sign in, then click "Add a Feed."
  2. Construct a URL of the following format:

The following are valid querystring parameters for the second method:

Parameter Description
cal Required. Can be a comma-separated list of multiple group IDs.
days Required. Can be 0 for unlimited.
max Optional. An integer value specifying the maxiumum number of events to be included.
archive Optional. Valid values are 0 for the default setting of not displaying past events or 1 for including past events for the past 3 years. Overrides start parameter. Past events not constrained by days parameter.
start Optional. Must be a valid date in the format mm-dd-yyyy. Specifies a start date to filter out events before a certain point.
end Optional. Must be a valid date in the format mm-dd-yyyy. Specifies an end date to filter out events after a certain point.
token Required alphanumeric access code for private groups (displayed on the Edit Group page). Can be comma-separated if there are multiple values for cal using an empty string for non-private groups.

XML feeds contain the following elements:

For examples of XSLT formats that can handle these fields, please contact Web Communications.

Updated May 16, 2016