WordPressでショートコードを使って新着記事一覧を表示してみよう！

みなさん，こんにちは。
シンノユウキ（shinno1993）です。

今回はWordPressでショートコードを使って，新着記事一覧を表示する方法を紹介します．

では行きましょう！

前回のまとめ：ショートコードで年齢の表示
コードはこちら
get_posts：記事一覧を取得する関数
$postsをforeachでループ
$strにHTMLタグやタイトルを格納していく
最後はリセット
まとめ
連載目次

前回のまとめ：ショートコードで年齢の表示

まずは前回のまとめから振り返っていきましょう．

前回の記事はこちらです：

WordPressでショートコードを使って自分の年齢を表示してみよう！

今回はWordPressでショートコードを使って，記事中に自分の年齢を表示する方法を紹介します．記事中に年齢を表示する需要はそれほど大きくないかもしれませんが，動的なテキストを生成する例として紹介したいと思います．では行きましょう！前回...

前回は年齢を表示するためのショートコードを紹介しました．以下のコードをfunctions.phpに追加しましたね：

function calc_age_func(){
	$now = date("Ymd");
	$birth = "19930125";
	return floor(($now-$birth)/10000);
}
add_shortcode('age', 'calc_age_func');

年齢を表示する関数：cacl_age_funcを作成し，ショートコード：[age] から呼び出してみましたね．

このように，ショートコード化しておくと年齢が更新される度に（年をとる度に）更新するという手間を減らすことができます．

今回はそこからやや発展して，ブログの新着記事一覧を表示するコードを紹介したいと思います．

コードはこちら

最初にコードを紹介しておきます．以下のコードをfunctions.phpに追加することで，新着記事一覧を表示するショートコードを追加できます：

function add_new_list_func($atts){
	$str = '<ul>';
	global $post;
	$arg   = array(
		'posts_per_page' => 5,
    	'orderby'        => 'date', 
    	'order'          => 'DESC',
	);
	$posts = get_posts($arg);
	foreach($posts as $post):
		setup_postdata($post);
		$str.='<li>';
		$str.= '<a href="'.get_permalink().'">'.the_title('','',false).'</a>';
		$str.='</li>';
	endforeach;
	$str.='</ul>';
	wp_reset_postdata();
	return $str;
}
add_shortcode('add_new_list', 'add_new_list_func');

これを挿入すると，以下のように新着記事が5記事，リスト形式で表示されます：

[add_new_list]

では，以下でこのコードを詳しく解説していきましょう．

get_posts：記事一覧を取得する関数

はじめに，今回の記事のキモであるget_posts()について紹介しておきます．この関数は投稿した記事の一覧を配列で取得してくれます．

引数に取得する条件などを指定することで，特定の記事のみを取得することができます．今回は引数に$argを指定しています．$argは配列で指定していますが，その中身は以下のようになっています：

posts_per_page：取得する記事の数を指定しています．今回は5記事を取得したいので5を指定しています．
orderby：取得した記事の並び替えを指定します．たとえば，'date'を指定することで日付順に，'title'を指定することでタイトル名で並び替えられます．今回は新着記事一覧を取得したいので，日付で並び替えできる'date'を指定しています．
order：orderbyで指定した並び替えの順序を指定します．'ASC'で昇順，'DESC'で降順です．今回は日付を大きい方から小さい方（降順）に並べたいので，'DESC'を指定しています．

これで新着記事一覧を配列で取得できました！次はこれを順次処理していきます．

$postsをforeachでループ

get_postsを使うことで，$postsに投稿一覧が格納されました．その記事を1つずつ処理していくために，foreach文を用います．$postsに格納されている記事を$postに順次代入していきます．

この$postは3行目でglobal変数として宣言しています．WordPressにおいては，投稿記事をグローバル変数である$postに格納して使用します．それを使うために宣言するのですね．

そして，foreachのループ内でsetup_postdata($post);をしています．これは，$postから記事のidや書いた日，コンテンツの内容などを示すグローバル変数にセットする関数です．これをすることで，セットされたグローバル変数などから，タイトルやURLなどの情報を取得できるようになります．