Jetpack by WordPress.comの情報を取得して人気記事を表示する

WordPress.comの統計情報データって日付で区切れるし結構有用性高いよなー、このデータって取得できないのかなーと思っていたら出来ました！ヽ(ﾟ∀ﾟ)ﾉ それを使って関数とか作ってみたのでメモがてら。

これまでの紆余曲折

だいぶ前から人気記事表示には手を焼いておりまして、2012年末あたりに初めて導入したのがWordpress Popular Posts。調べてみたら一番情報が多かったという理由でした。それが2013年7月頃、サムネイル表示に指定した大きさの画像が自動生成されるという仕様になったことによりWP-PostViewsへ移行。同じレイアウトになるようにごねごね。

問題はなかったのですが、WP-PostViewsはプラグインを有効にしてから全期間の統計しか取得できないので、どうしてもランキングが固定されてしまい、いつ見ても同じ記事しか表示されないのがちょっと気になってくる。週間や月間などで範囲を区切れたほうが変動が見えて良いなぁと、2014年3月頃またWordpress Popular Postsに戻って画像生成がされないようカスタマイズして使用。

しばらく問題なく動いていたように見えたものの、明らかに人気のなさそうな記事が上位にきたり、精度がイマイチな気が…。前使ってたときはあまり気にならなかったんだけどなぁ。記事数が増えて、botとかも増えたのかもしれない。

WordPress.com 統計情報のデータは使えないのか

なんか良い方法ないかなーと思ってふと気づいたのが、以前から入れていたこちらのプラグイン。

• WordPress › Jetpack by WordPress.com « WordPress Plugins

盛りだくさんの機能が使えるプラグインですが、この中の「WordPress.com 統計情報」を非常に重宝しておりまして。特にこのリファラー。

GoogleAnalyticsよりも簡単に見れて、リンクも貼ってあるのでとっても見易いんです。「おお、こんなところからアクセスが！」っていうのが楽しいので、よく見てます。

この統計情報、人気記事や検索キーワード、クリックしたリンクなども詳細に見ることができます。

人気記事もこのように表示できて、日付で区切る機能がある…ッ！精度も問題ないし、このデータ使いたいー！！

しかしながら、このプラグインはWordPress.comと連携しているので、データはそっちのデータベースに格納されてるようです。そのおかげでブログに負荷をかけずに使えてとっても良いのですが、どうにかそのデータは持ってこれないものかなぁと調べてみたら、

• 恵方巻きの具 » Blog Archive » Jetpack のみで人気TOP10を表示する

(( ﾟдﾟ)ｶﾞﾀｯ　　で　き　る　ぞ　ッ　！！！

試してみる

<?php $top_posts = stats_get_csv( 'postviews', 'days=7&limit=10' ); ?>

参考にさせていただいたコードで、期間は1週間（7日間）、10件の人気記事を取得してみる。

<?php var_dump($top_posts); ?>

試しに取得した配列の中身を見てみると、

でたー！(*ﾟДﾟ*)

投稿ID、タイトル、パーマリンク、閲覧数が入ってる！なんて素敵なんだ！！トップページは投稿IDがゼロになるみたいだし、これを除外してやれば十分使えるぞ…！

というわけで、これを使って、パラメータを変更して使える関数を作ってみました。

日数と件数を指定して取得

functions.php

function my_pop_list( $target_days, $n ) {
	$i = 0;
	$args = array( 'days'=>$target_days, 'limit'=>$n+2 );
	$top_posts = stats_get_csv( 'postviews', $args );
	echo "<ol>\n";
	foreach ( $top_posts as $value ) {
		$my_id = $value['post_id']; //投稿ID取得
		if ( $my_id != 0 && $my_id != get_the_ID() && get_post_type($my_id) == 'post' ) { //homeと現在のページは除外で、投稿のみ
			if( has_post_thumbnail($my_id) ) { //サムネイルの有無
				$pop_img = get_the_post_thumbnail( $my_id, array(100, 100), array('alt'=>get_the_title($my_id)) );
			} else {
				$pop_img = '<img src="noimage.png" width="100" height="100" />';
			}
			echo '<li><a href="'.$value['post_permalink'].'">'.$pop_img.$value['post_title'].'</a>('.$value['views']."views)</li>\n";
			$i++;
			if ( $i >= $n ) { break; } //指定数を超えたら終了
		}	
	}
	echo "</ol>\n";
}

変数で指定された期間と件数分の、サムネイル、リンク付きタイトル、閲覧数をolリスト形式で出力します。

3行目で件数（$n）+2 件になっているのは、除外するページを考慮しているためです。例えば5件表示したいのに、5位以内に除外ページ（現在のページやトップページなど）が入っていたら、5件分に足りなくなってしまうからです。除外するページがなければ +2 は不要です。

8行目に「homeと現在のページは除外、投稿記事のみ」という条件が書いてありますので、お好みで調整してください。

追記：取得できない場合はメンテナンス中表示

function my_pop_list( $target_days, $n ) {
	$i = 0;
	$args = array( 'days'=>$target_days, 'limit'=>$n+2 );
	$top_posts = stats_get_csv( 'postviews', $args );
	if ( !$top_posts ) {
		echo "<p>只今メンテナンス中です。</p>\n";
	} else {
		echo "<ol>\n";
		foreach ( $top_posts as $value ) {
			$my_id = $value['post_id']; //投稿ID取得
			if ( $my_id != 0 && $my_id != get_the_ID() && get_post_type($my_id) == 'post' ) { //homeと現在のページは除外で、投稿のみ
				if( has_post_thumbnail($my_id) ) { //サムネイルの有無
					$pop_img = get_the_post_thumbnail( $my_id, array(100, 100), array('alt'=>get_the_title($my_id)) );
				} else {
					$pop_img = '<img src="noimage.png" width="100" height="100" />';
				}
				echo '<li><a href="'.$value['post_permalink'].'">'.$pop_img.$value['post_title'].'</a>('.$value['views']."views)</li>\n";
				$i++;
				if ( $i >= $n ) { break; } //指定数を超えたら終了
			}	
		}
		echo "</ol>\n";
	}
}

たまに jetpack 側の不具合で一時的にデータを取ってこれないこともあるので、こうやって書いておくと親切かもです。

任意のファイル（single.phpなど）

<?php my_pop_list( 7, 5 ); ?>

上記の関数を呼び出したい場所でこう書きます。期間、件数の順で指定します。この例だと7日間の人気記事を5件取得します。

更に特定のカテゴリで絞り込みたい場合

functions.php

function my_pop_cat_list( $target_days, $target_cat, $n ) {
	$i = 0;
	$args = array( 'days'=>$target_days, 'limit'=>100 );
	$top_posts = stats_get_csv( 'postviews', $args );
	echo "<ol>\n";
	foreach ( $top_posts as $value ) {
		$my_id = $value['post_id']; //投稿ID取得
		if ( $my_id != 0 && $my_id != get_the_ID() && get_post_type($my_id) == 'post' ) { //homeと現在のページは除外で、投稿のみ
			$cat_ids = wp_get_post_categories( $my_id, 'fields=ids' ); //カテゴリ－ID配列
			$cat_flg = false; //フラグリセット
			foreach ( $cat_ids as $cat_id ) { //該当カテゴリIDが対象カテゴリIDに含まれるか
				if ( in_array($cat_id, $target_cat) ) { $cat_flg = true; }
			}
			if ( $cat_flg ) { //対象のものだけ
				if( has_post_thumbnail($my_id) ) { //サムネイルの有無
					$pop_img = get_the_post_thumbnail( $my_id, array(100, 100), array('alt'=>get_the_title($my_id)) );
				} else {
					$pop_img = '<img src="noimage.png" width="100" height="100" />';
				}
				echo '<li><a href="'.$value['post_permalink'].'">'.$pop_img.$value['post_title'].'</a>('.$value['views']."views)</li>\n";
				$i++;
				if ( $i >= $n ) { break; } //指定数を超えたら終了
			}
		}	
	}
	echo "</ol>\n";
}

3行目、先ほどと同じく統計情報から取得する件数ですが、カテゴリで絞る場合は多めにしておかねばなりません。総記事数が多く、かつマイナーカテゴリが指定された場合は、100件取得してもそのカテゴリが必要数出てこない可能性もありますので、サイトの規模を考慮して設定する必要があります。

あとはだいたい同じですが、ランキングの記事IDからカテゴリ配列を取得し、それが指定のカテゴリに含まれる場合はフラグを立てる（12行目）ということをして、フラグが立っているものだけ出力していく、という方法をとっています。

データを取得できない場合の書き方は先ほどの追記部分をご参考ください。

single.php

<?php my_pop_cat_list( 30, array(1, 2, 3), 5 ); ?>

関数を呼び出したい場所で、期間、カテゴリID配列、件数の順に指定します。この例だと30日間のカテゴリID1, 2, 3 に属する人気記事を5件取得します。

//現在のカテゴリIDを配列で取得
$now_cat_id = wp_get_post_categories( $post->ID, 'fields=ids' );
//現在以外のカテゴリIDを配列で取得
$args = array( 'exclude'=>$now_cat_id, 'fields'=>'ids' );
$ext_cat_id = get_terms( 'category', $args );

ちなみに、現在表示されている記事のカテゴリID配列と、それ以外のカテゴリ配列はこのように書いて取得できるので、

//現在表示のカテゴリ月間人気5件
my_pop_cat_list( 30, $now_cat_id, 5 );
//現在以外のカテゴリ月間人気5件
my_pop_cat_list( 30, $ext_cat_id, 5 );

取得したカテゴリIDをそれぞれ指定してさっきの関数を呼び出してやれば実装できます。

人気記事と被らない関連記事を表示したい

かなりマニア向けな内容かもしれないのですがw、このブログの場合、記事終了後に、関連記事、現在カテゴリ人気記事、現在以外カテゴリ人気記事、の順番で表示させてるんですが、たまーに関連記事とカテゴリ人気記事に、同じ記事が表示されたりすることがあったんです。これが気になっちゃって((└(:3」┌)┘))

なんかこう、もったいないというか気持ち悪いというか。。関連記事は同じタグを持つ記事をランダムで出してるんですが、確かに関連してるんだから被ってしまう可能性も高いわけで。

というわけで、関連記事も含めて1件も記事が被らないように実装してみました。

functions.php

function my_pop_array( $target_days, $target_cat, $n ) {
	$i = 0;
	$args = array( 'days'=>$target_days, 'limit'=>100 );
	$top_posts = stats_get_csv( 'postviews', $args );
	foreach ( $top_posts as $value ) {
		$my_id = $value['post_id'];
		if ( $my_id != 0 && $my_id != get_the_ID() && get_post_type($my_id) == 'post' ) { //homeと現在のページは除外で、投稿のみ
			$cat_ids = wp_get_post_categories( $id, 'fields=ids' ); //カテゴリ－ID配列
			$cat_flg = false; //フラグリセット
			foreach ( $cat_ids as $cat_id ) { //該当カテゴリIDが対象カテゴリIDに含まれるか
				if ( in_array($cat_id, $target_cat) ) { $cat_flg = true; }
			}
			if ( $cat_flg ) { //対象のものだけ
				$my_array[$i] = $my_id;
				$i++;
				if ( $i >= $n ) { break; } //指定数を超えたら終了
			}
		}	
	}
	return $my_array;
}

さっきは対象をリスト形式で出力していたのですが、ここでは出力しないで記事IDだけ配列に格納して返す、という内容の関数にします。

single.php

<?php
//現在のカテゴリIDを配列で取得
$now_cat_id = wp_get_post_categories( $post->ID, 'fields=ids' );
//他カテゴリIDを配列で取得
$args = array( 'exclude'=>$now_cat_id, 'fields'=>'ids' );
$ext_cat_id = get_terms( 'category', $args );

//現在カテゴリの人気記事IDを配列で取得
$now_cat_pop = my_pop_array( 30, $now_cat_id, 5 );
//他カテゴリの人気記事IDを配列で取得
$ext_cat_pop = my_pop_array( 30, $ext_cat_id, 5 );

//人気記事ID配列を結合
$add = array_merge( $now_cat_pop, $ext_cat_pop );
//人気記事 + 現在記事のID配列
array_push( $add, get_the_ID() );
?>

それぞれのカテゴリIDを取得して（～6行）期間と件数を指定した人気記事の記事IDの配列を取得（～11行）した後、このふたつの配列を合成して（14行）、更に現在表示している記事IDもその配列に追加します（16行）。

これで、$addという配列には、カテゴリ人気記事ID、他カテゴリ人気記事、現在表示されている記事、全ての記事IDが格納されていることになります。（例では、人気記事IDそれぞれ5つ + 現在記事IDで、全部で11個の記事IDが格納されます）

これを除外する、という条件で関連記事を出してやります。

<h3>関連記事</h3>
<ul class="relation">
<?php
$tags = wp_get_post_tags( $post->ID, 'fields=ids' ); //現在のタグIDを配列で取得
global $post;
$args = array(
	'posts_per_page' => 5,
	'tag__in' => $tags,
	'post__not_in' => $add,
	'orderby' => 'rand'
);
$myposts = get_posts( $args );
if ( !$myposts ) {
	echo "<li>記事がありません。</li>";
} else {
	foreach( $myposts as $post ) {
		setup_postdata($post);
		if( has_post_thumbnail() ) { //サムネイルの有無
			$rl_img = get_the_post_thumbnail( $post->ID, array(100, 100), array('alt'=>get_the_title()) );
		} else {
			$rl_img = '<img src="noimage.png" width="100" height="100" />';
		}
		?>
		<li><a href="<?php the_permalink();?>"><?php echo $rl_img; ?><?php the_title(); ?></a></li>
		<?php
	}
}
wp_reset_postdata();
?>
</ul>

ハイライト部分にて、さっき合成した配列を指定して、これらの記事IDを除外します。

で、この下に人気記事IDが入ってる配列を使って希望のhtmlを出力します。

<h3>人気記事</h3>
<ol>
<?php
foreach ( $now_cat_pop as $value ) {
	if( has_post_thumbnail($value) ) { //サムネイルの有無
		$pop_img = get_the_post_thumbnail( $value, array(100, 100), array('alt'=>get_the_title($value)) );
	} else {
		$pop_img = '<img src="noimage.png" width="100" height="100" />';
	}
	$permalink = esc_url( apply_filters( 'the_permalink', get_permalink($value) ) ); //パーマリンクを取得
	echo '<li><a href="' . $permalink . '">' . $pop_img . get_the_title($value) . "</a></li>\n";
}
?>
</ol>

これは現在カテゴリのほうですが、ハイライト部の$now_cat_popを$ext_cat_popに変えてやれば他カテゴリのものが出力されます。

追記：取得できない場合はメンテナンス中表示

<h3>人気記事</h3>
<?php
if ( !$now_cat_pop ) {
	echo "<p>只今メンテナンス中です。</p>\n";
} else {
	echo "<ol>\n";
	foreach ( $now_cat_pop as $value ) {
		if( has_post_thumbnail($value) ) { //サムネイルの有無
			$pop_img = get_the_post_thumbnail( $value, array(100, 100), array('alt'=>get_the_title($value)) );
		} else {
			$pop_img = '<img src="noimage.png" width="100" height="100" />';
		}
		$permalink = esc_url( apply_filters( 'the_permalink', get_permalink($value) ) ); //パーマリンクを取得
		echo '<li><a href="' . $permalink . '">' . $pop_img . get_the_title($value) . "</a></li>\n";
	}
	echo "</ol>\n";
}
?>

こちらも、jetpack 側の不具合で読み込めないときのために、このようにしておくと良いかもです。

以上です。非常ーーーにマニアックな情報でしたが、どなたかのお役に立てたら光栄です！