HungryFEED

HungryFEED Hungry!

HungryFEED is a WordPress plugin that inserts RSS feeds inline onto your blog posts, pages and sidebar widgets. The RSS feed content becomes a part of your page and is not pulled in by the browser via AJAX.  HungryFEED uses WordPress shortcodes, for example, after the plugin is installed you can insert the following text on any blog post or page:

Download HungryFEED

Do you like HungryFEED?  If so, please rate it in the WordPress Plugin Directory (preferably with 5 stars!).  It’s just one click for you but it helps HungryFEED get more exposure.

Installation

  1. Extract hungryfeed.zip and upload the entire folder hungryfeed to your wp-content/plugins folder.
  2. To support caching, ensure the directory wp-content/cache exists and is writable.
  3. Enable the plugin in the Administration Dashboard.

Usage

WordPress Shortcodes allow you to specify parameters which change the behavior of the plugin.  The HungryFEED plugin has various optional parameter that allow you to filter the results and customize the feed output.

Basic Parameters

  1. url: (required) The URL to a valid RSS feed is the only required parameter.  This URL must contain a valid RSS feed.  If this parameter is omitted, the verysimple.com RSS feed will display instead.

Optional Parameters

  1. max_items: The maximum number of items to display (0 = unlimited)
  2. feed_fields: The feed field are the main title and description that may be provided for an RSS feed.  You may specify a comma-separated list of fields to show for the feed.  Valid values are title, description.  Example: feed_fields=”title,description”  if you do not wish to see any of them, you may specify an empty value (feed_fields=””)
  3. item_fields: A comma-separated list of fields to show for each item. Each item in the field has various fields that can be displayed. Valid values are title,description,author, and date.  Example: item_fields=”title,author,date” (Note: this parameter is ignored if you specify a template)
  4. link_item_title: Set to 1 or 0 to enable/disable the title link.  (Note: this parameter is ignored if you specify a template)
  5. link_target: (added in version 1.3.6) Specify the target for a link, for example to open feed links in a new window.  Example: link_target=”_blank” (Note: this parameter is ignored if you specify a template)
  6. date_format: Date format string for the post date. Valid values are anything acceptable by PHP’s date function.  Example: date_format=”Y-m-d”
  7. template: (added in version 1.3.0) This can be set to 1,2 or 3 and instead of the default HTML output, HungryFEED will use Custom Template 1,2 or 3 (which you can edit in HungryFEED settings) to display the feed.  This allows you to fully customize the way the RSS is displayed.
  8. allowed_tags: (added in version 1.3.3) Use this parameter to strip HTML tags from the RSS Description field.  You can specify the HTML tags that are allowed (will not be stripped) by separating them with a comma.  For example:  allowed_tags=”p,br,a” will strip everything except paragraph marks, line breaks and links.
  9. strip_ellipsis: (added in version 1.3.4) Set this parameter to any value to strip the ellipsis that is added to the end of posts in certain RSS feeds.  Example: strip_ellipsis=”1″
  10. truncate_description: (added in version 1.4.2) Set this parameter to a numeric value to truncate the description field to the specified number of characters.  Example: truncate_description=”150″
  11. filter: (added in version 1.3.5) Specify filter text to include only feed items that contain that text in either the subject or description.  Example: filter=”free”  As of version 1.4.1 you can specify multiple filter terms separated with a pipe, for example: filter=”free|phone|computer”
  12. filter_out: (added in version 1.4.5) Specify filter text to exclude feed items that contain that text in either the subject or description.  Example: filter=”free”  You can specify multiple filter terms separated with a pipe, for example: filter=”free|iphone|computer”
  13. page_size: (added in version 1.3.6) If the RSS feed has a lot of items you can split them up into multiple pages with a previous/next navigation links.  Example: page_size=”10″ (This is beta because I don’t know how it will react with various permalink configurations.  Please post a comment if you find any problems).  Multiple paginated feeds on one page is not supported.  It is highly recommended that you have correctly configured caching if you are using pagination.
  14. order: (added in version 1.4.4) Specify an alternate order for the items in the feed.  Allowed values are “reverse” “random” and “none” (none added in version 1.5.6).  example: order=”reverse”

Debugging Parameters

Debugging parameters may be used to diagnose problems with a feed.  You can use these to force HungryFEED to process your url and display the raw output as it is received.

  1. force_feed: If the server does not send the appropriate HTTP headers when outputting the RSS feed, it may not be properly detected as XML.  However you can specify force_feed=”1″ to force HungryFEED to parse the feed anyway.  If you set this to true, you may see XML errors.
  2. decode_url: HungryFEED attempts to decode the feed URL in order to strip out any formatting that the WordPress visual editor may have added. If your URL is getting mangled, you can set decode_url=”0″ to disable this behavior.
  3. xml_dump: If you have exhausted all troubleshooting options and cannot get a feed to display, you can set xml_dump=”1″ and whatever is being retrieved from the feed server will be output to the browser.  WARNING:  This may cause your browser to freak out!  You will have to look at the page source to make sense of the output.  This can be helpful to see what is being returned from the feed URL in it’s raw form.

Technical Support

Before contacting support, please check to see if your question is answered on the FAQ.

If you have a support question that is not answered on this page, please visit the  HungryFEED Support Forum (make sure your new post “tags” field contains “hungryfeed”).  Please browse the forum to see if your question has been answered before posting.  Feel free to answer questions as well.

Recent Support Forum Posts:

Examples

Source code for various examples can be found on the HungryFEED Example Page

  1. eBay feed at eclair16.com
  2. HungryFEED Recent Support (the bullet list above!)
  3. Feed Description Transformation Examples using selectors

Contribute

HungryFEED is a free, open-source project.  If you would like to get involved, there are several ways:

  1. Rate this plugin on the HungryFEED WordPress Plugin Page (Preferably with 5 stars!)
  2. Post a tip or help somebody with an issue on the support forum.
  3. Contribute source code, graphic design or submit bug reports through the Trac Project Page.
  4. HungryFEED is absolutely free to use, however if you would like to provide financial support and encouragement, I invite you to make a donation directly to SmileTrain.org. I am not affiliated with SmileTrain, however it is my personal favorite charity and I encourage you to read about them and make a donation.

- – -

Looking for a place to post comments…?  Head to the HungryFEED Support Forum.  Are you looking for a previous comment that you posted?  They have been archived here.