%META:TOPICINFO{author="ProjectContributor" date="1447730097" format="1.1" version="1"}%
%META:TOPICPARENT{name="AdminToolsCategory"}%
---+ ATOM 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 a RSS 1.0 feed (WebRss) or ATOM 1.0 feed (WebAtom)

---++ ATOM Feed Usage

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

---++ ATOM Feed Internals

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

The WebAtom topic in each web contains the following text:

-----
<pre>
&lt;title>&lt;nop>%<nop>WIKITOOLNAME%'s &lt;nop>%<nop>BASEWEB% web&lt;/title>
&lt;subtitle>&lt;literal>%MAKETEXT{"The [_1] web of [_2]." args="<nop>%<nop>WEB%,<nop>%<nop>WIKITOOLNAME%"}% <nop>%<nop>WEBSUMMARY%&lt;/literal>&lt;/subtitle>
%<nop>INCLUDE{"%<nop>SYSTEMWEB%.WebAtomBase"}% &lt;!--
   * Set <nop>SKIN = rssatom
   * Set <nop>COVER = rssatom
--&gt;
</pre>
-----
*Note:* The subtitle 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.

Below part is included by each <nop>WebAtom topic:

-----
<verbatim>
%STARTINCLUDE%<link rel="self" type="application/atom+xml" href="%SCRIPTURL{"view"}%/%BASEWEB%/%BASETOPIC%"/>
<id>%SCRIPTURL{"view"}%/%BASEWEB%</id>
<rights>%WEBRSSCOPYRIGHT%</rights>%CALC{$SET(c,0)}%
%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="$percentCALC{$IF($GET(c)>0, , <updated>$isodate</updated>$CHAR(10))$SETM(c, +1)}$percent<entry>$n <title>$topic</title>$n <link rel=\"alternate\" type=\"text/html\" href=\"%SCRIPTURL{"view"}%/$web/$topic?t=$isodate\"/>$n <id>%SCRIPTURL{"view"}%/$web/$topic</id>$n <updated>$isodate</updated>$n <summary>$summary (last changed by <nop>$wikiname)</summary>$n <author>$n  <name><nop>$wikiname</name></author>$n</entry>"
}%
%STOPINCLUDE%
</verbatim>
-----

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