%META:TOPICINFO{author="ProjectContributor" date="1655468868" format="1.1" version="1"}%
%META:TOPICPARENT{name="AdminToolsCategory"}%
---+ RSS News Feeds

---++ Find out What's New

There are several ways to find out what's new in each web:
   1. Visit [[WebChanges]] to see recent changes
   1. Subscribe in [[WebNotify]] to get notified of recent changes by e-mail
   1. Use a news reader such as Foswiki:Extensions/HeadlinesPlugin to display the recent changes
      * The source can be an RSS 1.0 feed ([[WebRss]]) or ATOM 1.0 feed ([[WebAtom]])

---++ RSS Feed Usage

   * The URL for an RSS feed is =%SCRIPTURL{"view"}%/&lt;web&gt;/WebRss=
   * For this <nop>%WEB% web it is %SCRIPTURL{"view"}%/%WEB%/WebRss
   * You can also create a custom feed based on a search. Add a =search=value= parameter to the URL, e.g. %SCRIPTURL{"view"}%/%WEB%/WebRss?search=plugin is a what's new feed about Plugins.

---++ RSS Feed Internals

Each web has a [[WebRss]] topic which includes part of this <nop>%TOPIC% topic. This topic is the base for the RSS feed and generates an RSS 1.0 feed.

The [[WebRss]] topic in each web contains the following text:

-----
<pre>
&lt;channel rdf:about="%<nop>SCRIPTURL{"view"}%/%<nop>BASEWEB%">
  &lt;title>%<nop>WIKITOOLNAME%'s &lt;nop>%<nop>BASEWEB% web&lt;/title>
  &lt;link>%<nop>SCRIPTURL{"view"}%/%<nop>BASEWEB%&lt;/link>
  &lt;description>&lt;literal>%<nop>MAKETEXT{"The [_1] web of [_2]." args="<nop>%<nop>WEB%,<nop>%<nop>WIKITOOLNAME%"}% <nop>%<nop>WEBSUMMARY%&lt;/literal>&lt;/description>
%<nop>INCLUDE{"%SYSTEMWEB%.WebRssBase"}% &lt;!--
   * Set <nop>SKIN = rss
   * Set <nop>COVER = rss
-->
</pre>
-----
*Note:* The description is expanded from the %<nop>WEB%, %<nop>WIKITOOLNAME% and %<nop>WEBSUMMARY% macros.  These *must* expand to plain text with no links or html markup. &lt;literal> is used to avoid links if the web name or any of the macros expand to include WikiWords or other markup.

The part below is included by each <nop>WebRss topic:


-----
<verbatim class="tml">
%STARTINCLUDE%<image rdf:resource="%WIKILOGOIMG%" />
  <dc:language>en-us</dc:language>
  <dc:rights>%WEBRSSCOPYRIGHT%</dc:rights>
  <dc:publisher>%WIKIWEBMASTERNAME% [%WIKIWEBMASTER%]</dc:publisher>
  <dc:creator>The contributing authors of %WIKITOOLNAME%</dc:creator>
  <dc:source>%WIKITOOLNAME%</dc:source>
  <items>
    <rdf:Seq>
%SEARCH{
  "%URLPARAM{"search" encode="entities, quote" default=".*" }%"
  decode="entities"
  web="%URLPARAM{"web" encode="safe, quote" default="%BASEWEB%" }%"
  excludetopic="%URLPARAM{"excludetopic" encode="safe, quote" default="%STATISTICSTOPIC%" }%"
  type="%URLPARAM{"type" encode="safe, quote" default="regex" }%"
  nosearch="on"
  order="modified"
  reverse="on"
  nototal="on"
  limit="%URLPARAM{"limit" encode="safe, quote" default="16" }%"
  scope="%URLPARAM{"scope" encode="safe, quote" default="text" }%"
  casesensitive="%URLPARAM{"casesensitive" encode="safe, quote" default="on" }%"
  date="%URLPARAM{"date" encode="safe, quote" default="" }%"
  format="      <rdf:li rdf:resource=\"%SCRIPTURL{"view"}%/$web/$topic\" />"
 }%
    </rdf:Seq>
  </items>
</channel>
<image rdf:about="%WIKILOGOIMG%">
  <title>%WIKILOGOALT%.%BASEWEB%</title>
  <link>%SCRIPTURL{"view"}%/%BASEWEB%</link>
  <url>%WIKILOGOIMG%</url>
</image>
%SEARCH{
  "%URLPARAM{"search" encode="entities, quote" default=".*" }%"
  decode="entities"
  web="%URLPARAM{"web" encode="safe, quote" default="%BASEWEB%" }%"
  excludetopic="%URLPARAM{"excludetopic" encode="safe, quote" default="%STATISTICSTOPIC%" }%"
  type="%URLPARAM{"type" encode="safe, quote" default="regex" }%"
  nosearch="on"
  order="modified"
  reverse="on"
  nototal="on"
  limit="%URLPARAM{"limit" encode="safe, quote" default="16" }%"
  scope="%URLPARAM{"scope" encode="safe, quote" default="text" }%"
  casesensitive="%URLPARAM{"casesensitive" encode="safe, quote" default="on" }%"
  date="%URLPARAM{"date" encode="safe, quote" default="" }%"
  format="<item rdf:about=\"%SCRIPTURL{"view"}%/$web/$topic\">$n  <title>$topic</title>$n  <link>%SCRIPTURL{"view"}%/$web/$topic</link>$n  <description>$summary (last changed by <nop>$wikiname)</description>$n  <dc:date>$isodate</dc:date>$n  <dc:contributor>$n    <rdf:Description link=\"%SCRIPTURL{"view"}%?topic=$wikiusername\">$n      <rdf:value>$username</rdf:value>$n    </rdf:Description>$n  </dc:contributor>$n</item>"
}%
%STOPINCLUDE%
</verbatim>
-----

*See also*: [[WebAtomBase]]
%META:PREFERENCE{name="ALLOWTOPICVIEW" title="ALLOWTOPICVIEW" type="Set" value="*"}%
