RSS Feed Items

Overview

Feed items are the individual pages or articles that comprise an RSS feed. Feed items can be added to an RSS feed that has been created and assigned to a page or directory by a level 10 administrator. For more information on how to create an RSS feed, please visit the RSS Feeds page.

The RSS Feed Items view provides a list view of all feed items in the currently selected feed. This view can be accessed from the following locations:

  • For an individual page's associated RSS items, go to Content > Pages > Edit > RSS (The file must be checked out for RSS to be visible)

    RSS from the Pages List View
  • Or, from the Page Actions toolbar, click Properties > RSS (Remember to check out the page first!)

    Accessing RSS from the Page Actions Toolbar

  • For an RSS feed's associated items, go to Content > RSS (After clicking RSS, hover over the target feed’s row and select Items)

    RSS Items in RSS Feeds list view

Users have the ability to perform these actions from the RSS Items view, which contains the following functionality:

  • Shows the number of feed items for the entire feed
  • Feed items can be created or edited
  • Feed items can be selected and deleted individually or in bulk
  • The list can be filtered
  • The RSS feed for the items can be published
  • The RSS feed can be published to an alternative publish target, if Multi-Target Publish is in use

Creating RSS Items

After RSS feeds have been created, RSS items may be associated with a feed in one of two ways: they can be created automatically with an RSS-specific page template or created from an existing page. While the former is recommended as a best practice, not all implementations will include this kind of template.

Creating an Item with a New Page Template

If an RSS-type page template is available and is being used to create a new page, an RSS item will be created during page creation. Page templates can be specific to a directory. A user would need to have appropriate permissions to the News directory (for example). To create a new RSS feed item using a page template:

  1. Navigate to the Pages list view by selecting Content or Content > Pages from the global navigation bar.
  2. In the Pages list view, navigate to the target directory in which the new page will be created and click New.
  3. In the Select New Content view, choose either the News Article Page or the designated RSS template.

    Create New RSS Article
  4. Fill out all the necessary fields. The options available are similar to those when using other templates for page creation. Options specific to RSS Templates might include adding a teaser image, an article image, and a thumbnail image for the RSS item.
  5. Choose the appropriate RSS Feed from the drop-down menu to add the feed item to.

Choosing an RSS Feed

After a page has been created with an RSS template, it will appear as a feed item for the RSS feed that it was assigned to.

Creating an Item from an Existing Page

If the RSS feed item is not automatically configured using the RSS template, it can be added to an existing page. The page or directory to which the page belongs must be given access by a level 10 administrator to an RSS feed prior to being able to add items.

To give a page or directory access to an RSS feed:

  1. Navigate to the directory in question by clicking on Content > Pages from the global navigation bar.
  2. Hover over the directory in the Pages list view and click Access from the Edit drop-down menu.

    Changing Access Settings for a Directory
  3. Under Recursive Modification, choose whether the settings will apply to this directory only (meaning that pages currently within the directory will still have to be manually associated with the RSS feed in question) or all subdirectories and files currently within the directory.
  4. In the RSS Feed drop-down menu, select the feed that RSS items created within this directory will be associated with.

    Directory Access Settings for RSS
  5. Click Save.

To give individual pages access to an RSS feed, navigate to the page in question and click on Edit > Access, then choose the RSS feed that items will be associated with.

In order to add an RSS item to an existing page:

  1. Navigate to the page in question through the Content > Pages list view.
  2. Check out the page and hover over its row in the list view, and from the Edit menu select RSS. Users will be taken to the RSS Items page.

    Selecting RSS from the Pages List View
  3. On the RSS Items page, click New.

    New RSS Item
  4. Add a Title.
  5. Add a Description.
  6. For the Link field, the default of [auto] can be used so that the current associated page is the link.
  7. The AuthorPublish Date, and Publish Time can be left at the defaults or modified. When left at [auto], the publish date and time will be the date and time at which the RSS item is published.
  8. See below for adding Media Content.
  9. Use the Extra XML field to define additional XML nodes to be included in this article's RSS information. XML information should be entered in the form of <node>data</node> A developer might use the node to supplement XSL processing, for example, to parse the feed onto a page based on the passed value.
  10. Click Save when finished.
  11. Publish the page. New RSS items will not be added to an RSS feed until the page containing the item has been published.

The feed item will now appear in the RSS Items view for the selected RSS Feed. To update the XML file for the feed and publish it to the production server, the feed should be rebuilt. If the page content is changed, then the page should be published. Publishing the page publishes the feed.

Adding Multiple Items on One Page

More than one item can be associated with a page by changing the RSS Feed access settings of the page and creating a new item. For example, an item for a page has already been created for the /weather.xml feed, but a user would like for that page to have an item sent to the /news.xml feed. The user would go to the page access settings, change the RSS Feed field to /rss/news.xml, and then create a new RSS item as described above.

Adding Media Content

Once a feed item is added or has been created with the media RSS template, it can be edited to add media content. Media content such as images, video, and PDFs can be added. When users add media content to their RSS feed item, the New Media Content modal is displayed which includes the following:

  • Title: Provides a user-friendly name that helps users identify the content. This is required; without a title, the media item will not display.
  • Description: Provides an area to add the descriptive text about the media content.
  • Keywords: Allows users to create keywords 
  • File: The file name and path can be entered manually or the file chooser can be used to select a file. An auxiliary site can be selected using the drop-down.
  • Thumbnail: Users select the thumbnail image for the content from a file navigation tree inside the dialog. An auxiliary site can be selected using the drop-down.

The Media RSS specification allows for linking to media. The link is to a file that should be uploaded to the production server before linking to it from the RSS feed item.

Media RSS is compatible with any media content, so long as that content may be reached from a valid URL. This includes Flash, DIVX, Quicktime, Windows Media, Real Player, WAV, MP3, podcasts, and other types of media. Depending upon the feed reader, the item may include a link to the image or PDF. Once the page is published, the item is added to the feed identified in the access settings. Media content can be edited by clicking the linked media item or deleted by clicking on the trash icon.

To add media content to an RSS item:

  1. Navigate to the item by clicking Edit > RSS in the Content > Pages list view.
  2. In the Item Properties panel, click Add.

    Add Media Content

  3. Enter a Title (required), a Description and Keywords as necessary.
  4. Enter the path and file name for the File field, or use the file chooser to select media.
  5. Specify a file for the Thumbnail for the item (optional).
  6. When finished, click Save.

Deleting an RSS Feed Item

Deleting an RSS item from a feed requires the user to republish the feed for the changes to take effect on the site, otherwise users may experience broken links. To delete an RSS item:

  1. Navigate to the Pages list view by selecting Content or Content > Pages from the global navigation bar.
  2. Hover, and from the Edit menu select RSS.
  3. Hover and select Delete.
  4. In the Delete RSS Item dialog, click Delete

Rebuilding a Feed

To ensure the feed on the production server is up to date, the feed can be published to rebuild it after adding, updating, importing, or deleting items. Level 7 users and higher can use Publish to publish the XML file for the feed to the production server. User level 6 and lower will need to request that an administrator publish the feed. Rebuilding an RSS feed is required when RSS items have been created, edited, or deleted. To rebuild a feed:

  1. Navigate to the RSS Items view for the target RSS feed.
  2. Click Rebuild Feed.
  3. In the Publish Feed dialog, if necessary select a Publish Target from the drop-down menu
  4. Click Publish.

Importing a Feed

Items from an existing RSS feed can be imported to another feed in OU Campus.

  1. Navigate to the RSS Items view from the folder structure or from the Properties menu.
  2. Click Import.
  3. Enter the URL of the feed from which the items are being imported into the box. That will import the feed items listed at a particular page.

    Import RSS Feed Items

  4. Click Import. After importing the items, the items can also be edited. Additionally, if the item should point to a different link than the one defined in the import, this too can be updated.
  5. Click Publish and Rebuild Feed to rebuild the feed. This writes the XML file to the production server.

RSS Templates

Most implementations by default include two templates that allow users to automatically create RSS items when a page is created. For more information on these RSS templates, please refer to the RSS TCF Reference page.