WP_Queryでシングルページから現在の記事を除外して一覧表示する方法【WordPress】

こんにちは！コーダーのゆうしです。

WordPressのシングルページ（single.php）で「他の記事一覧を表示したいけど、今見ている記事は除きたい」という場面はよくありますよね。記事詳細ページの下部に関連記事や新着記事を並べるときに特に使います。この記事ではWP_Queryの post__not_in を使ってシンプルに実装する方法を解説します。

実装コード
コード解説
躓きやすいポイント
まとめ

実装コード

<?php
$current_post_id = get_the_ID(); // 現在表示中の記事IDを取得

$args = [
  "post_type" => 'post', // 投稿タイプ
  "posts_per_page" => 3, // 表示する記事数
  "post__not_in" => [$current_post_id] // 現在表示中の記事をここで除外
];
$post_query = new WP_Query($args);
?>

<?php if ($post_query->have_posts()) : ?>
<?php while ($post_query->have_posts()) : $post_query->the_post(); ?>


<!-- ループの中身をここに記述してください。 -->

<?php endwhile; ?>
<?php endif;
  wp_reset_postdata(); ?>

コード解説

ポイントは2箇所です。

① 現在の記事IDを取得する

$current_post_id = get_the_ID();

get_the_ID() で現在表示中の記事IDを取得します。single.php内のメインループの中で呼び出す必要があるので、WP_Queryを書く前に記述してください。

② post__not_inで除外する

'post__not_in' => [$current_post_id],

post__not_in に除外したい記事IDを配列で渡します。複数除外したい場合は配列に追加するだけでOKです。

'post__not_in' => [$current_post_id, 5, 10], // IDが5と10の記事も除外する例

パラメータのカスタマイズ

post_type や posts_per_page はサイトに合わせて変更してください。

パラメータ	内容
post_type	対象の投稿タイプ。カスタム投稿の場合はそのスラッグに変更
posts_per_page	表示件数。`-1` で全件取得
post__not_in	除外したい記事IDの配列

カテゴリを絞りたい場合は tax_query を追加することで同一カテゴリの記事のみ表示することもできます。