WordPress WP_Queryの使い方：条件付き投稿取得の基本から応用まで

2026年5月27日

基礎知識

WordPressで動的なコンテンツ表示を実現するために欠かせないのが、WP_Queryクラスの活用です。

標準のメインクエリだけでは対応できない複雑な条件での投稿取得も、WP_Queryを使いこなすことで自由自在に制御できます。

本記事では、2026年現在の最新のコーディング標準に基づき、基本のリライトから高度なフィルター設定までを順を追って解説します。

カスタム投稿タイプやタクソノミー、カスタムフィールドを組み合わせた具体的な実装方法をマスターしましょう。

目次 [ close ]

WP_Queryとは何か

WP_Queryは、WordPressのデータベースから投稿情報を安全かつ効率的に取得するためのコアクラスです。

メインクエリとは別に独自のクエリを発行できるため、トップページに特定のカテゴリーのみを表示したり、サイドバーに新着記事を並べたりする際に利用されます。

かつて使われていたquery_posts関数は、メインクエリを破壊する恐れがあるため現在は非推奨とされており、オリジナルのループを作成する場合はWP_Queryの使用が標準となっています。

WP_Queryとget_postsの違い

投稿を取得する関数にはget_postsもありますが、これらは用途によって使い分ける必要があります。

以下の表に、主な違いをまとめました。

項目	WP_Query	get_posts
主な用途	複雑なループ処理やページネーション	単純な投稿データの取得
返り値	WP_Queryオブジェクト	投稿オブジェクトの配列
ページネーション	標準で対応	非対応（実装が困難）

基本的には、ループ内でテンプレートタグ（the_titleなど）を使用し、ページネーションも必要な場合はWP_Queryを選択するのが最適です。

WP_Queryの基本構造と4つのステップ

WP_Queryを使用する際は、決まった記述の流れ（ステップ）が存在します。

この手順を守ることで、不具合の少ない安定したコードを記述できます。

1. パラメータの設定

まずは、どのような投稿を取得したいかを連想配列で定義します。

取得件数や投稿タイプ、並び順などを指定することが一般的です。

2. インスタンスの作成

定義したパラメータを引数に渡し、WP_Queryクラスの新しいインスタンスを生成します。

これにより、データベースへの問い合わせが実行されます。

3. ループ処理

have_posts()メソッドで投稿があるかを確認し、the_post()メソッドで現在の投稿データをセットします。

このブロック内で、記事のタイトルや本文を出力する関数を使用します。

4. 投稿データのリセット

独自のクエリが終わった後は、必ずwp_reset_postdata()を呼び出してメインクエリの状態を復元します。

これを忘れると、以降の表示やウィジェットが正常に動作しなくなる重大なバグの原因となります。

PHP

// 1. パラメータの設定
$args = array(
    'post_type'      => 'post',      // 投稿タイプ
    'posts_per_page' => 5,           // 表示件数
    'orderby'        => 'date',      // 日付順
    'order'          => 'DESC',      // 降順
);

// 2. インスタンスの作成
$the_query = new WP_Query($args);

// 3. ループ処理
if ($the_query->have_posts()) :
    while ($the_query->have_posts()) : $the_query->the_post();
        // 投稿内容の表示
        the_title('<h2>', '</h2>');
    endwhile;
else :
    // 投稿が見つからない場合
    echo '<p>記事が見つかりませんでした。</p>';
endif;

// 4. 投稿データのリセット
wp_reset_postdata();

実務で使える応用パラメータ設定

WP_Queryの真価は、詳細なフィルタリングを可能にする豊富なパラメータにあります。

ここでは、実務で頻繁に利用される条件指定の方法を解説します。

タクソノミーでの絞り込み（tax_query）

特定のカテゴリーやタグ、カスタムタクソノミーに基づいて投稿を抽出する場合はtax_queryを使用します。

複数の条件を組み合わせる「AND」や「OR」の指定も可能です。

PHP

$args = array(
    'post_type' => 'news',
    'tax_query' => array(
        array(
            'taxonomy' => 'news_category', // タクソノミー名
            'field'    => 'slug',          // 指定方法（slug または term_id）
            'terms'    => 'event',         // タームのスラッグ
        ),
    ),
);
$the_query = new WP_Query($args);

カスタムフィールドでの絞り込み（meta_query）

投稿に紐づくカスタムフィールドの値を条件にする場合はmeta_queryを利用します。

例えば、「特定の価格以下の商品を表示する」といった処理が可能です。

PHP

$args = array(
    'post_type'  => 'product',
    'meta_query' => array(
        array(
            'key'     => 'price',    // カスタムフィールドのキー
            'value'   => 1000,       // 比較する値
            'compare' => '<=',       // 比較演算子
            'type'    => 'NUMERIC',  // 数値として比較
        ),
    ),
);
$the_query = new WP_Query($args);

日付による絞り込み（date_query）

「1週間以内の記事」や「特定の期間内に公開された記事」を取得する際に非常に便利です。

date_queryは、人間が理解しやすい形式で日付を指定できる柔軟なパラメータです。

PHP

$args = array(
    'date_query' => array(
        array(
            'after'     => '1 month ago', // 1ヶ月前から
            'inclusive' => true,          // その日を含む
        ),
    ),
);
$the_query = new WP_Query($args);

パフォーマンスを意識したWP_Queryの最適化

WP_Queryは強力ですが、無計画に多用するとサイトの表示速度を低下させる原因になります。

特に大規模なサイトでは、以下のポイントを意識して最適化を行いましょう。

不要な計算をスキップする

ページネーションが不要な場合（単に最新の数件を表示するだけの場合）は、no_found_rowsパラメータをtrueに設定します。

これにより、WordPressは全該当件数をカウントするSQLクエリをスキップするため、データベースへの負荷を大幅に軽減できます。

PHP

$args = array(
    'posts_per_page' => 3,
    'no_found_rows'  => true, // 全件カウントを無効化
);
$the_query = new WP_Query($args);

必要なフィールドのみを取得する

投稿のIDだけが必要な場合などは、fieldsパラメータを使用して取得データを制限します。

デフォルトではすべての投稿データが取得されますが、限定することでメモリ消費を抑えられます。

よくあるエラーとトラブルシューティング

WP_Queryの実装中に遭遇しやすい問題とその解決策を紹介します。

ページネーションが動かない

WP_Queryでページネーションを実装する場合、現在のページ番号を明示的に渡す必要があります。

pagedパラメータに、get_query_var('paged')の値を代入してください。

PHP

$paged = (get_query_var('paged')) ? get_query_var('paged') : 1;
$args = array(
    'post_type' => 'post',
    'paged'     => $paged, // 現在のページ番号を指定
);
$the_query = new WP_Query($args);