File Submitter: Cris D.
File Submitted: 10 Oct 2007
File Updated: 18 Jan 2008
File Category: Blogs & News
Module: RSS FEED
Snippet: RSS V2.2
Author: Cris D
Use: This snippet creates a validated RSS xml document that lets users create live links to selected pages in your site
1) Create a template with the template code following...
2) Create and publish a new page (uncached) with the rssTemplate called rssFeed.
3) In the rssFeed page under the publishing tab set content type: "text/xml".
4) Call this snippet in the rssFeed page uncached [!rssFeed2.0!]
5) Eto 1.6.0+Set in the index.php: $etoNotice=false Eto 1.0+ set in manager config Display Linkback-Off.
6) Configure the snippet as per in-snippet documentation
7) Create a link (rss image or hyperlink) to the document rssFeed In a compatible browser, the user will be prompted to "bookmark the feeds" or "subscribe to this feed".
Create a template with the following code:
<?xml version="1.0" encoding="[(etomite_charset)]"?> <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" > <channel> [*content*] </channel> </rss>Save it as "rssTemplate"
A word about cached snippets on linked pages: If your RSS feed snippet is called [[cached]] and you have a single [!uncached!] snippet on the linked page, just the page title is returned. If your RSS feed is called [!uncached!] and you have [!uncached!] snippets on the linked page, the snippet call is displayed and the rest of the page is also shown (including evaluated [[cached]] snippets).
Therefore, for best results use this snippet [!uncached!] and all snippets on linked pages [[cached]] unless you have good reason to do otherwise.
V1.3 Updated 2007/11/06
- Made changes so the feed validates
- Added Atom namespace to template
- Now calling site keywords to fill <content> element
- WebMaster (real name) now must be hard coded
- RFF882 publishing date set by default
- isPermaLink case error fixed
- $feedLink now using makeURL instead of $GLOBALS['www_base_path']
- Built a simple etomite parser that displays the results of cached snippets on linked pages.
- Changed the installation from a snippet call in the template, to the snippet call on the page being used as the feed link.
- You can now set a parent folder for all children to include or set individual pages
- Added an Etomite notice to the bottom of the feed.
RSSFeed 2.1 2007/11/10
- Updated content with <![CDATA]> attribute
- Removed htmlentities (not required with CDATA declaration)
- Fixed unvalidating etoNotice
- Added the capability to read a feed page identified by placing RSS or rss in the documents' keyword
- Note: If RSS is found on a single page, the $itemLinks and $parent configuration methods are now ignored.
- Implemented Jim Browski's $blogLinkId suggestion as a html site anchor.
For a good guide to the configurable elements used in this snippet (and more that you can add), see... http://cyber.law.har...du/rss/rss.html
For more assistance, see the in-snippet documentation.
See it in action
Click here to download this file
Edited by Cris D., 04 December 2008 - 08:20 AM.