FeedExpander extends BridgeAbstract and adds functions to collect data from existing feeds.
Usage example: You have discovered a site that provides feeds which are hidden and inaccessible by normal means. You want your bridge to directly read the feeds and provide them via RSS-Bridge
-To create a new Bridge extending FeedExpander you must implement all required functions of BridgeAbstract. FeedExpander additionally provides following functions:
parseItem
-getName
-getURI
-getDescription
-Usage example: You have discovered a site that provides feeds which are hidden and inaccessible by normal means. You want your bridge to directly read the feeds and provide them via RSS-Bridge
Find a template at the end of this file.
Notice: For a standard feed only collectData need to be implemented. collectData should call $this->collectExpandableDatas('your URI here'); to automatically load feed items and header data (will subsequently call parseItem for each item in the feed). You can limit the number of items to fetch by specifying an additional parameter for: $this->collectExpandableDatas('your URI here', 10) (limited to 10 items).
parseItem functionThis function receives one item from the current feed and should return one RSS-Bridge item. +
parseItem methodThis method receives one item from the current feed and should return one RSS-Bridge item. The default function does all the work to get the item data from the feed, whether it is RSS 1.0, -RSS 2.0 or Atom 1.0. If you have to redefine this function in your RSS-Bridge for whatever reason, -you should first call the parent function to initialize the item, then apply the changes that you require.
+RSS 2.0 or Atom 1.0.Notice: The following code sample is just an example. Implementation depends on your requirements!
-protected function parseItem($feedItem){
- $item = parent::parseItem($feedItem);
- $item['content'] = str_replace('rssbridge','RSS-Bridge',$feedItem->content);
-
+protected function parseItem(array $item)
+{
+ $item['content'] = str_replace('rssbridge','RSS-Bridge',$item['content']);
return $item;
}
-Helper functions
-The FeedExpander already provides a set of functions to parse RSS or Atom items based on the specifications. Where possible make use of these functions:
-
-
-
-Function
-Description
-
-
-
-
-parseATOMItemParses an Atom 1.0 feed item
-
-
-parseRSS_0_9_1_ItemParses an RSS 0.91 feed item
-
-
-parseRSS_1_0_ItemParses an RSS 1.0 feed item
-
-
-parseRSS_2_0_ItemParses an RSS 2.0 feed item
-
-
-
-In the following list you’ll find the feed tags assigned to the the RSS-Bridge item keys:
+Feed parsing
+How rss-bridge processes xml feeds:
@@ -182,7 +137,7 @@ you should first call the parent function to initialize the item, then apply the
-parseATOMItematomid
title
updated
@@ -190,7 +145,7 @@ you should first call the parent function to initialize the item, then apply the
content
-parseRSS_0_9_1_Itemrss 0.91link
title
description
-parseRSS_1_0_Itemrss 1.0link
title
dc:date
@@ -206,7 +161,7 @@ you should first call the parent function to initialize the item, then apply the
description
-parseRSS_2_0_Itemrss 2.0link, guid
title
pubDate, dc:date
@@ -215,39 +170,24 @@ you should first call the parent function to initialize the item, then apply the
-The getName function
-Returns the name of the current feed.
-return $this->name;
-
-Notice: Only implement this function if you require different behavior!
-The getURI function
-Return the uri for the current feed.
-return $this->uri;
-
-Notice: Only implement this function if you require different behavior!
-The getDescription function
-Returns the description for the current bridge.
-return $this->description;
-
-Notice: Only implement this function if you require different behavior!
Template
This is the template for a new bridge:
<?php
-class MySiteBridge extends FeedExpander {
+class MySiteBridge extends FeedExpander
+{
- const MAINTAINER = 'No maintainer';
- const NAME = 'Unnamed bridge';
- const URI = '';
- const DESCRIPTION = 'No description provided';
- const PARAMETERS = [];
- const CACHE_TIMEOUT = 3600;
+ const MAINTAINER = 'No maintainer';
+ const NAME = 'Unnamed bridge';
+ const URI = '';
+ const DESCRIPTION = 'No description provided';
+ const PARAMETERS = [];
+ const CACHE_TIMEOUT = 3600;
public function collectData()
{
$this->collectExpandableDatas('your feed URI');
}
}
-// Imaginary empty line!
FeedExpanderHttpCachingBridgeAbstract, designed to load existing feeds into RSS-BridgeXPathAbstract