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"?>
<rssxmlns: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:linkhref="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).