Community Integration: Format of RSS and Atom feeds

As a Campus Cloud administrator, you may be asked to troubleshoot integrated community feeds, such as by following the steps in this FAQ:

This article tells you how to format a feed for a community integration. There are specific formats for (1) RSS feeds and (2) ATOM feeds. 

1. RSS

<?​xml version=​"1.0"​ encoding=​"UTF-8"​?> <​rss​​xmlns:atom​=​"http://www.w3.org/2005/Atom"xmlns:content​=​"http://purl.org/rss/1.0/modules/content/"​​version​=​"2.0"​> <​channel​> <​title​>My Integrated RSS feed</​title​> <​link​>http://example.com/test.atom</​link​> <​description​>feed description</​description​> <​atom:link​​href​=​"http://example.com/test.atom"​​rel​=​"self"​ /> <​lastBuildDate​>Tue, 16 Apr 2019 14:45:15 +0000</​lastBuildDate​> <​item​> <​title​>Description</​title​> <​guid​​​>65c96b7f-a410-4494-b840-d5b82a5d2907</​guid​> <​pubDate​>Tue, 16 Apr 2019 10:45:15 +0000</​pubDate​> </​item​> ... </​channel​> </​rss​>

 

Each <item> tag in the feed must contain the following:

  • <title> string

  • <guid> string | number. Can be replaced by <id>

  • <pubDate> Datetime. Can be replaced by <start_date>, <startDate>, <start>, <startdate>, <pubdate>, <published>

Notes:

  • Please make sure that the GUID key is unique for each event. The GUID key is a combination of the event host, feed URL, and GUID.

  • If more than one datetime tag is present, we use the first and ignore the others. 

  • We do not use the <description> tag within an <item>. We use title, but if there is text in the description field, that text will be ignored. 

2. ATOM

<?xml version="1.0" encoding="UTF-8"?> <feed xmlns="http://www.w3.org/2005/Atom" xml:lang="en"> <id>2fff5f8a-39b9-4d7b-b102-28d53b28e0a2</id> <title>My Integrated Atom feed</title> <updated>2019-04-16T14:45:15.475012+00:00</updated> <link href="http://example.com" rel="alternate"/> <link href="http://example.com/test.atom" rel="self"/> <subtitle>A Sample Description</subtitle> <entry> <id>65c96b7f-a410-4494-b840-d5b82a5d2907</id> <title>A message that will appear in the campus app.</title> <published>2019-04-16T10:45:15.475106+00:00</published> </entry> </feed>

Each ​<​entry​>​ tag in the feed must contain the following:

  • ​<​title​>​ String | Number

  • <​id​>​ String | Number. Can be replaced by <​guid​>

  • <​published​>​ Datetime. Can be replaced by <​start_date​>, <​startDate​>, <​start​>, <startdate>,<​pubdate​> or <​published​>

Notes: 

  • If more than one datetime tag is present, we use the first and ignore the others.

  • We do not use the <description> tag within an <item>. We use title, but if there is text in the description field, that text will be ignored. 

  • The feeds sync once an hour.

  • The content of the message is truncated at 1,024 characters (this includes mark-up for links, which will display as clickable URL's if they fall within this limit).