RSSReader 1.0

;===============================================
; RSS news feeds (RSSReader v1.0)
;-----------------------------------------------

*RSSimport RSS

RSSURL http://www.shellfront.org/shellfront.xml
RSSItemCount 10
RSSUpdateInterval 100
RSSInfoString ^@Description^\n(^@Link^)
RSSItemString ^@Title^\n^@Description^
RSSItemSeparator \n
RSSEnabled true

RSSInfoLabel RSSLabelTitle
RSSItemLabel RSSLabelItems
RSSOnUpdated !Execute [!LabelShow RSSLabelTitle][!LabelShow RSSLabelItems]
;RSSOnFailure !alert "RSS Update Failed"

;======================
*Label RSSLabelTitle
;----------------------
RSSLabelTitleX -300
RSSLabelTitleY 50
RSSLabelTitleWidth 224
RSSLabelTitleHeight 84
RSSLabelTitleText "Here would be the title"
RSSLabelTitleImage rss_head.png
RSSLabelTitleImageMode stretch
RSSLabelTitleStartHidden

;======================
*Label RSSLabelItems
;----------------------
RSSLabelItemsX -300
RSSLabelItemsY 135
RSSLabelItemsWidth 224
RSSLabelItemsHeight 300
RSSLabelItemsText "Here would be the dragons"
RSSLabelItemsImage rss_body.png
RSSLabelItemsImageMode stretch
RSSLabelItemsImageTopEdge 3
RSSLabelItemsImageBottomEdge 3
RSSLabelItemsLeftBorder 5
RSSLabelItemsRightBorder 5
RSSLabelItemsTopBorder 5
RSSLabelItemsBottomBorder 5
RSSLabelItemsAutoLineBreak true
RSSLabelItemsAlign left
RSSLabelItemsVertAlign top
RSSLabelItemsFontHeight 13
RSSLabelItemsStartHidden

(request name)URL [RSS-file]
URL for the XML file containing news.
By default: http://www.shellfront.org/shellfront.xml

(request name)Enabled [false/true]
If enabled, news would be automatically updated. Else you need to use !RSSUpdate !bang manually
By default: true

(request name)UpdateInterval [number]
Time interval between updating (in seconds!).
By default : 600 (10 minutes)

(request name)ItemCount [number]
Max news items number that would be read from the RSS-file
By default: 10

(request name)InfoString [pattern]
This pattern would be used for generating a news header. You can use both regular text and AtVars
By default: ^@Title^\n(^@Link^)\n^@Description^

(request name)ItemString [pattern]
This pattern used for formatting news items. You need to use AtVars here
By default: ^@Title^ (^@Link^)

(request name)ItemSeparator [текст]
Text that would separate news items text.
By default: \n

(request name)OnUpdated [action]
Action that would be called after successfull downloading and parsing of the RSS-file.
By default: !none

(request name)OnFailure [action]
Action performed if download failed or file has incorrect structure.
By default: !none

(request name)InfoLabel [text container name]
If set and is not empty, container would be used for displaying text, formatted using InfoString.
By default: empty string

(request name)ItemLabel [text container name]
If set and is not empty, this container would be used for displaying text, formed from ItemCount number news item strings that are generated using ItemString pattern and separated by ItemSeparator.
By default: empty string

First parameter of each !bang is RSS request name.
For example, to update news described by MySiteNews request, you need to execute

!RSSUpdate MySiteNews

Full list of the exported !bangs:

!RSSUpdate (request name)
Update news.

!RSSEnable (request name)
Enable automatic updates.

!RSSDisable (request name)
Disable automatic updates.

!RSSToggle (request name)
Disable if enabled, enable if disabled :)

!RSSSetURL (request name) [URL]
Change RSS-file URL.

!RSSSetCount (request name) [number]
Change number of displaying news.

!RSSSetInfoString (request name) [pattern]
Change header pattern.

!RSSSetItemString (request name) [pattern]
Change news item pattern.

!RSSSetItemSeparator (request name) [text]
Change separator text.

!RSSSetUpdateInterval (request name) [seconds]
Change update interval.

You can use the following AtVars (escape-sequencies) in the patterns:

^@Title^
News caption / RSS-channel title

^@Link^
Basic news/channel link

^@Description^
Full news item text / channel description

After updating RSSReader exports the following eVars:

(request name)_Title
RSS-channel title

(request name)_Link
Basic channel link

(request name)_Description
Channel description

(request name)_Info
Channel header, formed using (request name)InfoString

(request name)_Items
News text generated using (request name)ItemString and (request name)ItemSeparator

(request name)_Item1, (request name)_Item2, (request name)_Item3 и т.д.
News items, formatted using (request name)ItemString

(request name)_Item1_Title, (request name)_Item1_Link, (request name)_Item1_Description,
(request name)_Item2_Title, (request name)_Item2_Link и т.д.
Sole news item components

Originally usage of this eVars, OnUpdated action and !ParseEvars !bang was emphasised during development, - I apologized that it is the most flexible way of configuring. For exmaple, user can set 10 labels, set their text on OnUpdated to %#Item[number]Title$#, and change OnClick action to %#Item[number]Link%#. But the greatest trouble is that LiteStep + Text Processing = Hell. If ^@Title^ contain doublequotes, text would be cut in the middle... To use single quotes in the beginning and in the end? But if ^@Title^ contains single quote?
So, I'm really troubled... May be you can do more than me? ;)