WP Query Builderのシンプル設定と詳細設定の違い
｜できることと選び方

作りたいクエリからモードを選ぶ

難しそうかどうかではなく、入力したい条件がシンプル画面にあるかで決めます。

2つのモードを実画面と生成コードで比べる

公開中のWP Query Builderで、通常投稿・publish・3件・date DESC・カテゴリー10,11・自動高速化OFFをシンプル設定から入力します。

次に入力を消さず、「詳細設定（全項目）」へ切り替えます。カテゴリー欄は「指定方法category__in」「値10,11」として開き、右側の生成コードは変わりません。

次は、同じ入力状態のシンプル設定と詳細設定でWP Query Builderが生成した未編集コードです。

$args = array(    'post_type' => 'post',    'post_status' => 'publish',    'posts_per_page' => 3,    'order' => 'DESC',    'orderby' => 'date',    'category__in' => array(        10,        11    ));

シンプル設定は最初の一覧に必要な項目へ絞る

シンプル設定には、プリセット、基本設定、並び順、カテゴリー・タグ・キーワード、自動高速化が表示されます。よく使う条件を短い画面で入力できます。

シンプル設定で実際にどの順番で入力し、どのファイルへコードを置くかは、操作記事で画面と実際の取得結果を追えます。初めてWP Query Builderを使う場合は、比較後にこちらから始めてください。

詳細設定はWordPress標準の条件を直接編集する

詳細設定では、シンプル設定の項目に加え、次のまとまりを直接開けます。

詳細設定の操作記事では、event_dateのMeta Queryと数値順を入力し、保存値が違う5投稿で境界まで確かめています。基本一覧の次に複雑な条件へ進むときに読んでください。

自動高速化と個別の性能設定を使い分ける

シンプル設定では「自動高速化」をON・OFFできます。ONにすると、入力済みの条件を変えない範囲で、未指定の性能設定だけが補われます。ページ送りで総件数が必要な一覧では、補われたno_found_rowsの値を確認してください。

詳細設定の「Performance / Cache」では、no_found_rows、キャッシュ、先読み、fieldsなどを個別に指定できます。「Fast Archive」は通常の記事一覧向けですが、総ページ数を使うページ送りではno_found_rows=falseを検討します。「ID Lookup Fastest」はfields=idsになるため、タイトルや本文を表示する通常のループには向きません。

「none: 初期状態に戻す」は手動のPerformance / Cache項目を戻す選択肢で、自動高速化のON・OFFは変えません。どちらのモードでも、最終的な入力状態が同じなら生成コードも同じです。性能設定を変えた場合はコードも変わるため、モード名ではなく右側の$argsを確認してください。

モードを切り替えても詳細条件は消えない

シンプル設定から詳細設定へ切り替えると、基本設定やカテゴリーなどの値は、より細かい入力欄へ引き継がれます。反対に、詳細設定でMeta Queryなどを入力した後にシンプル設定へ戻っても、その条件は生成コードへ反映されたままです。シンプル画面には「詳細条件がコードに反映されています」と案内が出ます。

現行画面には、シンプル設定から詳細条件だけを一括で消す専用ボタンはありません。不要な条件は「詳細設定で確認」から戻って該当欄を空にします。「入力をリセット」はモード切替ではなく、確認後にWP Query Builderのフォーム全体を初期状態へ戻す操作です。WordPressの記事やスプレッドシートを削除する操作ではありませんが、残したいコードは先にコピーします。

共通コードをWordPressで実行し、同じ3件を確認する

分離したWordPressで共通コードを実行すると、カテゴリー10または11のID81・80・79が投稿日降順で返りました。どちらのモードを経由しても、同じ$argsなら結果は同じです。

モードが違ってもコードの設置場所は同じ

生成元のモードでファイルを分ける必要はありません。この共通コードは子テーマのtemplate-parts/category-guides.phpへ表示ループと一緒に置き、固定ページ用page-guides.phpのthe_content()後から1回呼びます。

<?phpwhile ( have_posts() ) :    the_post();    the_content();    get_template_part( 'template-parts/category-guides' );endwhile;?>

template-parts/category-guides.php側でnew WP_Query( $args )と表示ループを実行し、最後にwp_reset_postdata()を呼びます。設置場所の選び方に迷う場合は、シンプル設定の記事の完成コードか、コード設置の記事を先に確認してください。

WP Query Builderで作れる範囲と手書きが必要な実装を分ける

WP Query Builderが生成する中心は$argsです。ループのHTML、0件時の文、ページネーション、入力値の確認、権限やエスケープ、サイト固有の保存形式まで自動で完成するわけではありません。

どの引数を画面で作れ、どこから手書きの実装やフックが必要になるかを確認したい場合は、機能範囲の記事へ進んでください。モード選択より先の「できないこと」を判断するときに使います。

画面ラベルと引数名を調べる

モードを選べても、category__in、compare、typeなどの意味が曖昧な場合は、項目と引数の対応表で確認します。入力欄を探すときと、生成コードを読むときの両方に使えます。

モード選択と最終コードを分けて確認する

最後は、画面が簡単か詳細かではなく、要件が$argsへ反映され、実データで期待どおりかを確認します。

最終的な引数はWordPress公式資料でも確認する

WP Query Builderのモード説明と、WordPressが解釈する引数の仕様を分けて確認します。

シンプル設定と詳細設定のよくある質問

生成結果、切り替え、リセット、選び方で迷いやすい点を短く整理します。