RSS ticker: Difference between revisions

From Official Kodi Wiki
Jump to navigation Jump to search
>DonJ
No edit summary
>Jmarshall
No edit summary
Line 18: Line 18:
</xml>
</xml>
===Available Tags===
===Available Tags===
Note that each tag is '''lower case only.''' This is important, as xml tags are case-sensitive.
In addition to the [[Default_Control_Tags|default control tags]], the following tags are available.  Note that each tag is '''lower case only.''' This is important, as xml tags are case-sensitive.
{| class="dtable"
{| class="dtable"
|- class="userrow"
| class="usercell" | '''description'''
| class="usercell" | Only used to make things clear for the skinner. Not read by XBMC at all.
|- class="userrow"
| class="usercell" | '''type'''
| class="usercell" | Specifies the control type
|- class="userrow"
| class="usercell" | '''id'''
| class="usercell" | Specifies the control's id. The value this takes depends on the control type, and the window that you are using the control on. There are special control id's that must be present in each window. '''RSS feeds may take any id they like, as long as it's not one of the special control id's that the window needs.'''
|- class="userrow"
| class="usercell" | '''posx'''
| class="usercell" | Specifies where the left of the feed should be drawn. This is offset from the window's coordinates (normally the left edge of the screen, or 0).
|- class="userrow"
| class="usercell" | '''posy'''
| class="usercell" | Specifies where the top edge of the feed should be drawn. This is offset from the window's coordinates (normally the top edge of the screen, or 0).
|- class="userrow"
| class="usercell" | '''width'''
| class="usercell" | Specifies the width that should be used to draw the rss feed. The text scrolls within this width.
|- class="userrow"
| class="usercell" | '''visible'''
| class="usercell" |
Specifies a condition as to when this control will be visible. Can be true, false, or a condition. [[Conditional Visibility|See here for more information.]] Defaults to true.
|- class="userrow"
| class="usercell" | '''animation'''
| class="usercell" |
Specifies the animation to be run when the control enters a particular state. [[Animating Your Skin|See here for more information.]]
|- class="userrow"
|- class="userrow"
| class="usercell" | '''font'''
| class="usercell" | '''font'''
Line 51: Line 25:
|- class="userrow"
|- class="userrow"
| class="usercell" | '''textcolor'''
| class="usercell" | '''textcolor'''
| class="usercell" | Specified the color the text should be, in hex AARRGGBB format.
| class="usercell" | Specified the color the text should be. In hex AARRGGBB format, or a name from the [[Colour Themes|colour theme.]]
|- class="userrow"
|- class="userrow"
| class="usercell" | '''shadowcolor'''
| class="usercell" | '''shadowcolor'''
| class="usercell" | Specifies the color of the drop shadow on the text, in AARRGGBB format.
| class="usercell" | Specifies the color of the drop shadow on the text. In AARRGGBB format, or a name from the [[Colour Themes|colour theme.]]
|- class="userrow"
|- class="userrow"
| class="usercell" | '''highlightcolor'''
| class="usercell" | '''highlightcolor'''
| class="usercell" | Specified the color that any highlighted text should be, in hex AARRGGBB format.
| class="usercell" | Specified the color that any highlighted text should be. In hex AARRGGBB format, or a name from the [[Colour Themes|colour theme.]]
|- class="userrow"
|- class="userrow"
| class="usercell" | '''titlecolor'''
| class="usercell" | '''titlecolor'''
| class="usercell" | Specified the color the titles of the feeds should be, in hex AARRGGBB format.
| class="usercell" | Specified the color the titles of the feeds should be. In hex AARRGGBB format, or a name from the [[Colour Themes|colour theme.]]
|- class="userrow"
|- class="userrow"
| class="usercell" | '''urlset'''
| class="usercell" | '''urlset'''

Revision as of 04:00, 24 July 2007

The rss control is used for displaying scrolling RSS feeds from the internet in XBMC. You can choose the font, size, colour, location and the RSS feed to be displayed.

Example

<xml> <control>

     <description>My First RSS control</description>
     <type>rss</type>
     <id>1</id>
     <posx>80</posx>
     <posy>60</posy>
     <width>500</width>
     <visible>true</visible>
     font14
     <textcolor>FFB2D4F5</textcolor>
     <headlinecolor>FFFFFFFF</headlinecolor>
     <titlecolor>FF655656</titlecolor>
     <urlset>1</urlset>

</control> </xml>

Available Tags

In addition to the default control tags, the following tags are available. Note that each tag is lower case only. This is important, as xml tags are case-sensitive.

font Specifies the font to use from the font.xml file.
textcolor Specified the color the text should be. In hex AARRGGBB format, or a name from the colour theme.
shadowcolor Specifies the color of the drop shadow on the text. In AARRGGBB format, or a name from the colour theme.
highlightcolor Specified the color that any highlighted text should be. In hex AARRGGBB format, or a name from the colour theme.
titlecolor Specified the color the titles of the feeds should be. In hex AARRGGBB format, or a name from the colour theme.
urlset The actual RSS feedset to use. This is an id reference to the <rss> section in RssFeeds.xml:

<xml> <rssfeeds>

 <set id="1">
   <feed updateinterval="30">http://feeds.feedburner.com/XboxScene</feed>
   <feed updateinterval="30">http://feeds.wired.com/wired/topheadlines</feed>
 </set>
 <set id="2">
   <feed updateinterval="30">http://www.cnet.co.uk/feeds/public/rss_news_10.htm</feed>
 </set>

</rssfeeds> </xml> Each feedset has an id attribute – this is what we are referencing in the <urlset> parameter. As can be seen, there can be more than one <set> defined, and more than one <feed> per set. The <feed>'s must be escaped so that they're xml-safe (ie replace & with & etc.). Each feed in the set runs through in the order they are defined. HOW-TO: Change RSS feeds and more info on RSS feeds|More information about RSS feeds can be found here.