WordPressで関連記事表示するなら普通はプラグインを使います。
というか余程の理由がない限りはプラグインを使った方が楽です。
ですが例えば次のように
「どうしてもPHPを使って関連記事を表示したい」
「テキストだけの関連リンクを表示したい」
「なるべくプラグインを使いたくない・増やしたくない」
などの事情があるならPHPを使って自力で関連リンクを表示することもできます。
ここではそのやり方について簡単にまとめてみました。
関連記事表示の重要なポイント
最初に関連記事を表示するのに大事なことについていくつか説明します。
重要になってくるポイントは次の２つ
- 記事リストをどうやって取得するのか
- 関連記事をどうやって選ぶのか
特にどの記事を関連記事として選ぶかは超重要です。
まず記事リストの取得方法について
WordPressではクエリを発行することで特定の条件に当てはまる投稿リストを取得できます。
そのために使われる関数の１つが wp_get_post_categories という関数
この関数に条件を表す配列を渡すことで投稿（WP_Post ）のリストが取得可能です。
例えば次は記事タイトルに「PHP」が含まれ、順番がランダムな記事リストを返すコード例
|
1 2 3 4 5 |
$args = array( 'title' => 'PHP', 'order' => 'rand' ); $queried_posts = get_posts( $args ); |
条件を指定する配列 $args を作り、それを get_posts に渡すだけです。
より詳しい使い方については次の公式ページをチェック
とりあえず関連記事表示にはこのget_posts関数を使うことにします。
そして次に関連記事の選び方について
関連記事を厳密に選ぼうとすると結構大変で複雑になってしまいます。
なのでここでは現在記事のカテゴリと同じ記事を関連記事として選ぶことにしましょう。
WordPressで現在記事のカテゴリIDリストを取得するコードは次の通り
|
1 2 |
/** 現在記事のカテゴリIDリストを取得 */ $cat_ids = wp_get_post_categories( $post->ID ); |
カテゴリには 21 とか 78 とか 104 とかのIDがそれぞれ割り振られています。
そのIDリストを [ 21, 78, 104 ] みたいな配列形式で得られるのが上で紹介したコード
そしてそのリストをget_posts関数のパラメーターに渡すことで関連記事を絞り込み可能です。
以上が関連記事表示で大事な２つのポイント
これらのポイントを踏まえることでそこそこの精度で関連記事を表示することができます。
関連記事表示のPHPコード例
では実際にカテゴリで関連記事を絞り込みするやり方を紹介します。
具体的なコード例は次の通り
まず次のようにget_posts関数を使って関連記事リストを取得
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
global $post; $cat_ids = wp_get_post_categories( $post->ID ); $args = array( /** 投稿表示数 */ 'numberposts' => 5, /** 現在投稿を含めない */ 'post__not_in' => array( $post->ID ), /** カテゴリで絞込 */ 'category__in' => $cat_ids, /** 並び順はランダム */ 'orderby' => 'rand' ); $related_posts = get_posts( $args ); |
$args の内部で 'category__in' => $cat_ids を指定しているのがポイントです、
これで現在投稿に含まれるカテゴリを持つ関連記事だけに絞り込みできます。
あと 'post__not_in' => array( $post->ID ) で現在投稿を除外してるのも地味に大事なポイント
そして次が投稿リストから実際に関連記事リンクを出力しているコード
|
1 2 3 4 5 6 7 8 |
echo '<ul>'; foreach( $related_posts as $post ) : setup_postdata( $post ); ?> <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li> <?php endforeach; wp_reset_postdata(); echo '</ul>'; |
foreachで各投稿オブジェクトを取り出し、タイトル付きでリンクを出力するだけです。
ただしforeachに渡している $post は変数名を変更しないように注意してください。
これはただの変数ではなく、WordPressで定義済みの変数なので変更するのはNGです。
あとforeachループ内で setup_postdata を実行することで the_permalink とか the_title とかのグローバル情報を変更し、foreachの最後で wp_reset_postdata で元に戻しています。
これについてはWordPressの仕様なので深く考える必要はありません。
以上のコードを関数化してまとめて載せると次の通り
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 |
/** 関連記事を表示する */ function echo_related_links(){ global $post; $cat_ids = wp_get_post_categories( $post->ID ); $args = array( 'numberposts' => 5, 'post__not_in' => array( $post->ID ), 'category__in' => $cat_ids, 'orderby' => 'rand' ); $related_posts = get_posts( $args ); echo '<ul>'; foreach( $related_posts as $post ) : setup_postdata( $post ); ?> <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li> <?php endforeach; wp_reset_postdata(); echo '</ul>'; } |
この関数をページ内の任意の場所で呼び出せば関連記事リンクが表示されます。
ここまでのまとめ
以上がWordPressで関連記事をPHPのみ使って表示する方法です。
僕自身こういうことをする機会があったので、その忘備録的な意味でまとめてみました。
でも普通に関連記事を表示するだけならプラグインを使った方が楽ですね。笑
車輪の再発明みたいな感じですが、「どうしてもプラグインの表示が気に入らない！」とかの事情があるときに使えるかなと思います。
