Home Blog A Better Way to Add RSS Feeds to Your WordPress Blog (Using...

A Better Way to Add RSS Feeds to Your WordPress Blog (Using Shortcode)

October 10, 2017

Add RSS Feeds to WordPress with Shortcode

Prior to version 2.8 of WordPress (and since version 1.5), if you wanted an RSS feed on your WP website you would use wp_rss() … and it works fine. However, support for the very fast and reliable SimplePie library was added in version 2.8 – and it’s a far better option. This article will show you how to added a feed to your WordPress website (with only basic options) and cache the result with the WordPress transient API.

What is an RSS feed? RSS (Rich Site Summary) is a format for delivering regularly changing web content. Many news-related sites, blogs, and other online publishers syndicate their content as an RSS Feed to whoever wants it. All WordPress websites usually have an RSS feed available by default.

The Result

Using the shortcode of [rss feed="http://www.beliefmedia.com/feed" size="3"] we’ll render the three latest posts from this website. The result is as follows:

The Manure Crisis of 1894 (and How it Relates to Mortgage Brokers) - 5th Nov 2018
By the late 19th Century the dawn of the industrial age had presented an interested problem for large cities all around the world – they were “drowning in horse manure”. ...
What Is a Landing Page? - 5th Nov 2018
The landing page is a webpage that is designed with a single purpose: a conversion. You’re looking to return a page free from distraction (so no footers, sidebars, widgets etc.), ...
Broker Responsibilities When They Discover Consumer Fraud - 26th Oct 2018
While updating a document introducing decision making models that we send out to mortgage brokers around the three-week mark of our Broker Marketing Program, we discuss the issue of broker ...

The last three results (without description) from our neglected FLIGHT website may be returned with the shortcode of [rss feed="http://www.flight.org/feed" size="3" heading="h5" excerpt="0"]. The result:

Cold Temperature Altimetry Corrections - 5th Nov 2016
The Boeing 777 Rejected Landing - 10th Aug 2016
Low Missed Approach Altitude Restrictions - 12th Apr 2016

Using our textbox shortcode we can wrap a feed (this time our YouTube RSS feed) with the following result:

+ BeliefMedia on YouTube

Boeing 777 Engine and Driftdown (Simulator) - 26th Sep 2018

ANZ's "The Winners" TV Commercial (1984) - 27th Jul 2018

Qantas' "I Still Call Australia Home" Advert (1997) - 27th Jul 2018

Shortcode Attributes

The following shortcode attributes are available:

feed

The RSS feed you would like to consume. For example: http://www.beliefmedia.com/feed.

size

The number of results to return.

excerpt

If you would like to include an excerpt, use excerpt="30" (where 30 is the number of words to return). To disable the excerpt, use excerpt="0".

more

If an excerpt is included and the text is longer than the defined length, the more text is the trailing dots or other characters of your choosing.

date

To include the date (concatenated to the title), use date="1" (default). To disable, use date="0".

datecss

If using a date you may apply your own style to differentiate it from your title. We use font-weight: normal by default.

dateformat

To format the date output, use dateformat="jS M Y". All available date options are listed in the PHP manual

heading

The heading is the tags wrapped around the post title. We use h4 tags by default.

list

Results are rendered in a list by default. To disable, use list="0".

target

The target is that of the resulting title click. We return the page in a new tab by default.

cache

The cache time should really be set to something longer to 12 hours because this is the default cache value of wp_feed_cache_transient_lifetime

. To alter the feed transient time there’s a sample filter function in the WP codex.

WordPress Shortcode

Copy and paste the WordPress function into your theme's functions.php file or, if you sensibly have one installed, your custom functions plugin.

/*
	A Better Way to Add RSS Feeds to Your WordPress Blog (Using Shortcode)
	http://www.beliefmedia.com/embed-rss-wordpress
*/
	

function beliefmedia_simplepie_rss($atts) {

  $atts = shortcode_atts(array(
    'feed' => 'http://www.beliefmedia.com/feed/',
    'size' => '5',
    'excerpt' => 30,
    'more' => ' ...',
    'date' => 1,
    'datecss' => 'font-weight: normal',
    'dateformat' => 'jS M Y',
    'heading' => 'h4',
    'list' => 1,
    'target' => '_blank', /* _blank, _self etc.. */
    'cache' => 3600 * 6
  ), $atts);

 $transient = 'bmrss_' . md5(serialize($atts));
 $cachedposts = get_transient($transient);

 if ($cachedposts !== false) {
   return $cachedposts;

  } else {

  /* SimplePie RSS parsing engine */
  include_once ABSPATH . WPINC . '/feed.php';

  /* Build the SimplePie object */
  $rss = fetch_feed($atts['feed']);

  /* Check for errors in the RSS XML */
  if (!is_wp_error($rss)) {

     $maxitems = $rss->get_item_quantity($atts['size']);
     $rss_items = $rss->get_items(0, $maxitems);
     $total_entries = count($rss_items);

	$html .= '<p>';
	if ($list) $html .= "<ul class='feedlist'>";

        $i = 1;
	foreach ($rss_items as $item) {

	  $title = $item->get_title();
	  $title = $title . '&nbsp;';
	  $link = $item->get_permalink();
	  $desc = $item->get_description();
	  $date_posted = $item->get_date($atts['dateformat']);

	    if ($atts['excerpt'] !== false) {
	  
              /* http://codex.wordpress.org/Function_Reference/wp_kses */
              $desc = wp_kses(trim($desc), array());
              $desc = strip_tags(apply_filters('the_excerpt', $desc));
              $desc = wp_trim_words($desc, $atts['excerpt'], $atts['more']);
              $desc = trim(preg_replace('!\s+!', ' ', $desc));

	    }

          /* Add item to result */
          if ($atts['list']) {

	    /* Output */
            $html .= '<li id="post-' . $i . '">';
            $html .= '<' . $atts['heading'] . '><a href="' . $link . '" target="' . $atts['target'] . '" title="' . $title . '">' . $title . '</a>';
            if ($atts['date']) $html .= ' - <span class="date" style="' . $atts['datecss'] . ';">' . $date_posted . '&nbsp;</span>';
            $html .= '</' . $atts['heading'] . '>';
            if ($atts['excerpt']) $html .= '<p>' . $desc . '</p>';
            $html .= '</li>';

            } else {

            $html .= '<' . $atts['heading'] . '><a href="' . $link . '" target="' . $atts['target'] . '" title="' . $title . '">' . $title . '</a>';
            if ($atts['date']) $html .= ' - <span class="date" style="' . $atts['datecss'] . ';">' . $date_posted . '&nbsp;</span>';
            $html .= '</' . $atts['heading'] . '>';
            if ($atts['excerpt']) $html .= '<p>' . $desc . '</p>';

          }

         $i++;
        }

        $html = ($atts['list']) ? '<p><ul class="feedlist">' . $html . '</ul></p>' : '<p>' . $html . '</p>';

        } else {

        $html = '<p>Error. Visit the feed <a href="' . $feed . '">here</a>.</p>';
   }

  set_transient($transient, $html, $atts['cache']);
  return $html;
 } 
}
add_shortcode('rss', 'beliefmedia_simplepie_rss');

100

A Better Way to Add RSS Feeds to Your WordPress Blog (Using Shortcode)

http://www.beliefmedia.com/embed-rss-wordpress

function beliefmedia_simplepie_rss($atts) {

$atts = shortcode_atts(array(

'feed' => 'http://www.beliefmedia.com/feed/',

'size' => '5',

'excerpt' => 30,

'more' => ' ...',

'date' => 1,

'datecss' => 'font-weight: normal',

'dateformat' => 'jS M Y',

'heading' => 'h4',

'list' => 1,

'target' => '_blank', /* _blank, _self etc.. */

'cache' => 3600 * 6

), $atts);

$transient = 'bmrss_' . md5(serialize($atts));

$cachedposts = get_transient($transient);

if ($cachedposts !== false) {

return $cachedposts;

} else {

/* SimplePie RSS parsing engine */

include_once ABSPATH . WPINC . '/feed.php';

/* Build the SimplePie object */

$rss = fetch_feed($atts['feed']);

/* Check for errors in the RSS XML */

if (!is_wp_error($rss)) {

$maxitems = $rss->get_item_quantity($atts['size']);

$rss_items = $rss->get_items(0, $maxitems);

$total_entries = count($rss_items);

$html .= '';

if ($list) $html .= "<ul class='feedlist'>";

$i = 1;

foreach ($rss_items as $item) {

$title = $item->get_title();

$title = $title . ' ';

$link = $item->get_permalink();

$desc = $item->get_description();

$date_posted = $item->get_date($atts['dateformat']);

if ($atts['excerpt'] !== false) {

/* http://codex.wordpress.org/Function_Reference/wp_kses */

$desc = wp_kses(trim($desc), array());

$desc = strip_tags(apply_filters('the_excerpt', $desc));

$desc = wp_trim_words($desc, $atts['excerpt'], $atts['more']);

$desc = trim(preg_replace('!\s+!', ' ', $desc));

}

/* Add item to result */

if ($atts['list']) {

/* Output */

$html .= '<li id="post-' . $i . '">';

$html .= '<' . $atts['heading'] . '><a href="' . $link . '" target="' . $atts['target'] . '" title="' . $title . '">' . $title . '</a>';

if ($atts['date']) $html .= ' - ' . $date_posted . ' ';

$html .= '</' . $atts['heading'] . '>';

if ($atts['excerpt']) $html .= '' . $desc . '';

$html .= '</li>';

} else {

$html .= '<' . $atts['heading'] . '><a href="' . $link . '" target="' . $atts['target'] . '" title="' . $title . '">' . $title . '</a>';

if ($atts['date']) $html .= ' - ' . $date_posted . ' ';

$html .= '</' . $atts['heading'] . '>';

if ($atts['excerpt']) $html .= '' . $desc . '';

}

$i++;

}

$html = ($atts['list']) ? '<ul class="feedlist">' . $html . '</ul>' : '' . $html . '';

} else {

$html = 'Error. Visit the feed <a href="' . $feed . '">here</a>.';

}

set_transient($transient, $html, $atts['cache']);

return $html;

}

add_shortcode('rss', 'beliefmedia_simplepie_rss');

If you require shortcode to work in a sidebar widget, you'll have to enable the functionality with a filter. If you're using our custom functions plugin, you'll have that feature enabled by default.

Considerations

This function is ported from the now retired Internoetics with only minor modifications. It could do with an update!

Download

Title: Add RSS Feeds to WordPres
Description: A Better Way to Add RSS Feeds to Your WordPress Blog (Using Shortcode).
Download: Shortcode (V0.2) | | Plugin Page

Shortt URL for this post: http://shor.tt/17N9

A Better Way to Add RSS Feeds to Your WordPress Blog (Using Shortcode)

The Result

The Manure Crisis of 1894 (and How it Relates to Mortgage Brokers) - 5th Nov 2018

What Is a Landing Page? - 5th Nov 2018

Broker Responsibilities When They Discover Consumer Fraud - 26th Oct 2018

Cold Temperature Altimetry Corrections - 5th Nov 2016

The Boeing 777 Rejected Landing - 10th Aug 2016

Low Missed Approach Altitude Restrictions - 12th Apr 2016

Boeing 777 Engine and Driftdown (Simulator) - 26th Sep 2018

ANZ's "The Winners" TV Commercial (1984) - 27th Jul 2018

Qantas' "I Still Call Australia Home" Advert (1997) - 27th Jul 2018

Shortcode Attributes

WordPress Shortcode

Considerations

Download

LEAVE A REPLY Cancel reply

OUR LATEST ARTICLES

The Manure Crisis of 1894 (and How it Relates to Mortgage...

What Is a Landing Page?

Broker Responsibilities When They Discover Consumer Fraud

Royal Commission into Misconduct in the Banking, Superannuation and Financial Services...

Create Simple Responsive Landing Page Columns In WordPress

Follow @BeliefMedia on Social

LATEST BELIEFMEDIA NEWS

Sending Telstra SMS Messages (And The New BeliefMedia Platform)

LATEST MARKETING ARTICLES

The Manure Crisis of 1894 (and How it Relates to Mortgage...

What Is a Landing Page?

Build Naked Landing Pages In WordPress