(See also) |
(removed rss tag description until fixed) |
||
(9 intermediate revisions by one other user not shown) | |||
Line 1: | Line 1: | ||
Displaying a feed in Appropedia can be accomplished with a | Displaying a feed in Appropedia can be accomplished <!--in two ways: | ||
* with RSS tags, which gives a bold header and links to each post, or | |||
*--> with a widget, which gives a header in regular font, links to post, and an extract | |||
{{TOCright}} | |||
<!--== Using RSS tags == | |||
Simplest example, showing all available posts: | |||
<pre> | |||
<rss>http://blogs.appropedia.org/feed/</rss> | |||
</pre> | |||
Displays as: | |||
<rss>http://blogs.appropedia.org/feed/</rss> | |||
And with a set number of posts: | |||
<pre> | |||
<rss number=3>http://blogs.appropedia.org/feed/</rss> | |||
</pre> | |||
<rss number=3>http://blogs.appropedia.org/feed/</rss> | |||
Depending on the format of the blog, there may be a header & byline displayed with the feed. (How do we control this?) E.g.: | |||
<pre> | |||
<rss number=3>http://feeds.feedburner.com/afrigadget</rss> | |||
</pre> | |||
Displays as: | |||
<rss number=3>http://feeds.feedburner.com/afrigadget</rss> | |||
===More RSS tag options=== | |||
You can add more than one feed in a single ''<nowiki><rss></nowiki>'' tag to have them display in columns. Do so by adding "|" between the feed urls. Thus, ''<nowiki><rss>firsturl|secondurl|thirdurl</rss></nowiki>'' will create a reader with 3 columns, displaying items from all 3 feeds. Inside the ''<nowiki><rss></nowiki>'' tag you can include optional settings, which are detailed below: | |||
;''number'' | |||
:By default, the reader will display all the items in the feed. If you want to display up to a maximum of a certain number of items, then add ''number='''n''''' (where '''n''' is the max number) inside the rss tag: ''<nowiki><rss number=10>http://www.appropedia.org/index.php?title=Special:Recentchanges&feed=rss</rss></nowiki>'' will display the last 10 stories from BBC World. | |||
;''time'' | |||
:By default, the reader will take the value of ''$egCacheTime'' as the amount of time (in seconds) between each local caching of the RSS feed. If you want a certain feed to refresh its cache more or less frequently, then add ''time='''t''''' (where '''t''' is the refresh time in seconds) inside the rss tag: ''<nowiki><rss time=7200>http://www.appropedia.org/index.php?title=Special:Recentchanges&feed=rss</rss></nowiki>'' will refresh the cache of stories from BBC World every 7200 seconds (2 hours). <br />The max and min time allowed for the time argument is governed by ''$egCacheTimeMin'' and ''$egCacheTimeMax'' in ''LocalSettings.php''. If the specified time falls outside this range, then it will revert to the default ''$egCacheTime'' value. | |||
;''desc=off'' | |||
:Hides the description provided by the feed. | |||
;''width'' | |||
:If set to a legal value (between ''$egWidthMin'' and ''$egWidthMax'') it turns the RSS section into a floating div, alligned to the right, of the width specified (in pixels) | |||
;''title=off'' | |||
:Hides the title (and description in <code>desc=off</code> of the feed. | |||
== Usage notes == | |||
* No line breaks between tags. | |||
* Atom feeds don't work. | |||
* RSS 1.0 & RSS 2.0 seem to display exactly the same. | |||
=== Bugs === | |||
E.g. 1 - the following code: | |||
<pre> | |||
<rss number=5>http://www.appropedia.org/index.php?title=Special:Recentchanges&feed=rss</rss> | |||
</pre> | |||
Creates: | |||
<rss number=5>http://www.appropedia.org/index.php?title=Special:Recentchanges&feed=rss</rss> | |||
The feed works elsewhere, so it's not clear why it breaks here. It is reported [http://www.mediawiki.org/wiki/Extension_talk:RSS_Reader#Error:_It.27s_not_possible_to_get_http:.2F.2Fwww._... here] but with no solution yet. | |||
==See also== | |||
*See http://www.mediawiki.org/wiki/Extension:RSS_Reader#The_.3Crss.3E_tag for the most up to date information on reading RSS feeds. | |||
--> | |||
== Using a "widget" == | == Using a "widget" == | ||
:''See also [[ | <!-- Replace this comment here if the widget breaks again: | ||
'''BROKEN''' - use the RSS tag instead. | |||
This method appears to be broken - no output is given. The code ([[Widget:Feed]]) relies on an [http://feed2js.org/ external service] which is possibly not working the same way now. | |||
--> | |||
:''See also [[Widget:Feed]].'' | |||
E.g.: | E.g.: | ||
Line 11: | Line 82: | ||
|chan=y | |chan=y | ||
|num=3 | |num=3 | ||
|desc= | |desc=200 | ||
|date=n | |date=n | ||
|targ=y | |targ=y | ||
Line 23: | Line 94: | ||
|chan=y | |chan=y | ||
|num=3 | |num=3 | ||
|desc= | |desc=200 | ||
|date=n | |date=n | ||
|targ=y | |targ=y | ||
}} | }} | ||
== | === Notes === | ||
< | <!--Changing targ=y to targ=n doesn't seem to do anything. Yes, it does, "y" opens new tab.--> | ||
Setting date=y adds a line with the date (can't limit it though - gives too much detail, down to the minute.) | |||
[[Category:Appropedia help|{{PAGENAME}}]] | [[Category:Appropedia help|{{PAGENAME}}]] |
Revision as of 15:56, 8 March 2013
Displaying a feed in Appropedia can be accomplished with a widget, which gives a header in regular font, links to post, and an extract
Using a "widget"
- See also Widget:Feed.
E.g.:
{{#widget:Feed |feedurl=http://blogs.appropedia.org/feed/ |chan=y |num=3 |desc=200 |date=n |targ=y }}
Creates:
Notes
Setting date=y adds a line with the date (can't limit it though - gives too much detail, down to the minute.)