I've searched these forums and found plenty of requests for rss aggregators but not much information beyond [URL=http://forums.b2evolution.net/viewtopic.php?t=2198]EdB's post[/URL]. I understand that an integrated rss tool is to be included in b2evo in the future. That's wonderful news.
For those out there who need something in the meantime I thought that I'd share how to integrate [url=http://zvonnews.sourceforge.net]zFeeder[/url] for use with b2evolution blogs. I've done it with blogs on my own small network as well as on blogs for a few friends running b2evo software. I found the process quite simple.
zFeeder, or zvonfeeds, is a kickin' little rss aggregator written in php that is designed to live on your web server. It collects rss feeds from web addresses you give it on regular assigned intervals and displays them via the use of templates in a php file which can be included into any other functioning php page. If you have shell access or can ftp to your server space and can run php apps, then you can install zFeeder. Simply [URL=http://zvonnews.sourceforge.net/download.php]download the latest zFeeder package[/URL] and follow the installation instructions. If you have questions regarding the installation, I recommend searching and/ or posting to the [URL=http://sourceforge.net/forum/forum.php?forum_id=288429]zFeeder Help Forum[/URL].
The only problems I've had with the installation have been server permissions. Depending on your server, you may have to set some of zFeeder's file permissions to 777 for zFeeder to function. If that is the case, I recommend doing it one at a time until things work... creating as small a security hole as possible.
The zFeeder admin page is password protected, but for slightly better security you may wish to install zFeeder into a directory with a name other than the default "newsfeeds." Obviously, that's your choice. If you choose to use a differently named installation directory then please remember to alter any and all required path names accordingly.
I recommend e-mailing the user name and password that you select for the zFeeder admin page to yourself, and then filing that e-mail away in a safe place. There is currently no password retrieval system available for zFeeder of which I'm aware.
Once zFeeder is installed, access the admin page at (http path to your zFeeder installation)/admin.php and set up your username, passwords, and select the default feeds. zFeeder comes with a lot of newsfeeds out of the box. I recommend selecting one of the category templates and deleting any feeds that you don't want, then adding the ones that you wish. Please don't forget to include a numerical setting to represent how many entries of a feed you wish to display (I usually choose five) and how often you'd like the feed cached by zFeeder (I usually select every thirty minutes).
Then select a template for the display of the feeds. There are several to choose from which are included with zFeeder. Most of them have their own style and are set up with tables.
Personally, I didn't like the included templates. I wanted something that would have the same look and feel of my blog. So I created a very simplified template that only displays the name of the rss feed's originating site and the news item or blog post title in an unordered list which draws style information from your blog skin's header. The times of posts and description of the originating web site, if available, can be seen by mouse over. This plain, unordered list template is available [URL=http://www.dementedkitty.com/dkitty/plain.html]here[/URL] (select "save as" from your browser's file menu once the page loads in a new window). You're more than welcome to have a look at [URL=http://www.dementedkitty.com/index.php#feeds]my l33t gray skin[/URL] if you'd like to see the plain template in action. It blends in seamlessly.
If you decide that one of the included templates is favorable, you may wish to edit the length of the posts that are displayed. You may check [URL=http://sourceforge.net/forum/message.php?msg_id=2609311]these[/URL] [URL=http://sourceforge.net/forum/message.php?msg_id=2369131]two[/URL] zFeeder Help Forum threads. They will likely send you in the right direction.
Once you've set up the feeds you desire and selected a template, open the b2evolution _main.php file of the skin you wish to display the feeds. Insert the following code, replacing "/path/to/your/zFeeder/install" with the actual path to your zFeeder installation folder:
<?php include ('/path/to/your/zFeeder/install/zFeeder.php'); ?>
Instead you may choose a relative path such as:
<?php include ('../newsfeeds/zfeeder.php'); ?>
or:
<?php include ('newsfeeds/zfeeder.php'); ?>
Hopefully, that's it! Load your blog's page in a browser and test it. Do you seen the rss feeds? If so, then bravo. If not, triple check the file permissions of the files in your zFeeder insallation directory. Also check the admin page to be sure you've selected a category of rss feeds as default which contains rss feeds to be cached. That may sound silly, but it's a commone mistake. I did it during one installation myself.
Please keep in mind that some servers have extensive firewall protection in regards to php files. You may not be able to access the feeds you want without first whitelisting the urls of those feeds via your server admin. I recomend adding the feed of your own blog to the set you choose as default as a test. If no other feed shows up but your own, then my guess is that your server's firewall won't allow you zFeeder to freely collect the outside feeds. That can be remidied by e-mailing your server admin, explaining that you wish to use zFeeder on one of your pages, and that you'd like the URLs of your desired feeds whitelisted through the server's firewall. Be sure to include the URLs to the desired rss feeds in that e-mail.
If all else fails or you have questions not answered in this brief how to, please either refer to the [URL=http://zvonnews.sourceforge.net/zfeeder.php]zFeeder Documentation[/URL], search/ post to the [URL=http://sourceforge.net/forum/forum.php?forum_id=288429]zFeeder Help Forum[/URL], or post a reply here. I'm not an expert when it comes to zFeeder but the b2evolution community is a fabulous one. Someone here will probably be able to help.
Cool! I haven't played with it (yet) but it seems to me the worst part of my hack is addressed by zfeeder - that being the effort involved in getting new feeds displayed. The only issue I can see with it is that it invalidates your xhtml by putting an alt tag after the title tag in a text link. Funny part is the validator only complained once even though viewsource showed that each link was done that way.
By the way I'm done with what I was doing. Almost 100% customizable in the file for skins/skinname, only it does take a hack at _main each time you want to add or remove a feed. Most recent post at http://wonderwinds.com/blog covers it, and I will add another post to the hacks section with the now-stable code included.
And I want your skin! I'll leave a comment with an email because it still doesn't appear in b2evo's skin pile.