WEB業界で働く人や興味がある人に役立つ情報サイト“qam(カム)”

  • 中
  • 大

アバター画像

2026/11/19

【WordPress】プラグインなしで同じカテゴリーの関連記事を表示する方法

投稿者: K.K.
カテゴリー: プログラム >CMS

WordPressでブログやお知らせを運用していると、記事の下部に「関連記事」を表示したい場合があるかと思います。
現在閲覧している記事と関連性の高い記事へ誘導でき、サイト内の回遊性向上にもつながります。
こういった関連記事を表示するプラグインもありますが、WordPressの標準機能を使用すれば、プラグインを導入せずに実装することも可能です。

今回は、現在表示している記事と同じカテゴリーに属する記事を自動取得し、関連記事として表示する方法をご紹介します。

実装方法

今回は、以下の条件で関連記事を表示します。

  • 現在表示している記事と同じカテゴリーの記事を取得する
  • 現在表示している記事自身は除外する
  • 関連記事は最大3件まで表示する
  • 公開日の新しい記事から順番に表示する
  • 該当する記事がない場合は関連記事のエリア自体を表示しない

実装にはWordPressの「WP_Query」を使用します。

記事詳細ページのテンプレートであるsingle.phpなど、関連記事を表示したい箇所に以下のコードを記述します。


<?php
    // 現在の記事のIDを取得
    $current_post_id = get_the_ID();
    // 現在の記事に設定されているカテゴリーIDを取得
    $categories = wp_get_post_categories($current_post_id);
    // カテゴリーが設定されている場合のみ実行
    if (!empty($categories)) {
        $args = array(
        'post_type'           => 'post',
        'post_status'         => 'publish',
        'posts_per_page'      => 3,
        'post__not_in'        => array($current_post_id),
        'category__in'        => $categories,
        'orderby'             => 'date',
        'order'               => 'DESC',
        'ignore_sticky_posts' => true,
        );
    $related_query = new WP_Query($args);
    if ($related_query->have_posts()) :
?>

<div class="related-posts">
    <h3>関連記事</h3>
    <ul>
        <?php while ($related_query->have_posts()) : $related_query->the_post(); ?>
        <li>
            <a href="<?php the_permalink(); ?>">
                <?php if (has_post_thumbnail()) : ?>
                    <div class="related-posts__image"><?php the_post_thumbnail('medium'); ?></div>
                <?php endif; ?>
                <p class="related-posts__title"><?php the_title(); ?></p>
            </a>
        </li>
        <?php endwhile; ?>
    </ul>
</div>
<?php endif;
wp_reset_postdata();
}
?>

上記コードを記述することで、現在の記事と同じカテゴリーの記事を最大3件取得し、サムネイル画像と記事タイトルを一覧表示できます。

コードについて

現在の記事のカテゴリーを取得する

まずは、現在表示している記事のIDとカテゴリーを取得します。

$current_post_id = get_the_ID();
$categories = wp_get_post_categories($current_post_id);

「get_the_ID()」で現在の記事IDを取得し、「wp_get_post_categories()」でその記事に設定されているカテゴリーIDを配列として取得しています。

複数のカテゴリーが設定されている場合も、すべてのカテゴリーIDを取得できます。

関連記事の取得条件を設定する

続いて、関連記事を取得するための条件を設定します。

$args = array(
'post_type'           => 'post',
'post_status'         => 'publish',
'posts_per_page'      => 3,
'post__not_in'        => array($current_post_id),
'category__in'        => $categories,
'orderby'             => 'date',
'order'               => 'DESC',
'ignore_sticky_posts' => true,
);

各パラメータの役割は以下のとおりです。

  • post_type:取得する投稿タイプを指定
  • post_status:公開済みの記事のみを取得
  • posts_per_page:取得する記事数を指定
  • post__not_in:指定した記事IDを取得対象から除外
  • category__in:指定したカテゴリーに属する記事を取得
  • orderby:記事の並び順の基準を指定
  • order:昇順・降順を指定
  • ignore_sticky_posts:先頭固定表示の優先処理を無効化

今回のポイントとなるのが「post__not_in」と「category__in」です。

「post__not_in」に現在の記事IDを指定することで、閲覧中の記事自身が関連記事として表示されることを防ぎます。

また、「category__in」に取得したカテゴリーIDを指定することで、現在の記事と同じカテゴリーに属する記事だけを取得できます。

なお、複数のカテゴリーが設定されている場合は、そのうち1つでも一致するカテゴリーがあれば取得対象になります。

WP_Queryで記事を取得する

取得条件を設定したら、「WP_Query」を使用して記事を取得します。

$related_query = new WP_Query($args);

取得した記事が存在する場合は、以下のようにループ処理で一覧表示します。


<?php if ($related_query->have_posts()) : ?>

<ul>
    <?php while ($related_query->have_posts()) : $related_query->the_post(); ?>
    <li>
        <a href="<?php the_permalink(); ?>">
            <?php the_title(); ?>
        </a>
    </li>
    <?php endwhile; ?>
</ul>

<?php endif; ?>

「have_posts()」で記事の有無を判定し、「the_post()」で取得した記事を順番に処理しています。

また、記事が存在する場合のみHTMLを出力するため、関連記事が0件の場合は不要なエリアが表示されません。

記事のサムネイル画像を表示する

記事タイトルだけでなく、アイキャッチ画像を表示したい場合は以下のコードを使用します。


<?php if (has_post_thumbnail()) : ?>

<?php the_post_thumbnail('medium'); ?>

<?php endif; ?>

「has_post_thumbnail()」でアイキャッチ画像が設定されているかを判定し、画像が存在する場合のみ表示しています。

「medium」はWordPressに登録されている画像サイズの1つです。

サイトのデザインに合わせて、別の画像サイズを指定することも可能です。

投稿データを元に戻す

関連記事の取得処理が終了したら、以下のコードを記述します。

wp_reset_postdata();

「WP_Query」で取得した記事をループ表示すると、ループ内で参照される投稿データが切り替わります。

そのため、処理終了後に「wp_reset_postdata()」を実行し、元の投稿データに戻しておきます。

これを忘れると、関連記事の後に表示する記事タイトルやカスタムフィールドなどが、意図しない記事の情報になる場合があります。

関連記事の表示件数を変更する方法

関連記事の表示件数を変更したい場合は、「posts_per_page」の数値を変更します。

例えば、関連記事を6件表示したい場合は以下のように指定します。

'posts_per_page' => 6,

これだけで、最大6件の関連記事を取得できます。

関連記事をランダムに表示する方法

今回のコードでは、公開日の新しい記事から順番に表示しています。

毎回異なる記事を表示したい場合は、「orderby」を「rand」に変更します。

'orderby' => 'rand',

これにより、関連記事をランダムな順番で取得できます。

ただし、ランダム表示は通常の公開日順よりもデータベースへの負荷が大きくなる場合があるため、記事数やアクセス数が多いサイトでは注意が必要です。

カスタム投稿タイプで関連記事を表示する場合

今回の方法は、通常の投稿だけでなくカスタム投稿タイプにも応用できます。

例えば、投稿タイプが「news」、カスタムタクソノミーが「news_category」の場合は、カテゴリーの取得方法とWP_Queryの条件を変更します。

まず、現在の記事に設定されているタームIDを取得します。

$current_post_id = get_the_ID();

$term_ids = wp_get_post_terms(
$current_post_id,
'news_category',
array(
'fields' => 'ids',
)
);

続いて、取得条件を以下のように変更します。

if (!is_wp_error($term_ids) && !empty($term_ids)) {

$args = array(
    'post_type'           => 'news',
    'post_status'         => 'publish',
    'posts_per_page'      => 3,
    'post__not_in'        => array($current_post_id),
    'tax_query'           => array(
        array(
            'taxonomy' => 'news_category',
            'field'    => 'term_id',
            'terms'    => $term_ids,
        ),
    ),
    'orderby'             => 'date',
    'order'               => 'DESC',
    'ignore_sticky_posts' => true,
);

$related_query = new WP_Query($args);

// ここに関連記事の表示処理を記述

}

通常のカテゴリーでは「category__in」を使用しましたが、カスタムタクソノミーの場合は「tax_query」を使用します。

「taxonomy」にカスタムタクソノミーのスラッグを指定し、「terms」に現在の記事に設定されているタームIDを指定することで、同じタームに属する記事を取得できます。

なお、上記は取得条件の例です。実際に表示する場合は、最初に紹介したコードと同様に記事のループ処理と「wp_reset_postdata()」を組み合わせてください。

実装時の注意点

関連記事を表示する際は、以下の点に注意してください。

  • カテゴリーが設定されていない記事では関連記事を取得できない
  • 同じカテゴリーの記事が少ない場合は、指定件数より少なく表示される
  • 複数カテゴリーが設定されている場合は、いずれか1つが一致する記事も対象になる
  • 記事数が多いサイトでは、取得条件や表示件数を適切に設定する

また、今回の方法はカテゴリーの一致を基準にしているため、必ずしも記事内容そのものが似ているとは限りません。

より関連性の高い記事を表示したい場合は、タグを利用した取得方法や、複数の条件を組み合わせる方法も検討するとよいでしょう。

まとめ

今回は、WordPressでプラグインを使用せずに関連記事を表示する方法をご紹介しました。

「WP_Query」と「category__in」を組み合わせることで、現在の記事と同じカテゴリーに属する記事を自動的に取得できます。

また、「post__not_in」を使用すれば現在の記事を除外でき、表示件数や並び順も自由に変更できます。

通常の投稿だけでなく、カスタム投稿タイプにも応用できるため、ブログやお知らせなどの記事詳細ページに関連記事を設置したい場合に活用してみてください。

コーディング業務のご依頼、ご相談の詳細についてはこちらから

最後までお読みいただき、ありがとうございました。

よろしければシェアしていただければ幸いです。

  • このエントリーをはてなブックマークに追加

関連記事

よろしければこちらの記事もお読みください。

WEB業界ならqam!qam(カム)はWEB業界で働く人や興味がある人に役立つ情報サイトです。
マーケティングやデザイン、マークアップ(コーディング)、プログラム、トレンドなどの情報をqamライター陣が執筆。噛めば噛むほど(読めば読むほど)制作・開発や運営・運用、業界知識やノウハウを学ぶことができます。

トップへ