History: Feeds

            ! {icon name="rss"} News Feeds
{DIV(class="row")}{DIV(class="col-sm-9")}{DIV(class="lead")}A web feed is a summary of a website's news, new files, and other activities that it distributes or "syndicates" to other websites and individual users. Tiki is very flexible regarding feeds. It can both display external feeds from other sites in user modules and elsewhere and syndicate its own activities (blogs, articles, forums, etc.) via feeds.{DIV}{DIV}{DIV(class="col-sm-3")}^::Related Topics::
*((External Feeds))
*((dev:Administration|Bugs and Wishes))^{DIV}{DIV}

RSS, an acronym for "Really Simple Syndication", is a nearly painless way to syndicate news and articles from one site to many. 

The configuration of internal feeds (information created by the Tiki site) is explained in this page, and the configuration of external feeds is explained in ((Feeds User)).

;__Overview__: Use this page to configure the feeds generated by Tiki. By default, Tiki adds an RSS link for each feed in the footer: .
;__To access__: Click the __Feeds__ icon {icon name="rss"} on the ((Admin Panels|Admin Panel))  or Access __http://example.org/tiki-admin.php?page=rss__ 
;__Tabs__: This page contains the following tabs:{toc}
;__Note__: To syndicate feeds from other sites, use the __Admin > External Feeds__ menu option. 

!! Key Function and sub-features
Tiki has feeds for
* ((Articles))
* ((Blog))
* ((Directory))
* ((File Gallery))
* ((Forums))
* ((Image gallery))
* ((Map))
* ((Using wiki pages|Wiki pages))
* ((Calendar))
* ((Trackers))

You can find the feeds at the bottom bar (if it is switched on in admin menu):

::{img src=http://tikiwiki.org/img/wiki_up//rsslinks.png}::

You can click on any of those RSS icons ({img src=img/rss.png link=http://doc.tiki.org/tiki-wiki_rss.php?ver=2}) at the bottom of the page in order to get the syndicated content from that Tiki section. Copy that URL and paste it in your favourite feed aggregator, email program, web site (provided they support collecting RSS feeds).

!!Setting up feeds
^Creating Feeds^
Tiki is set up to generate feeds from Blog, Image galleries, File galleries, the Calendar, Articles, Forums... -and more. To turn on the feature click Admin so you get the page with the little icons and choose the RSS icon. "Enable" the features you want to feed to the world. Save it and a little RSS icon will appear for users on pages where a feed is available.

Keep in mind that "outgoing" feeds of your own Tiki blogs, calendar, image and file galleries and articles ''can also be displayed within your own Tiki!''(See Below for instructions.) This is a handy way to summarize content from one part of your site in another. I use it for file downloads where I've set up a file gallery -but rather than send people to the gallery I stick an RSS feed in the page for that group so they don't have to leave the page to download the file. No doubt you'll find more ways to use this powerful feature. 

^To use off site content: ^
__Get your feed:__
Go to the news site you you want to get a feed from. Click through to their RSS link. Copy the URL of the link from your browser.

__Subscribe to an external feed__
In Tiki, go to the Admin menu __down the left side of your page__ (__not__ the page with all the icons) and click on "External Feeds". Type a name for your feed (likely the name of the originating feed, say "New York Times") -this is so ''you ''can recognize it in the list you'll be making of all your feeds.

Enter a description if you like.

In the "URL" box put the URL of the feed you copied in step one above.

Choose a "refresh rate": event calendar or news feeds might benefit from a fast refresh, - Blog maybe once a day -whatever floats your boat.

Click "show feed title" and "publish date" as these are handy pieces of info.

After you "Save" you'll see an external feeds list (with only one feed in it if this is your first one). This module tells Tiki where to pick up the feed (via the URL). __Write down the "ID" number__ (likely "1" -again, if this is your first).

^Embed Your Feed In Your Wiki Pages Or Module^

Here's the easy part: while editing any wiki page (or within any user module) stick this bit in to get your feed displaying:

{rss=1 max=5}

...where "1" is the feed ID and max=5 is the maximum number of feed items to display (I have no idea if there are limits to the max number but it's more than 5!)

Save your page and ''voila!'' You'll have a feed where you want it.

__Note that there are actually 2 different feed options. See the docs for details__

There is the RSS wiki plugin, which uses the format:

~np~{RSS(id=>XXX,max=>YYY,date=>1,author=>1,desc=>1)}{RSS}~/np~

But there is also an RSS Smarty function, that uses a slightly different format:

~np~{rss id=XXX, max=YYY date=1 author=1 desc=1}~/np~

To combine feeds, use the following syntax:

~np~{rss id=1:2:3:4 max=yyy date=1 author=1 desc=1}~/np~

(This needs more explanation)
 
!! More information
* ((module rsslist))
* ((PluginRSS))

!!! Alias
*(alias(RSS))
*(alias(RSS Feeds))
*(alias(News Feeds))