Peter Mumford’s WordPress Dev Blog

Problem Solving for Website Owners and Designers

—by a guy who loves WordPress. And I also love Jekyll. This blog is made with Jekyll. Its hosted at my Github account.

I live in Somerville, MA.

I like to sail boats, play chess, and read novels.


A Simple Related Posts Widget

December 2, 2013

If you want to put some related posts in a widget you can use the smart YARPP plugin. Or, if you merely want to list posts with matching tags, you can put a function in your Wordpress theme, or make your own plugin.

In some ways this is better than the fuzzy logic of YARPP because it gives you more control: you just give posts the same tag, and you know they are related. Plus, its easy to edit such simple code to suit (if you know how the loop works).

Try this function to start:

// This function will list three posts in the sidebar with like tags.
// Activated by the shortcode [related-posts]
function related_posts_widget() {
	global $post;
	$tags = wp_get_post_tags( $post->ID );
	foreach ( $tags as $tag ) {
		$tagID[] = $tag->term_id;
	if ($tagID) {
		$args = array(
			'tag__in' => $tagID,
			'post__not_in' => array($post->ID),
			'showposts' => 3
		$related_query = new WP_Query($args);
		if( $related_query -> have_posts() ) { ?>
			<?php while ($related_query -> have_posts()) : $related_query -> the_post(); ?>
					<a href="<?php the_permalink(); ?>" title="<?php the_title_attribute(); ?>" rel="bookmark">
					<?php the_title(); ?>
			<?php endwhile; ?>
		<?php }
	$output = ob_get_contents();
	return $output;

Also, for this to work you need to be able to put shortcodes in widgets, which does not work with the default WP installation. To enable shortcodes in widgets add this to your functions.php: add_filter('widget_text', 'do_shortcode');