RSS Feeds

If you just want a quick and dirty reference of RSS customization parameters, see RSS Quick Reference.

RSS technology provides a standard way for web sites to share content with other web sites and applications. For general information about RSS, see Wikipedia.

Every EditMe site includes a flexible RSS feed that can provide a number of different types of information about the site. In its simplest form, it returns the site's Recent Changes. The RSS feed can be reached at the following address. Replace YOURSITE with the name of your EditMe site.

RSS URL: http://YOURSITE.editme.com/rss.xml

Passing Parameters

The RSS feed is customized using various parameters passed to the rss.xml address. These are called query string parameters, and are formatted like this:

/rss.xml?param1=value1&param2=value2

Note that the first parameter is preceded with ? and subsequent name/value pairs are separated with a &.

RSS Security Considerations

EditMe's RSS feed is aware of your site's permissions and will not share information about pages with users who would not be able to view those pages on your site. When you visit the URL above from your browser, the RSS feed will use whatever login state your browser already has. But most requests to your site's RSS feed will not be from browsers already logged into the site, meaning the permissions will be set to the default (not logged in) state.

You can pass user credentials to the feed using login and password attributes:

Login Credentials: http://YOURSITE.editme.com/rss.xml?login=admin&password=test

Available Feeds

EditMe's RSS can provide several different feeds:

• Recent Changes - the default.
  http://YOURSITE.editme.com/rss.xml    

• User Changes - recent changes by a specific user.
  http://YOURSITE.editme.com/rss.xml?feed=user&user=admin     

• Page Changes - recent changes to a specified page.
  http://YOURSITE.editme.com/rss.xml?page=Home    

• Comments - comments posted to the site, a specific page, or by a specific user.
  http://YOURSITE.editme.com/rss.xml?feed=comments
  http://YOURSITE.editme.com/rss.xml?feed=comments&page=Home
  http://YOURSITE.editme.com/rss.xml?feed=comments&user=admin     

• Page Dates - includes arbitrary pages based on the Page Date value set on the Properties tab of the editing screen. Can be limited to a specified Parent page, useful for Blog feeds.
  http://YOURSITE.editme.com/rss.xml?feed=date
  http://YOURSITE.editme.com/rss.xml?feed=date&parent=MyBlog

Common Customization Parameters

The following parameters apply to most or all of the different feeds.

• Limit the number of items returned.
  http://YOURSITE.editme.com/rss.xml?limit=10    

• Limit the number of days to include in recent changes. The current maximum is 90.
  http://YOURSITE.editme.com/rss.xml?days=30      

• Include full page content, the Excerpt value, the Change Description or no content at all.
  http://YOURSITE.editme.com/rss.xml?content=full
  http://YOURSITE.editme.com/rss.xml?content=excerpt
  http://YOURSITE.editme.com/rss.xml?content=description
  http://YOURSITE.editme.com/rss.xml?content=none      

• Limit results to a specific page. This works for the recent, user and comments feeds:
  http://YOURSITE.editme.com/rss.xml?page=Home    

• Include a link to the Diff report for this change (recent changes and user feeds only)
  http://YOURSITE.editme.com/rss.xml?diff=link

See RSS Quick Reference for a reference table showing all available options and the default values for each feed type.