Friends RSS Aggregator
UPDATE Feb 10 2007: I’m currently working on fixes so that FRA works with WP 2.1, along with a new release of the plugin that should have some new features. I’ll make a post on this page and my weblog once its ready. Sorry for any inconvenience.
Friends RSS Aggregator (FRA) WordPress plugin was built to enable a WordPress installation to have a livejournal.com-like friends page. By creating a group of friends’ weblog links with RSS/Atom URIs in a particular link category, a user can display an aggregated list of posts by date or name. The word ‘Friends’ in the plugin is also a bit of a misnomer since the plugin is by no means limited to aggregating just friends’ weblogs; FRA allows aggregation of any group of links (that specify RSS URIs) in one or more link categories.
Friends RSS Aggregator 0.3.1 is available for download. Check out my Friends page for an example of the Friends RSS Aggregator in action.
- Requirements
- Support
- Installation and Setup
- Customizing Look and Feel
- Got General Problems?
- User Comments
Requirements
- FRA uses and includes MagpieRSS for all RSS/Atom fetching and parsing. Look to MagpieRSS 0.72 for PHP requirements and dependencies.
- FRA was developed for WordPress 1.5.2 but may work with other versions. It has been reported that it works with WP 2.0 but I have not tested it personally.
Support
This page and the distribution files offer most of the support, but if you have problems that can’t be answered after reading the entire page, email me. I don’t answer questions pertaining to anything MS Windows related. This software is free and is provided as-is. I am in no way responsible for any damage that may occur as a result of using this.
Installation and Setup
- Download the plugin.
- Unpack, and if necessary upload, the plugin in the wordpress plugins directory. This is usually something like $WP/wp-content/plugins where $WP is the WordPress installation directory. There should now be a ‘friends-rss’ directory in the plugins directory.
- In the new
friends-rssdirectory, make thecachedirectory writable by the webserver process-user. The easiest way to do this (and most insecure) is to issue the command `chmod 777 cache` from within the ‘friends-rss’ directory. - In WP admin UI, activate the plugin by going to the ‘Plugins’ section and selecting the activate link in the Friends RSS entry.
- In WP admin UI, go to ‘Options -> Friends RSS’ and specify the absolute path to the cache directory (e.g. /home/foobar/public_html/wp-content/plugins/friends-rss/cache).
- If there isn’t one yet, in the WP admin UI, create a link category with a few links in it. Although it is not required, you can name the category ‘Friends’ to make later setup easier. Important: Make sure that each of the links in the category has an RSS URI specified in the RSS URI field (not the Link URI field) so that the RSS feed can be fetched.
- Copy
linkfeeds_by_date.phpfrom the example_templates directory into the current WP theme directory. If you want the posts listed by name of link, copylinkfeeds_by_name.php, instead. - In WP admin UI, write a new page. Specify the page template as ‘Link RSS Feeds By Date’. When you fill in the ‘Page Title’ and ‘Page Content’ fields they will appear at the top of the viewed page.
- If your link category name is not ‘Friends’, you will have to edit the template that was copied into the theme directory to pass the category name in the display function. See the template file for further details.
- View the page after editing to ensure that posts are being retrieved and that you like how the page looks. If you don’t like how the page looks and feels, check out customizing look and feel. If the page does not function as it should, read the general problems section.
Customizing Look and Feel
The linkfeeds_by_date.php and linkfeeds_by_name.php template files each contain a call to a PHP display function. These functions are parameterized to allow customization of things like date format, number of posts, and link categories displayed. Within each template file, there is an explanation of all the arguments of the display function and their default values. If you’re not familiar with PHP function arguments, read the WordPress How-To. The display_feeds_by_date() function in the linkfeeds_by_date.php template has up to seven arguments. Each argument is explained below in the order of specification.
- Number of posts to display at a time. default =
10 - Name of link category, or array of link category names to be displayed. Multiple categories can be specified like
array('friends','enemies'). You can also display all categories by specifying the value-1. default ='Friends' - Index of post to display first.
0is most recent post. This argument should not need to be modified. default =0 - Displays the full content of each post when
true, else displays summary. default =true - Includes a feed image if available when true. default =
true - Displays navigation links to older and newer posts when true. default =
false - Format string for post date of each post, used as parameter for
strftime(). default ='%A %B, %d %Y %I:%M %p %Z
If your look and feel problems go beyond the display functions, there are three places to look: The HTML and code in the template file you are using, the styles in the current theme’s style.css file and the HTML generated by the display function. First, take a look at your styles in style.css and HTML in the template file (e.g. linkfeeds_by_date.php) to see if the problems can be fixed there.
If the problem lies in the HTML generated by the display function, your best option is to forego using the current template and display function and use the custom_linkfeeds_by_date.php template, which allows the customization of how the HTML is generated for each feed post. This approach is only recommended for those comfortable editing PHP code.
Customization Questions
How do I “hide” a link from displaying its posts while keeping it in my links?
Update the link in the admin UI and make it not visible.
Got Problems?
When I install or upgrade WP, I get an error on my main Admin Dashboard (or a blank dashboard) once the plugin is activated.
This is because WP 1.5.x and 2.0.x include an older version of MagpieRSS (version 0.51). The index.php page in the wp-admin directory includes the rss-functions.php file which is essentially MagpieRSS 0.51. Just comment out the line that includes this file (with ‘//’) in index.php.
To permanently solve this problem I’d have to change all class-function, file and constant names in FRA’s version of MagpieRSS. I considered doing this, but decided not to in favor of waiting until WP is released with a newer version of MagpieRSS. Unfortunately, if you have other plugins that include/require rss-functions.php, then you’d have to comment out the include/require line in those plugin files (and possibly add an include of FRA’s version of MagpieRSS). It’s all very annoying.
When I view my page of link feeds, it loads slow or doesn’t fully load, sometimes leaving me with a blank page or page not found error.
This can happen on a page load when many or all RSS feeds are being initially retrieved or refreshed. PHP is configured to execute scripts for a maximum period of seconds, so if your script exceeds this period it will not fully load the page. For more information read the manual entry on maximum execution time. If you can’t configure php on the hosting server, you must address this issue with your hosting provider.
The best solution is to avoid RSS refreshes when the page loads altogether. To do this, you can use the wp-cron-refresh-cache.php plugin or you need to setup a cronjob that runs the refresh-rss-cache.php script periodically. Installation instructions are in each file which are located in the main friends-rss and scripts directories, respectively.
I get “Warning: MagpieRSS: …” warning messages when I view my feed page. How can I get rid of them?
These warnings are usually a result of a badly-formed feed or bad feed URL. If you find these messages just plain annoying, you can stop them from displaying by uncommenting the //error_reporting(E_USER_ERROR); line in friends-rss.php.
All my feed dates are showing up in 1969 (or something equally old). What a year!!!!
That probably because the feeds you are fetching and parsing don’t have a date associated with each post/item. There’s not much you can do about this if you don’t have control over the feed, other than ask the feed owner.
[...] ???????????????????????????????????????????? [...]
[...] ???????????????????????????????????????????? [...]
[...] ???????????????????????????????????????????? [...]
[...] ???????????????????????????????????????????? [...]
[...] 2?Friends RSS Aggregator (FRA) [...]
RSS feeds are really great if you want to stay updated “`
[...] ??Friends RSS Aggregator (FRA) [...]
[...] ???????????????????????????????????????????? [...]
i think that RSS FEEDS should also be included on the list of the best inventions because it makes life easier for bloggers like us -.`
that of a good understand.
[...] 4. Friends RSS Aggregator (FRA) [...]
Nice article. Last Month I found this web site and wanted to let you know that I have been gratified, going through your site’s posts. I shall be signing up to your RSS feed and shall wait for your next post. Cheers, Glen
An interesting discussion is worth to comment. I think that you should write more on this topic, it might not be a taboo subject but generally people are not enough to speak on this blog. To the next. Cheers, Susan.
[...] ??Friends RSS Aggregator (FRA) [...]
I need to invest in an excellent Wp theme. 1 under $200 with no annual fee. Any recommendations?
[...] four, Friends RSS Aggregator (FRA) [...]
Today, with the fast way of living that everyone is having, credit cards have a big demand throughout the market. Persons coming from every arena are using the credit card and people who not using the credit card have made up their minds to apply for even one. Thanks for expressing your ideas in credit cards.
[...] four, Friends RSS Aggregator (FRA) [...]
Elisheba, the people straw to see the children of my lord being bound Isaac loved also of his son Isaac and upon the seed after that which his name Jacob? for that my wonders before his flock and multiply thy father, saying, I will again no leavened bread to pass,
I’m running WP 2.0.4, and I had the same problem:
Fatal error: Cannot redeclare fetch_rss() (previously declared in /www/darrylkoster.net/public_html/wp-content/plugins/friends-rss/include/magpierss/rss_fetch.inc:90) in /www/darrylkoster.net/public_html/wp-includes/rss-functions.php on line 503
Once I changed the the first line in friends-rss.php to require_once(ABSPATH . WPINC . ‘/rss-functions.php’); it seems to work fine, although it needs some visual formatting. Guess I’ll work on that.
Amazing! This blog looks exactly like my old one! It’s on a entirely different subject but it has pretty much the same page layout and design. Superb choice of colors!
My programmer is trying to persuade me to move to .net from PHP. I have always disliked the idea because of the expenses. But he’s tryiong none the less. I’ve been using WordPress on a number of websites for about a year and am anxious about switching to another platform. I have heard excellent things about blogengine.net. Is there a way I can import all my wordpress posts into it? Any kind of help would be really appreciated!
Thank you for the sensible critique. Me & my neighbor were just preparing to do a little research about this. We got a grab a book from our local library but I think I learned more from this post. I am very glad to see such excellent info being shared freely out there.
I’m impressed, I must say. Actually rarely do I encounter a weblog that’s each educative and entertaining, and let me let you know, you have got hit the nail on the head. Your concept is excellent; the difficulty is one thing that not sufficient people are speaking intelligently about. Im very pleased that I stumbled throughout this in my seek for something relating to this.
I was just seeking this info for some time. After six hours of continuous Googleing, finally I got it in your website. I wonder what is the lack of Google strategy that don’t rank this kind of informative sites in top of the list. Generally the top websites are full of garbage.
Well writtten and easy to read. Enjoyed it very much.
Wow! I have no idea why I didn’t find out abot this this years ago, brill job.
whoa…. it really is a wonderful. responses we present this is prepared to you personally most supporters.
Thanks on your marvelous posting! I quite enjoyed reading it, you can be a great author.I will be sure to bookmark your blog and will eventually come back at some point. I want to encourage you to definitely continue your great job, have a nice afternoon!
continue to writing individual, awesome. it’s essential to discover the fine brief review this fit with you actually.
Really efficient profession broo. a piece of writing get everybody consider a latest theory.
Could used pals figure out more about them?
I love you’r blog theme, which theme do you have?? please reply!
I adore yours blog template, what design do you use?? please reply.
I love yours blog design, which template do you have? please reply.
Hey! Do you know if they make any plugins to help with SEO? I’m trying to get my blog to rank for some targeted keywords but I’m not seeing very good success. If you know of any please share. Cheers!
I don¡¦t even know the way I stopped up here, but I thought this publish was good. I don’t recognise who you’re however certainly you’re going to a well-known blogger when you aren’t already
Cheers!
Excellent post with some good info, think i’ll share this on my twitter if you don’t mind.
Fantastic beat ! I wish to apprentice whilst you amend your site, how can i subscribe for a weblog site? The account helped me a acceptable deal. I were a little bit familiar of this your broadcast offered shiny transparent concept
Good day I am so happy I found your website, I really found you by mistake, while I was searching on Bing for something else, Anyways I am here now and would just like to say cheers for a incredible post and a all round entertaining blog (I also love the theme/design), I don? have time to read through it all at the minute but I have saved it and also added in your RSS feeds, so when I have time I will be back to read much more, Please do keep up the awesome work.
I do love the manner in which you have presented this specific challenge and it does give me personally a lot of fodder for thought. Nevertheless, coming from what I have experienced, I simply trust when the actual reviews stack on that men and women keep on point and don’t start upon a tirade regarding some other news of the day. Still, thank you for this fantastic point and although I do not agree with this in totality, I respect the standpoint.
Please let me know if you’re looking for a writer for your blog. You have some really good posts and I think I would be a good asset. If you ever want to take some of the load off, I’d love to write some material for your blog in exchange for a link back to mine. Please blast me an e-mail if interested. Thanks!
Friends RSS Aggregator adam @ 404 Magnificent goods from you, man. I’ve understand your stuff previous to and you are just extremely wonderful. I really like what you’ve acquired here, really like what you’re stating and the way in which you say it. You make it enjoyable and you still care for to keep it smart. I can not wait to read far more Friends RSS Aggregator adam @ 404 again from you. Thanks For Share .
I do enjoy the way you have presented this particular problem plus it really does give me personally some fodder for consideration. However, because of what I have personally seen, I only hope when other responses pile on that folks remain on point and don’t get started upon a soap box of the news du jour. Anyway, thank you for this outstanding point and whilst I do not really go along with it in totality, I value your standpoint.
I for one will fight Organized Crime and not vote for a single incumbent, and tell them the reason why.
Heya i am for the first time here. I came across this board and I find It truly useful & it helped me out much. I hope to give something back and aid others like you helped me.
Excellent post however I was wanting to know if you could write a litte more on this topic? I’d be very thankful if you could elaborate a little bit further. Appreciate it!
I like Your Article about Friends RSS Aggregator adam @ 404 Perfect just what I was looking for! .
Thank you for sharing superb information. Your website is so cool. I’m impressed by the info that you have on this blog. It reveals how nicely you perceive this subject. Bookmarked this web page, will come back for more articles.
Thanks for another magnificent post. Where else could anyone get that kind of info in such an ideal way of writing? I have a presentation next week, and I’m on the look for such information.