Display feeds in your blog, using PHP, a Widget or Shortcode. The plugin uses only standard WordPress functionality, so no external libraries are required. For older versions of WordPress, the built-in MagpieRSS library is used. For WordPress 2.8 and newer, there is a setting available to enable the built-in SimplePie library for parsing feeds.
As with all other content you publish, make sure you are allowed to (re-)publish the content of the feeds you are about to import!
You can insert the following code into a PHP plugin or in a template, for example
<?php RSSImport(10, ‘http://bueltge.de/feed/’); ?>
This is the minimal code needed for using the plugin. The plugin accepts a number of parameters for customizing the feed content import. See below for the full list of available parameters. You can also use any of the parameters with Shortcode in posts and pages.
[RSSImport display=”5″ feedurl=”http://bueltge.de/feed/” use_simplepie=”true”]
For all (bool) parameters you can either use the strings
false or the integer values
display– The number of items to display. Default is
feedurl– The feed address. Default is
before_desc– The HTML or string to insert before the description. Default is
empty. You can use some variables which will be replaced, see below.
displaydescriptions– (bool) When set to true, the description for each entry will be displayed. Default is
after_desc– The HTML or string to insert after the description. Default is
empty. You can use some variables which will be replaced, see below.
html– (bool) When set to true, the description can include HTML tags. Default is
truncatedescchar– The maximum number of characters allowed in descriptions. If the description is longer than this length, it will be truncated to the given length. Default is
200, set the value to empty quotes
''to never truncate descriptions.
truncatedescstring– The HTML or string to insert at the end of a description after it has been truncated. Default is
truncatetitlechar– The maximum number of characters allowed in titles. If the title is longer than this value, it will be truncated to the given length. Default is
'', which means never truncate titles.
truncatetitlestring– The HTML or string to insert at the end of a title after it has been truncated. Default is
' ... '.
before_date– The HTML or string to insert before the date. Default is
date– (bool) If true, display the date of the item. Default is
after_date– The HTML or string to insert after the date. Default is
date_format– The date format string. Leave empty to use the format of your WordPress installation. If a different date format is desired, specify a PHP date string, for example:
F j, Y. See also the date and time formatting page in the WordPress Codex.
before_creator– The HTML or string to insert before the creator of the item. Default is
creator– (bool) If true, display the creator of the item. Default is
after_creator– The HTML or string to insert after creator of the item. Default is
start_items– The HTML or string to insert before the list of items. Default is
end_items– The HTML or string to insert after the list of items. Default is
start_item– The HTML or string to insert before each item. Default is
<li>. You can use some variables which will be replaced, see below.
end_item– The HTML or string to insert after each item. Default is
</li>. You can use some variables which will be replaced, see below.
target– The string to use for the
targetattribute on links. Default is
empty. Valid options are
rel– The string to use for the
relattribute on links. Default is
empty. Valid options are
desc4title– The description to use in the
titleattribute on item title links. Default is
charsetscan– (bool) If true, scan the feed content for the correct character set. This may cause the content to load more slowly. Use this option if you’re having problems with feed content being displayed with stranged characters. Default is
debug– (bool) If true, activate debug-mode, which will echo the Magpie object as an array. Default is
false. Only use this option for debugging.
before_noitems– The HTML or string to insert before the no items message. Default is
noitems– The message to display when the feed is empty. Default is
No items, feed is empty..
after_noitems– The HTML or string to insert before the no items message. Default is
before_error– The HTML or string to insert before the error message. Default is
error– Error message displayed when there is an error loading or displaying the feed. Default is
Error: Feed has an error or is not valid.
after_error– The HTML or string to insert before the error message. Default is
paging– (bool) If true, enable pagination. Default is
prev_paging_link– The name of the previous page link. Default is
next_paging_link– The name next page link. Default is
prev_paging_title– The title attribute of the previous page link. Default is
next_paging_title– The title attribute of the next page link. Default is
use_simplepie– (bool) If true, use SimplePie to parse the feed. SimplePie is included in WordPress 2.8 and newer and can parse both RSS and ATOM feeds. Default is
falseif used with Shortcode,
trueif used with the PHP function.
view– (bool) If true, calling the
RSSImport()function will print the rendered HTML directly to the output. If false, the rendered HTML will be returned by the function as a string value and nothing will be output. Default when using PHP code is
true. Default when using Shortcode is
end_item accepts the following variables which will be replaced:
%title%for the title of the entry
%href%for the entry’s URL
%picture_url%for the URL of a thumbnail image for the entry if available. To use this variable, SimplePie is required to be enabled (
If pagination is enabled, it adds a
div with the class
rsspaging to enable easier styling with CSS. You can also style the previous and next links, which have the classes:
You can use any of the parameters in the php function
RSSImport() in your templates or with the Shortcode
[RSSImport] in posts and pages.
Using the PHP function with many parameters:
RSSImport( $display = 5, $feedurl = 'http://bueltge.de/feed/', $before_desc = '', $displaydescriptions = false, $after_desc = '', $html = false, $truncatedescchar = 200, $truncatedescstring = ' ... ', $truncatetitlechar = '', $truncatetitlestring = ' ... ', $before_date = ' <small>', $date = false, $after_date = '</small>', $before_creator = ' <small>', $creator = false, $after_creator = '</small>', $start_items = '<ul>', $end_items = '</ul>', $start_item = '<li>', $end_item = '</li>' );
Please note that for the PHP function the parameters are expected in the order in which they are defined in the above list. Thus if you skip one parameter, you will also have to skip all of the subsequent parameters.
Using Shortcode with several parameters:
[RSSImport display="10" feedurl="http://your_feed_url/" displaydescriptions="true" html="true" start_items="<ol>" end_items="</ol>" paging="true" use_simplepie="true"]
Add a “more” link to the output:
RSSImport( $display = 5, $feedurl = 'http://bueltge.de/feed/', $before_desc = '', $displaydescriptions = true, $after_desc = ' <a href="%href%" target="_blank">show more</a>' );
[RSSImport feedurl="http://www.ichdruck3d.de/feed/" after_desc=" <a href='%href%' target='_blank'>show more</a>" displaydescriptions="true" use_simplepie="true"]
Enable Thumbnail Pictures:
RSSImport( $display = 5, $feedurl = 'http://www.thestage.co.uk/opinion/shenton/feed/', $before_desc = '<img src="%picture_url%" alt="">', $displaydescriptions = true );
[RSSImport feedurl="http://www.thestage.co.uk/opinion/shenton/feed/" displaydescriptions="true" before_desc="<div><img src='%picture_url%' width='50px' alt='' style='float:left;' />" after_desc="</div>" use_simplepie="true"]
- German language files by me Frank Bültge 😉
- Russian translation by Fat Cow
- Ukrainian translation by WordPress Ukraine
- French translation by Martin Korolczuk
- Hungarian translation by Feriman
- Hindi translation by Ashish Jha
- Italian translation by Gianni Diurno
- Romanian language files, thanks to Alexander Ovsov
- Lithuanian translation files by Vincent G
- Portuguese translation files by Miguel Patricio Angelo
Good news, this plugin is free for everyone! Since it’s released under the GPL, you can use it free of charge on your personal or commercial blog. But if you enjoy this plugin, you can thank me by leaving a small donation for the time I’ve spent writing and supporting this plugin. And I really don’t want to know how many hours of my life this plugin has already eaten 😉
The plugin comes with various translations, please refer to the WordPress Codex for more information about activating the translation. If you want to help to translate the plugin to your language, please have a look at the sitemap.pot file which contains all defintions and may be used with a gettext editor like Poedit (Windows).
- Unpack the download package.
- Upload all files to the
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- Create a new site in WordPress or edit your template.
- Copy the code into the site content or add it to your templates.
I tried quite a few rss feeders. A lot of them didn’t work but this one did. Plus I absolutely love that they didn’t auto style the feed, I had overriding styling.
A way to wrap the title in an HTML tag.
A way to make the title NOT be a link.
Alternate ways of reading the RSS, such as in reverse order or random order, or filtered by category.
rss-import: It is intuitive and easily managed. i am overwhelmed by this great plugin: this RSS-Feed plugin is truely outstanding!!!
i have to confess: this is truely one of the very best WordPress rss-feed plugins.
Super easy to use and super-super powerful. You can do alot with this plugin. I have tried other solutions but this is as to close perfect as we have found, It offers everything we wanted so far so, and if we need more there are paid extensions at reasonable cost.
I ve testet many ones; here some features that have convinced me – i am satisfied..
The installation of the rss-import: it is easy – the first steps were done in a few minutes: you do not have to worry about it nor trouble to do such repetitive tasks.
Just pick categories which suit your site and it will work.
The rss-import-plugin shows feeds on your WordPress posts and pages.
it is ….:
– Very easy to use and simplicity enables me to start using it almost immediately after installed it.
– Very easy to search a specific feed and fetch it,
And last but not least: Support is overwhelming: – the develoer rocks!!! Frank Bueltge the impsyde guys and took77 have provided a great documentation
conclusio; rss-import – this plugin is for many many users – and for every one who wants to run an rss-aggregator.
A trillion thanks to Frank Bueltge the impsyde guys and took77 for developing and release this plugin for free!
I had a very positive experience working with the developers and their rss-import-plugin. They went above and beyond to steadily
reach out and communicate with me, provide great documentation – and the best of all – they answer very very quick if you e-mail them.
keep up this super-work!!! Thousands of wordpress-fans from all over the globe were happy with this plugin…
I spend some time to put all parameters in RSSImport function (all required in order to specify $use_simplepie to display featured image) But after that still no image appear.
In addition there is no option to format date and for french one the result is “0010 lundiMonday” Sorry for the bad rate but a 5 stars average rating seem a little misleading.
It would be great to have more configuration options.
- Fall-back if picture not found in enclosure
- Set default picture if no one found
- Crop pictures to predefined width and height
Good work team! It is exactly what i needed and you made a great job with it! Thank you!
Contributors & Developers
“RSSImport” is open source software. The following people have contributed to this plugin.Contributors
- Fix for usage under php 7*
- Code Formatting, WP Codex
- You should always use SimplePie library as Feed Parser – check your parameter.
- Fix the widget PHP4 style
- Fix typo in readme
- Fix a bug with
- Shortened some over-long lines in the code
- Set simplepie to default settings; is the default way of WP since lot of versions
- Fix for Quicktag on Post/Page Editor; use now the core functions, there we have since WP 3.3
- Bugfix: restored RSSImport QuickTag for WordPress 3.3 and later
- Improvement: avoid PHP-notice when description is missing for an item
- TODO: add parameter to allow prefix of url (see https://wordpress.org/support/topic/plugin-rssimport-fix-for-headline-links-without-full-paths)
- TODO: check documentation of call to function (PHP), see https://wordpress.org/support/topic/plugin-rssimport-change-feed-display
- Documentation: corrected ‘after_desc’ (thanks to elricky for reporting)
- Bugfix: noitems string display is back
- Improvement: html_entity_decode feedurl when using shortcodes
- Maintenance: Add romanian language files
- Bugfix: add param desc4title on shortcodes
- Bugfix: Filter Feed-Url vor masked
&; now works Yahoo Pipes feeds
- Maintenance: Translate strings from options
- Feature: add new param
desc4titleto add the description to title-attribut on title-links
- Bugfix: target parameter in widget
- Maintenance: rescan/rewrite de_DE language file
- Maintenance: rescan .pot
- small changes for better debugging
- change metadata for WordPress
- multilanguage plugin-description
- change error-handling on feeds; use WP-Error
- bugfix widget parameter for description
- small changes on source
- add function for WordPress lower version 2.8
- add option for format the date
- bugfix Widget-title
- include class SimpliePie for alternative parse
- new parameter
$use_simplepiefor active parse with class SimplePie
- change for boolean type, possible to use
- change updatenotice to standard WP
- add strings %title% and %href% to replace in after-desc-option
- Bugfix for utl-value on shortcode
- change clean the title-attribut an links for multilanguage-support
- add rel attribut for links
- add widget support, WP 2.8 and higher
See on the official website for older entries on changelog.