WordPress.org

1. Unzip the ZIP plugin file
2. Copy the blogroll-widget-rss folder into your wp-content/plugins/ directory
3. Activate the plugin through the 'Plugins' menu in WordPress
4. Go to the Appearance Widgets SubPanel to add the Blogroll Widget with RSS Feeds to your sidebar and configure it

PHP Code and Configuration:

Alternative to the WordPress Appearance Widgets SubPanel you can add and configure the Blogroll Widget with RSS Feeds directly in your theme file (e.g. sidebar.php). In this case call the function <?php show_blogroll_widget_rss(); ?> at the place in your sidebar you want to show it. This will display the Blogroll Widget with RSS Feeds with the default configurations. The widget output starts with <ul><li> and ends with </li></ul>. You can put anything what and as you want around it.

To configure the Blogroll Widget with RSS Feeds in the theme file, please add an array of settings to the function. Following the array with the defaults:

<?php show_blogroll_widget_rss(  array(
    'show_items' => -1, 
    'category' => false,
    'item_order' => 'link_name ASC',
    'show_image' => 'show-no-images',
    'thumb_size' => 50,
    'show_link' => 0,
    'show_link_nf' => 0,
    'feed_items' => 1,
    'shorten_feedlink' => 0,
    's_f_length' => 20,
    'feed_link_nf' => 0,
    'show_summary' => 0,
    'summary_length' => 100 ) ); ?>

PHP configuration options:

• show_items => -1 displays all items, any other number displays the number amount of items
• category => false for all links, otherwise the number of the respective link category id
• item_order => either link_name ASC, or link_name DESC, or link_id ASC, or link_id DESC, or rand()
• show_image => either show-no-images, or show-my-own-images, or create-thumbnails
• thumb_size => any number greater than 10 defines the pixel size of the images
• show_link => 0 = no blogroll links, 1 = display blogroll links
• show_link_nf => 0 = no 'rel=nofollow' attribute is added to blogroll links, 1 = adds 'rel=nofollow' attribute to blogroll links
• feed_items => any number between 1 and 10 defines how many feed post links are displayed
• shorten_feedlink => 0 no feed post link text shortening, 1 = shorten the feed post link text
• s_f_length => number of characters of feed post link text
• feed_link_nf => 0 = no 'rel=nofollow' attribute is added to feed post links, 1 = adds 'rel=nofollow' attribute to feed post links
• show_summary => 0 = no feed post excerpts, 1 = display feed post excerpts
• summary_length => any number between 10 and 999 defines how many characters of the feed post excerpts are displayed

In the array you only need to define the configurations differing to the defaults, for the other configurations the defaults are taken automatically. So if you only want to add the feed post excerpts with 100 characters, your PHP Code would be <?php show_blogroll_widget_rss( array('show_summary' = 1) ); ?>.

Display Blogroll RSS Widget on a single page: If you would like to display the Blogroll RSS Widget on a single page (instead or additionally to the sidebar), you can do this in your page.php theme file. After the code the_content(); you enter the PHP Code of the Blogroll RSS Widget with your individual configuration into a if clause statement group by using the WordPress Page Conditional Tag, e.g. for the single page with the ID 167: if ( is_page('167') ) { your blogroll rss widget code }