Article Feed : /article/feed

See Also: wiki:PLoSRESTDevGuide?, #413

cgi Parameters

  • startDate (default is today - 3 months) - Format is "MMM DD hh:mm:ss PDT YYYY" where MMM is a 3-digit month
    • To get all articles since the beginning of time, include startDate, but set it to an empty string. For example, "startDate=".
  • endDate
  • category - If set, the category to get the feed for (also changes the feed's title)
  • author - If set, the author to get the feed for (also changes the feed's title)
  • maxResults (default -1) - If set, the maximum number of results to return
  • representation - Unused?
  • relativeLinks (default false) - If relativeLinks=true is present, internal links will be relative to xmlbase
  • extended (default false) - If extended=true is present, see Extended Feed below.
  • title - If present, this string will be the title of the returned feed
    • By default, titles are prefixed with "PLoS ONE" and then any category is appended to it. Title can be manually set with the title parameter.
  • selfLink - This is the URL to the feed that is put in the feed. If the feed is to be pulled and then statically hosted elsewhere, this should be the URL of the static URL.

Extended Feed

The extended feed is meant to provide additional information that standard feed readers might not like. Currently the extended feed provides:

  • Multiple authors per entry
  • Volume
  • Issue
  • Subject Categories

There is a <link> to the main feed in the <head> section global template.

Browse by subject pages have an additional <link> to the respective subject feed.

By default these URLs use the /article/feed/ URL. However they can be reconfigured on plosone.xml to point elsewhere: 

<pub>
<feed>
      <basePath>/rss/</basePath>              <!-- Path to rss feeds after journal context -->
      <defaultFile>PLoSONE.xml</defaultFile>  <!-- Default rss feed if none other specified -->
      <categoryPrefix></categoryPrefix>       <!-- File prefix for a specific category --> 
</feed>
</pub>