=== FeedList === Contributors: finalcut Donate Link: https://www.paypal.com/cgi-bin/webscr?cmd=_donations&business=bill%40doxie%2eorg&item_name=Feedlist&no_shipping=0&no_note=1&tax=0¤cy_code=USD&lc=US&bn=PP%2dDonationsBF&charset=UTF%2d8 Tags: rss, atom, feeds, listings Requires at least: 1.5 Tested up to: 3.3 (php 5.3.5) Stable tag: 2.70.00 License: GPLv2 or later (same as wordpress uses). Truth be told I don't really understand all of the different open source licenseing options. See the Description for more info. Allows you to display lists of links from an rss or atom feed on your blog. == Description == This plugin fetches RSS or ATOM feeds from the url you provide and displays them on your blog. It can be used to manage "hot links" sections or anything else you can grab via an RSS or ATOM feed. The plugin also supports wordpress filters by letting you embed a feed into your post. The initial idea for this plugin came from the del.icio.us plugin that can be found at http://chrismetcalf.net. - Secondary inspiration for the ATOM integration comes from James Lewis at http://jameslewis.com - I had been thinking about doing it and he did it which pushed me to make the integration. Finally: A bit more info on the license: I'll say that you can use the source code in this plugin however you want. If you change it I won't help you fix things. If you sell it - great; I wish I had made some money off of it. You can use it for any purpose you imagine just don't blame me if it doesn't work as well as you'd hoped while imagining. == Installation == INSTALLATION: 1.) Place the plugin (feedlist.php) in your wp-content/plugins/feedlist directory. (create the feedlist directory if necessary) 2.) Edit feedlist.php and fill out the values in the CONFIGURATION section. 3.) Enable the feedList plugin in the "Plugins" section of your WordPress administration panel. 4.) OPTIONAL BUT HIGHLY RECOMMENDED - Replace the class-snoopy.php file in your wp-includes directory with the one provided in this distribution. The standard class-snoopy.php is broken when trying to load pages that are compressed by their server (gzip compression). This file fixes that problem. UPGRADING: 1.) jot down your configuration information in feedList.php 2.) Overwrite your feedlist.php file 3.) Update your feedlist configuration information with that data you wrote down in step 1 4.) enjoy == Upgrade Notice == Why wouldn't you want the latest and greatest version? == Screenshots == Sorry, I don't have shots for this. It just displays text in an ordered or unordered list - so I'm not sure a screen shot is really necessary. == Change Log == DATE MODIFICATION AUTHOR ------------------------------------------------------------------------------------------------------- 12 October 2005 Initial Version Bill Rawlinson - released version 2.0B rewrite of rssLinkedList NOTE a major change - the caching is handled by Wordpress now so you don't need a cache directory. 06 Nov 2005 Simplified Interface and Rewrite Docs 15 Nov 2005 Fixed some bugs 01 Dec 2005 Fixed a bug where the description wasn't being shown for atom feeds and cleaned up the description display code 24 Jan 2006 Added new parameter to suppress the inclusion of links with an item title 09 Feb 2006 Removed erronneous line that was preventing feed caching. Thanks to user Ted. also added better internationalization thanks to user Sebastian 08 Mar 2006 Added new parameter to display the date the feed was updated "show_date" which is false by default. 10 Mar 2006 Added "random feed" capability (see bottom of file for usage). 12 May 2006 Added new parameter "additional_fields" which really extends what you can show within the output of the feed. 16 Jun 2006 Added new parameters max_characters and max_char_wordbreak Plus the ability to add translations for some key words that might get inserted in the feed items. 21 Nov 2006 minor bug fix that caused generated content to not be xhtml compliant - thanks to the owner of "The Swamp" at http://www.guzzlingcakes.com/ for pointing out the problems. Am also including the class-snoopy.php fix for wordpress so that sites that gzip compress their feeds can be consumed by feedlist (this is a bug in snoopy that has been fixed) this will allow you to pull in feeds from sites that previously didn't work such as ma.gnolia and reddit.com 14 Apr 2007 Complete rewrite 22 Jan 2008 Minor Bug fixes (handle show_date, show_date_per_item) 24 Mar 2008 Added new parameter "show_description_only" which forces the output to only show each items description (will be linked if a link exists in the feed). 08 Apr 2009 The Read More link now acts according to the behavior of the "new_window" argument 07 Jul 2009 Added "feedListExtensions.php" with first extension point, "transformURL" see bottom of this document for help on extensions. 23 Sep 2009 fixed a variety of issues identified at http://code.google.com/p/wp-feedlist/issues/list (issues: 15, 17, 22, 30, 31, 32, 37) 25 Nov 2009 Added filter for posts to use the random feed file 19 Jan 2010 Added new option of to display rel="nofollow" on the links. Option is called "no_follow_on" and by default is set to false. 08 Apr 2010 Added support for SimplePIE feed parsing as an alternative to the default magpie choice. 29 Oct 2010 Made the language option request specific while keeping the global setting as the default choice 09 Jan 2012 Fixed mistake that was causing eof error when php demands ") - Tag placed before the item * after (default: "") - Tag placed after the item * description_separator (default: " - ") - Between the link and the item * encoding (default: false) - Change to true if you are reading in a ISO-8859-1 formatted file. Basically, if you see a bunch of question marks (?) in your titles set this to true and see if it fixes the problem. * sort (default: "none") - takes one of three values; none, asc, desc none - doesn't sort and leaves your existing code as is asc - sorts the results in alphabetic order (by title) desc - sorts in reverse alphabetic order (by title) * new_window (default: false) - Whether to open the links in a new window or not. true - opens links in new window using javascript to attach the "target" attribute to each link in the list and is thus xhtml strict compliant false - opens the links in the current window (DEFAULT) simple - opens links in new window and hardcodes the target="_blank" into the link. NOT xhtml strict compliant this option exists so that you can use it without javascript. If you also don't want to include the javascript in your header file update the global setting in rssLinkList.php $showRSSLinkListJS and set it to false. * ignore_cache (default: false) use only under special circumstances such as testing a feed. Setting to true will get you banned from some feed providers if you fetch too often! If you provide a number (instead of true or false) it will use that value (in seconds) as the cache timeout setting.. true - gets a fresh copy if possible: not reccommended as some sites will ban you if you get their feed to frequently false - uses the default caching mechanism numeric value - a way to overide the cache timeout on a feed-by-feed basis * suppress_link (default: false) - Whether to wrap the item title in a link to the item's link url true - suppresses the link and wraps the title in a false - the default behaviour that is what feedList has always done - if a link exists in the feed item then the title is wrapped in the anchor tag . * show_date (default: false) - wheter to show the last date the feed was updated. If true it shows the date wrapped in a div with the class of "feedDate". true - shows the update date like so: "updated: 02 Mar 2006 01:59pm EST" without the quotes wrapped in a DIV with class "feedDate". If you use this and have your feed items shown in a list (