ATOM News Feeds

Find out What's New

There are several ways to find out what's new in each web:

1. Visit Web Changes to see recent changes
2. Subscribe in Web Notify to get notified of recent changes by e-mail
3. Use a news reader such as Foswiki:Extensions/HeadlinesPlugin to display the recent changes
   • The source can be a RSS 1.0 feed (Web Rss) or ATOM 1.0 feed (Web Atom)

ATOM Feed Usage

• The URL for an Atom feed is https://the-data-mine.co.uk/<web>/WebAtom
• For this System web it is https://the-data-mine.co.uk/System/WebAtom
• You can also create a custom feed based on a search. Add a search=value parameter to the URL, e.g. https://the-data-mine.co.uk/System/WebAtom?search=plugin is a what's new feed about Plugins.

ATOM Feed Internals

Each web has a Web Atom topic which includes part of this WebAtomBase topic. This topic is the base for the ATOM feed and generates an Web Atom 1.0 feed.

The Web Atom topic in each web contains the following text:

---

<title><nop>%WIKITOOLNAME%'s <nop>%BASEWEB% web</title>
<subtitle><literal>The %WEB% web of %WIKITOOLNAME%. %WEBSUMMARY%</literal></subtitle>
%INCLUDE{"%SYSTEMWEB%.WebAtomBase"}% <!--
   * Set SKIN = rssatom
   * Set COVER = rssatom
-->

---

Note: The subtitle is expanded from the %WEB%, %WIKITOOLNAME% and %WEBSUMMARY% macros. These must expand to plain text with no links or html markup. <literal> is used to avoid links if the web name or any of the macros expand to include Wiki Words or other markup.

Below part is included by each WebAtom topic:

---

%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%

---

See also: Web Rss Base