WordPressの記事一覧とページネーション（ページング）用配列を取得するfunctionを書いてみた

2015-03-12 18:09:39

昨日、WordPressのWP_Queryオブジェクトから、ページネーション（ページング）用の配列を生成するfunctionを作成してみたので、その続き。

WordPressのWP_Queryオブジェクトから、ページネーション（ページング）用の配列を生成するfunction

さらにWordPressの記事一覧も取得するfunctionも作ってみた。

引数パラメータ「$args」を、new WP_Query($args) としてそのまま使えるようにした。

この間に作成した一連のものをAPIにして動かく作戦進行中。

引数とfunction定義

functionの名前は「get_posts_pagenation_org」とした。もちろん名前は任意。
引数については、次の通り。

$args	WP_Query作成時に使用する引数。JSON文字列を混合可。関数リファレンス/WP Query - WordPress Codex 日本語版参照
$range	pagenation_org()で使用するrange。詳しくは前回記事を参照
$obj_return	返り値に作成したWP_Queryも含める場合はtrueにする

functions.phpに追加で記述するfunction

function get_posts_pagenation_org($args = array(), $range = 'all', $obj_return = false){

//【A】準備 ==============================================================================

	// 返り値用変数
	$return_val = false;
	
	// $argsにJSON文字列を受け取った場合は、配列に戻す
	if(@strlen($args)){
		//@をつけてエラー回避
		$args = @json_decode($args);
	}
	// $argsは配列に強制
	if(!is_array($args)){
		$args = array();
	}
	
	// $argsでrangeの設定を受け取った場合は、そちらを優先
	if(isset($args["range"])){
		$range = $args["range"];
	}

WP_Queryオブジェクトを作成

引数$argsからWP_Queryオブジェクトを作成する部分を記述する。
ここでは初期値として、$post_per_page（１ページに表示する数）とソート指定をした。

$argsに設定できる項目については、関数リファレンス/WP Query - WordPress Codex 日本語版を参照。

また、JSON文字列が設定されている場合は、配列に戻す処理も含めた。


//【B】WP_Queryオブジェクトを作成 ========================================================

// 【B-1】WP_Query生成用クエリ作成
//　　　　初期値を設定
	$def_args = array();
	global $post_per_page;
	$def_args['post_per_page'] = $post_per_page; //１ページに表示する数(取得する数)
	$def_args['orderby']       = "date"; //１ページに表示する数(取得する数)
	$def_args['order']         = "DESC"; //１ページに表示する数(取得する数)
	
	foreach($def_args as $k => $v){
		if(!isset($args[$k])){
			$args[$k] = $v;
		}
	}
	
// 【B-2】$argsでJSON文字列を受け取った場合は、配列に変換
	foreach($args as $k => $v){
		// @をつけて、エラーを回避
		if($v = @json_decode($v,true)){
			$args[$k] = $v;
		}
	}
	
// 【B-3】WP_Queryオブジェクトを作成する
	$wp_query_org = new WP_Query($args);

記事一覧を取得

作成したWP_Queryオブジェクトから、記事一覧部分を取り出す。
さらに、記事毎に必要な情報を設定する。ここでは、パーマリンクとアイキャッチのサムネイルを取得するように記述してみた。

// 【C】記事を取得する ===================================================================
	$posts = $wp_query_org->posts;

	// オブジェクトを配列に変換
	$posts = json_encode($posts);
	$posts = json_decode($posts,true);

	foreach(array_keys($posts) as $i){
		// 各記事のパーマリンクを追加取得
		$posts[$i]["url"] = get_permalink($posts[$i]['ID']);
	
		//各記事のサムネイル（アイキャッチ）を取得
		$posts[$i]["thumbnail"] = false; //初期値
		if($thumb_id = get_post_thumbnail_id($posts[$i]['ID'])){
			if($tmp = wp_get_attachment_image_src($thumb_id, 'thumbnail')){
				$posts[$i]["thumbnail"]        = $tmp[0]; // 画像URL
				$posts[$i]["thumbnail_url"]    = $tmp[0]; // 画像URL
				$posts[$i]["thumbnail_width"]  = $tmp[1]; // 画像サイズ：横
				$posts[$i]["thumbnail_height"] = $tmp[2]; // 画像サイズ：縦
			}
		}
	}

ページネーション（ページング）を取得

WP_Queryから前回作成したfunction「pagenation_org()」を使用して、ページネーション（ページング）用の配列を取得する。
pagenation_org()について、詳しくは前回の記事を参照。

// 【D】ページネーション（ページング）を取得する =========================================
	$pagenation = pagenation_org($wp_query_org,$range);


返り値の設定、終了

取得・作成したものを返して、functionは終了。

$obj_returnがtrueの場合は、WP_Queryオブジェクトを含めて返す。



//	【E】返す値を設定する
	$return_val = array();
	$return_val['posts']      = $posts;
	$return_val['pagenation'] = $pagenation;
	
	//wp_queryオブジェクトも返す場合は追加
	if($obj_return){
		$return_val['wp_query'] = $wp_query_org;
	}
		
	return $return_val;
}

ソースコード

続けて記述すると、以下の様になる。
このfunctionを（前回作成したpagenation_org()と合わせて）functions.phpに記述して定義しておく。


function get_posts_pagenation_org($args = array(), $range = 'all', $obj_return = false){

//【A】準備 ==============================================================================

	// 返り値用変数
	$return_val = false;
	
	// $argsにJSON文字列を受け取った場合は、配列に戻す
	if(@strlen($args)){
		//@をつけてエラー回避
		$args = @json_decode($args);
	}
	// $argsは配列に強制
	if(!is_array($args)){
		$args = array();
	}
	
	// $argsでrangeの設定を受け取った場合は、そちらを優先
	if(isset($args["range"])){
		$range = $args["range"];
	}

//【B】WP_Queryオブジェクトを作成 ========================================================

// 【B-1】WP_Query生成用クエリ作成
//　　　　初期値を設定
	$def_args = array();
	$def_args['post_per_page'] = $post_per_page; //１ページに表示する数(取得する数)
	$def_args['orderby']       = "date"; //１ページに表示する数(取得する数)
	$def_args['order']         = "DESC"; //１ページに表示する数(取得する数)
	
	foreach($def_args as $k => $v){
		if(!isset($args[$k])){
			$args[$k] = $v;
		}
	}
	
// 【B-2】$argsでJSON文字列を受け取った場合は、配列に変換
	foreach($args as $k => $v){
		// @をつけて、エラーを回避
		if($v = @json_decode($v,true)){
			$args[$k] = $v;
		}
	}
	
// 【B-3】WP_Queryオブジェクトを作成する
	$wp_query_org = new WP_Query($args);


// 【C】記事を取得する ===================================================================
	$posts = $wp_query_org->posts;

	// オブジェクトを配列に変換
	$posts = json_encode($posts);
	$posts = json_decode($posts,true);

	foreach(array_keys($posts) as $i){
		// 各記事のパーマリンクを追加取得
		$posts[$i]["url"] = get_permalink($posts[$i]['ID']);
	
		//各記事のサムネイル（アイキャッチ）を取得
		$posts[$i]["thumbnail"] = false; //初期値
		if($thumb_id = get_post_thumbnail_id($post_id)){
			if($tmp = wp_get_attachment_image_src($thumb_id, 'thumbnail')){
				$posts[$i]["thumbnail"]        = $tmp[0]; // 画像URL
				$posts[$i]["thumbnail_url"]    = $tmp[0]; // 画像URL
				$posts[$i]["thumbnail_width"]  = $tmp[1]; // 画像サイズ：横
				$posts[$i]["thumbnail_height"] = $tmp[2]; // 画像サイズ：縦
			}
		}
	}


// 【D】ページネーション（ページング）を取得する =========================================
	$pagenation = pagenation_org($wp_query_org,$range);


//	【E】返す値を設定する
	$return_val = array();
	$return_val['posts']      = $posts;
	$return_val['pagenation'] = $pagenation;
	
	//wp_queryオブジェクトも返す場合は追加
	if($obj_return){
		$return_val['wp_query'] = $wp_query_org;
	}
		
	return $return_val;
}

返り値サンプル

この後、前回作成したpagenation_org()と今回作成したget_posts_pagenation_org()の２つのfunctionを使用して、使い勝手のいいAPIや固定ページで記事一覧を取得できるものを作っていく作戦です。

共有: