記事内に特定カテゴリの新着一覧を出すショートコード

記事の中で新着記事一覧を出したりというプログラムを書けたら便利だと思うことはありませんか？
WordPress標準でショートコードというものがあり、これを使うと記事やページ中で特定のプログラムを呼び出すことが可能になります。
標準で使われているのは、画像ギャラリーを出すための[gallery]とか、キャプション付き画像を出すための[caption]などです。

このショートコードという機能を利用して、独自のプログラムを記事中に埋め込むことが可能です。
ここでは、記事内に特定のカテゴリの新着記事一覧を出力するショートコードの作り方をご紹介します。

まず、テンプレートのfunctions.phpに以下のようにプログラム部分を記述します。

function getCatItems($atts, $content = null) {
	extract(shortcode_atts(array(
		"num" => '5',
		"cat" => ''
	), $atts));
	global $post;
	$oldpost = $post;
	$myposts = get_posts('numberposts='.$num.'&order=DESC&orderby=post_date&category='.$cat);
	$retHtml='<ul>';
	foreach($myposts as $post) :
		setup_postdata($post);  
		$retHtml.='<li><a href="'.get_permalink().'">'.the_title("","",false).'</a></li>';
	endforeach;
	$retHtml.='</ul>';
	$post = $oldpost;
	return $retHtml;
}
add_shortcode("list", "getCatItems");

簡単に解説すると、$attsにショートコードに設定されたパラメータが入ります。
ここでは、numは件数、catはカテゴリIDとしています。

記事中で呼び出すことを想定し、処理中の$post変数は$oldpostに待避しておき、処理終了後に$postに戻します。
処理の中身は、get_postsを使いcatで指定したカテゴリの新着記事をnum件取得して出力するhtmlを返すというだけのシンプルなものです。

functionの外にadd_shortcodeという関数がありますが、これがショートコードをハンドリングして関数を呼び出す役割を果たします。
引数のlistがショートコードの名前、getCatItemsが呼び出されるfunctionの名前です。

実際の呼び出しは、記事中にhtmlモードで、[list cat="1" num="10"]のように書きます。