WordPress.org

Import and display Feeds in your blog, use PHP, a Widget or the Shortcode. The plugin use the standards of WordPress, non extra library; use MagpieRSS or SimplePie for parse feeds.

Use following code with a PHP-Plugin or in a template, example sidebar.php or single.php, for WordPress:

Example: <?php RSSImport(10, 'http://bueltge.de/feed/'); ?>

This is smallest code for use the plugin with your own feed-url. The plugin have many parameters for custom import of content form a feed. See the list of parameters. You can also use all parameters with shorcode in posts and pages.

Example for Shortcode: [RSSImport display="5" feedurl="http://bueltge.de/feed/"]

For all boolean parameter it is possible to use the string true or false or the integer value 0 or 1.

1. display - How many items, Default is 5
2. feedurl - Feed-Adress, Default is http://bueltge.de/feed/
3. before_desc - string before description, Default is empty
4. displaydescriptions - (bool) true or false for display description of the item, Default is false
5. after_desc - string after description, Default is empty; you can use the follow strings for custom html %title for title of entry and %href for link of entry
6. html - (bool) display description include HTML-tags, Default is false
7. truncatedescchar - truncate description, number of chars, Default is 200, set the value to empty '' for non truncate
8. truncatedescstring - string after truncate description, Default is ...
9. truncatetitlechar - (int) truncate title, number of chars, Default is empty, set a integer 50 to the value for truncate
10. truncatetitlestring - string after truncate title, Default is ' ... '
11. before_date - string before date, Default is <small>
12. date - (bool) return the date of the item, Default is false
13. after_date - string after the date, Default is </small>
14. date_format- your format for the date, leave empty for use format of your WordPress installation, alternativ give the php date string, Example: F j, Y; see also doku in Codex
15. before_creator - string before creator of the item, Default is <small>
16. creator - (bool) return the creator of th item, Default is false
17. after_creator - string after creator of the item, Default is </small>
18. start_items - string before all items, Default is <ul>
19. end_items - string after all items, Default is </ul>
20. start_item - string before the item, Default is <li>
21. end_item - string after the items, Default is </li>
22. target - string with the target-attribut, Default is empty; use blank, self, parent, top
23. rel- string with the rel-attribut, Default is empty, use string, nofollow, follow
24. charsetscan - Scan for charset-type, load slowly; use this for problems with strings on the return content, Default is false
25. debug - activate debug-mode, echo the array of Magpie-Object; Default is false, Use only for debug purpose
26. before_noitems - HTML or string before message, when the feed is empty, Default is <p>
27. noitems- Message, when the feed is empty, Default is No items, feed is empty.
28. after_noitems - HTML or string before message, when the feed is empty, Default is </p>
29. before_error - HTML or string before message, when the feed have an error, Default is <p>
30. error - Errormessage, Default is Error: Feed has a error or is not valid
31. after_error - HTML or string before message, when the feed have an error, Default is </p>
32. paging - Pagination on, set true, Default is false
33. prev_paging_link - Linkname for previous page, Default is « Previous
34. next_paging_link - Linkname for next page, Default is Next »
35. prev_paging_title - Title for the link of previous page, Default is more items
36. next_paging_title - Title for the link of next page, Default is more items
37. use_simplepie- Use the class SimplePie for parse the feed; SimplePie is include with WordPress 2.8 and can parse RSS and ATOM-Feeds, Default is false
38. view - echo or return the content of the function RSSImport, Default is true; Shortcode Default is false

The pagination function add a div with the class rsspaging for design with CSS. Also youcan style the previous and next link with the classes: rsspaging_prev and rsspaging_next.

All parameters it is possible to use in the function, only in templates with PHP, and also with the Shortcode in posts and pges.

Examples:

The 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>'
                    )

The shortcode with a lot of parameters:

[RSSImport display="10", feedurl="http://your_feed_url/", 
displaydescriptions="true", html="true"
start_items="<ol>", end_items="</ol>", paging="true" ]

Localizations

• 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

Please visit the official website for further details and the latest information on this plugin.

Interested in WordPress tips and tricks

You may also be interested in WordPress tips and tricks at WP Engineer or for german people bueltge.de

Author: Bueltge