|---------------------------------------------|
| RSS Parser Infusion for BS-Fusion v1.00.xx  |
| Version 2.14                                |
|---------------------------------------------|
| author: Scott Rutherford (surreal)  2005   |
| web: http://www.maiden-city.co.uk           |
| email: scott@maiden-city.co.uk              |
|---------------------------------------------|
| modifications: Rayxen  2005                |
|                MarcusG  2009               |
| last modified: 05 August 2009               |
|---------------------------------------------|
| Released under the terms and conditions of  |
| the GNU AFFERO GENERAL PUBLIC LICENSE       |
| (Version 3)                                 |
|---------------------------------------------|

+---------------------------------------------+
| Code based on PHP-Fusion
| http://www.php-fusion.co.uk/
+---------------------------------------------+
	Converted to BS-Fusion V1.00.xx by:
	
	MarcusG
	http://www.marcusg.de
	
	Developer: SoBeNoFear (ianunruh@gmail.com)




DESCRIPTION
-----------

This Infusion will take the contents of an RSS file from a remote server and parse it's contents to include the feed in your site.

Features
  - Use remote or local files.
  - Cache system reduces the number of calls to the remote file, improving load time.
  - Use side or center panels or a seperate page ... or all three.
  - Specify whether a feed should open in a new window or not

Panel
  - you can have either a side panel, center panel or both.
  - the side panel will show only the headlines (shortened to fit on one line) as a link to the source site.
  - the center panel will show the full headlines as links to the source site, plus the description of the story from the RSS file.
  - when used as a panel the Infusion will detect it's position and display the appropriate panel.
  - the number of feeds in the panels can be set in the admin panel.

Feeds Page
  - The feeds page will list all RSS Feeds which are selected in the admin panel.
  - The order of the feeds can be changed in the admin panel.
  - the number of feeds in the preview can be set in the admin panel.
  - each feed can be viewed seperately, showing all items in the feed.


UPGRADE FROM 2.00
-----------------

If you're upgrading from RSS Parser 2.00 then follow the installation instructions described below. They're the same for an upgrade as a clean installation. Do NOT defuse the Infusion. If you do, you will lose ALL your existing RSS Feeds. Simply overwrite the existing folder and Infuse as normal.


INSTALLATION
------------

   1. Upload the "rss_parser_panel" folder to your Infusions directory
   2. Change the permissions on the cache folder to make it writable (CHMOD 777)
   3. Go to your system admin panel then to Infusion Management
   4. Select "RSS Parser Panel" from the list
   5. Press Infuse to install the Infusion


ADDING A FEED

 Feed Name
    - this is the name that will appear at the top of the panels or the feed preview ont the feeds page
 Source File:
    - for remote files enter the full URL of the RSS file
    - for local files enter the full path and file name, relative to BASEDIR (your PHP-Fusion root)
 Include on Feeds Page
    - select this option to include the feed preview on the seperate feeds page
 Number of items on Feed Page index
    - the number of items that will be shown from this feed in the preview on the seperate feeds page
 Number of items in side panel
     - the number of headlines to show in a side panel for this feed
 Number of items in center panel
     - the number of items to show in a center panel for this feed
 Cache Time Limit (hours)
     - the length of time to keep the cache file, if the cache file is older than this time a new copy will be requested from the remote server


RSS FEEDS ADMIN

 Clear Cache
     - this will delete the cache file, a new cache file will be created when the feed is requested again

CREATING A PANEL

   1. Go to the Panel Management section of the admin panel
   2. Click on Add New Panel
   3. Enter the name of the feed as the panel name. This must be exactly the same as the feed name
   4. Select "rss_parser_panel" as the Panel File
   5. Select the side and access
   6. Save the panel
   7. Go back to Panel Management and activate the panel


IMPORTANT NOTES

-- NOTE 1 --
For the ability to add both a center and side panel for the same feed you must make a very small modification toe the PHP-Fusion core files. This change does not effect PHP-Fusion in any way except it allows you to add both a center and side panel with the same name.

   1. Open /administration/panel_editor.php
   2. At approximately line 66 replace this code:

         $result = dbquery("SELECT * FROM ".$db_prefix."panels WHERE panel_name='$panel_name'");

      With:

         $result = dbquery("SELECT * FROM ".$db_prefix."panels WHERE panel_name='$panel_name' AND panel_side='$panel_side'");

   3. Save, exit and re-upload the file to your server.


-- NOTE 2 --
When adding an RSS Feed as either a Center or Side Panel you can't preview the panel. Doing so will result in a "There is no source file set." message. You should ignore this and enable the panel anyway.


CHANGELOG
---------
v2.14
- fixed multiple bugs that happened in the process of updating to Fusion 7.0
- Updated to BS-Fusion V1.00.xx

v2.13
- fixed minor bug with counting of feeds. Might incorrect show "No RSS Feeds Enabled"

v2.12
 - missing cache folder added to zip file
 - replace existing files with alternatives (remove theme problem entirely)

v2.11
 - added missing locale definition: $locale['LAN_RSS_121']
 - added alternative rss_parser_panel.php to fix display issue with certain themes

v2.10
 - fixed Last/Next Update time bug
 - infusion is now PHP4 compatible (formerly PHP5 only)
 - additional "open in new window" option for each feed

v2.00
 - all changes by Rayxen
 - updated to run on PHP-Fusion v6
 - support for side and center panels for the same feed instructions
 - replaced deprecated <b> tags with css alternative
 - display message when no items are available for a feed
 - displays feed order even when feeds aren't shown on the feeds page (too confusing)
 - column specifying whether the feed is displayed on the feeds page

v1.00
 - added cache system
 - created rss_feeds table to allow multiple feeds
 - changed the cache system to handle multiple cache files
 - created new admin panel (based on fusion_admin/article_cats.php)
 - added support for local files relative to FUSION_BASE
 - added num_items_____ fields to db table for greater control over panels
 - created feeds.php
 - added page_order to db table
 - added page order to admin panel (based on fusion_admin/panels.php)
 - changed rss_parser_panel.php to handle multiple source files based on panel name



any more suggestions ... e-mail me - scott@maiden-city.co.uk