Tagging and Filtering

As of version 0.6, WikiArticleFeeds supports tagging by way of either the <itemTags> tag or {{itemTags}} parser function.

To tag a feed item, insert either the <itemTags> tag, or the a call to the {{itemTags}} parser function somewhere between the opening header of the item (== Item Title ==) and the header of the next item.

For example, to mark an item about dogs and cats, you could do any of the following:

<itemTags>dogs, cats</itemTags>
{{#itemTags:dogs, cats}}
{{#itemTags:dogs|cats}}

Tagging an item does nothing to the finished page itself other than add an HTML comment indicating the tag. Also, it will not affect the feed directly as this does not inject real actual RSS or Atom categories.

However, once you've tagged items, you can filter a feed by the item tags. For example consider the following URL:

https://jimbojw.com/wiki/index.php?title=Blog&action=feed

This will generate a feed from the page called [[Blog]], containing all items therein. Now consider this variant:

https://jimbojw.com/wiki/index.php?title=Blog&action=feed&tags=mediawiki

This will also generate a feed, but it will only contain items which have been tagged as 'mediawiki' articles.

Mixed Level Headings

Having a mix of level headings is ok, but only the sections highest level heading (lowest number) will be considered feed items:

<startFeed />
=== More Rain ===
Nope. Today it was rainy, again. Blah.

==== This is not a new Item ====
This text and the preceding heading both belong to the "More Rain" item.

=== Not Sunny Today ===
Not quite rainy, just foggy, maybe it'll get better?
<endFeed />

Attribution

A single instance of the default signature gives credit to the author of an item: "~~~~" when you edit the MediaWiki page and when the feed is rendered. WikiArticleFeeds is smart enough to detect it as a declaration of the Author and Date.

Although attribution is not required, you are strongly recommended to follow this convention. Externally, it aids the reader of the feed by providing more meta-data about the item. Internally, it permits aggregation to operate more smoothly (see next section).

Aggregation

WikiArticleFeeds can combine or aggregate feeds. For example, consider the following wiki markup:

<startFeed />
=== More Rain ===
Nope. Today it was rainy, again. Blah. --[[User:Anon|Anon]] 08:42, 4 December 2006 (MST)
<endFeed />

...

<startFeed />
=== Not Sunny Today ===
Not quite rainy, just foggy, maybe it'll get better? --[[User:Anon|Anon]] 09:56, 3 December 2006 (MST)
<endFeed />

When this page is converted into a single feed, both the "Not Sunny Today" and "More Rain" items will appear, in reverse chronological order (newest first) and permits the pulling together of feeds on separate pages via MediaWiki Template notation (also sometimes referred to as Transclusion).

For example, consider the following three articles:

Rainy Feed

<startFeed />
=== More Rain ===
Nope. Today it was rainy, again. Blah. --[[User:Anon|Anon]] 08:42, 4 December 2006 (MST)

=== Not Sunny Today ===
Not quite rainy, just foggy, maybe it'll get better? --[[User:Anon|Anon]] 09:56, 3 December 2006 (MST)
<endFeed />

Sunshiny Feed

<startFeed />
=== More Sunshiny ===
Just another beautiful day. --[[User:Anon|Anon]] 06:37, 18 August 2006 (MST)

=== Hoping for more Sun ===
Hope it's nice out tomorrow, too cloudy today ... --[[User:Anon|Anon]] 10:08, 14 August 2006 (MST)
<endFeed />

Aggregate Feed

== Rainy Feed ==
Contents of the Rainy Feed:
{{:Rainy Feed}}

== Sunshiny Feed ==
Contents of the Sunshiny Feed ==
{{:Sunshiny Feed}}

Rendering the article "Aggregate Feed" as a feed will result in a combination of all items in both "Rainy Feed" and "Sunshiny Feed".

Automatic Linking

There are two options for automatically creating the feed's link URL. First, if there are no URLs, or the only URLs in the feed text itself are part of the attribution, then the feed URL will be simply a link to the item in the page.

So for example, in this feed the feed item URL

== Some Item ==
Some blog text. --[[User:Anon|Anon]] 10:08, 14 August 2006 (MST)

will become a link to [[#Some Item]].

The other method of auto-linking is based on non-attribution links, wherein the first non-attribution link found in the feed text becomes the feed item URL as in

== Some Item ==
Checkout my new [[Main Page]] - it's great, and check also the [[Announcements]]). --[[User:Anon|Anon]] 10:08, 14 August 2006 (MST)

where the feed item URL will become link to [[Main Page]].