1 
基礎
WP_Queryとは？初心者向けに役割と使い方を解説
WP_Queryの役割、通常のループとの違い、最小コード、よくあるつまずきを初心者向けに整理します。
POPULAR ARTICLES
人気記事一覧
読者の閲覧・反応をもとに、よく読まれている記事をまとめました。目的や期間で絞り込めます。
集計期間：累計
いま読まれている3記事
2 
基礎
WP_Queryのmeta_queryとは？カスタムフィールドで絞り込む方法
WP_Queryのmeta_queryを使い、カスタムフィールドの値で投稿を絞り込む方法を解説します。key・value・compare・typeの読み方も確認できます。
3 
基礎
WordPressの記事を新しい順・古い順に並べる方法｜WP_Queryのorderbyとorder
WordPressの記事一覧を新しい順・古い順に並べる指定を、WP_Queryのorderbyとorderの違いからコード例付きで解説します。
目的から選ぶ
目的別の記事
4
トラブル解決
WP_Queryで投稿が表示されない原因と確認チェックリスト
WP_Queryで投稿が表示されない原因を、最小構成から順番に切り分けます。投稿タイプ、ページ位置、絞り込み、ループ、外部処理の確認方法を解説します。
5
基礎
WP_Queryの基本構文と$argsの書き方
WP_Queryの基本構文を、$argsの作り方、最小コード、ループの読み方、wp_reset_postdata()まで順番に解説します。
6
基礎
tax_queryとは？カテゴリ・タグ・カスタムタクソノミーで絞り込む方法
tax_queryは、WP_Queryでカテゴリ・タグ・カスタムタクソノミーを絞り込む指定です。基本構文とfield・terms・operatorの読み方を解説します。
7
基礎
wp_reset_postdata()はいつ必要？使い方・書く場所・不要なケース
wp_reset_postdata()が必要な理由を、書かないときにタイトルやURLがずれる仕組み、サブループ後の正しい位置、wp_reset_query()との違いから解説します。
8
基礎
WP_Queryのpost_type指定方法｜post・page・any・カスタム投稿の違い
WP_Queryのpost_typeに指定するpost、page、any、カスタム投稿タイプ、attachmentの違いを解説します。複数指定や投稿タイプ名の確認方法、anyの注意点も整理します。
9
基礎
query_postsを使わないほうがいい理由｜WP_Query・pre_get_postsとの違い
古いテーマや解説でquery_postsを見つけた人向けに、使わないほうがいい理由と、pre_get_posts・WP_Query・get_postsの選び分け、安全な置き換え手順を解説します。
10
実装例
WP_Queryで複数条件を組み合わせる方法｜AND・ORを指定できる場所とできない組み合わせ
WP_Queryで複数条件を組み合わせる方法を、tax_query・meta_queryのAND／ORと実例で解説。relationの位置や通常の引数ではできない組み合わせも整理します。
11
トラブル解決
WP_Queryでページネーションが動かない原因｜2ページ目以降が同じ・404も確認
WP_Queryの2ページ目が同じ、リンクが出ない、404になる時に、paged、paginate_links()、固定フロントページ、offsetなどを確認する順番を解説します。
12
トラブル解決
WP_Queryでカテゴリー絞り込みが効かない原因｜指定方法とtax_queryを確認
WP_Queryでカテゴリー絞り込みが効かない時に、category_nameへ渡すslug、catやcategory__inへ渡すID、子カテゴリー、tax_query、post_typeを確認する順番を解説します。
13
トラブル解決
WP_Queryの表示件数が合わない原因｜posts_per_pageの確認方法
posts_per_pageを指定しても表示件数が合わないときに、WP_Queryが取得した件数と実際に画面へ出した件数を分けて確認します。
14
実装例
WP_Queryで全件取得して大丈夫？posts_per_page=-1が重くなる理由と対策
WP_Queryで全件取得するposts_per_page=-1は、投稿数とループ処理が増えるほど重くなります。使える条件と、件数制限・ページ分割・ID取得・分割処理の選び方を解説します。
15
基礎
WordPressで期間を指定して記事を絞り込む方法｜WP_Queryのdate_queryを解説
WP_Queryのdate_queryで投稿日・更新日を期間指定する方法を解説。after・before・inclusive、年・月、columnの選び方を実例で確認します。
16
トラブル解決
WP_Queryのmeta_queryが効かない時のチェックリスト
WP_Queryのmeta_queryが効かず0件になる、出すぎる時に、実際に保存されているkeyとvalue、compare、type、relation、post_typeを確認する順番を解説します。
17
トラブル解決
WP_Queryで日付順に並ばない原因｜orderby・order・日付値を確認
WP_Queryで日付順に並ばない時は、まず投稿日・更新日・ACFなどの独自日付のどれを並べたいか確認します。orderby、order、保存値、同日データ、クエリ上書きを順に切り分けます。
18
トラブル解決
WP_Queryで同じ記事が重複表示される原因と対処法
WP_Queryで同じ記事が重複表示されたら、まず投稿IDを確認します。同じ一覧内の重複か、複数の表示枠での再取得かを分け、除外ID、先頭固定表示、ループ後処理を順に直します。
19
トラブル解決
WP_Queryでカスタム投稿が出ない原因｜post_type・公開状態を確認
WP_Queryでカスタム投稿が0件になる時は、post_typeのスラッグ、公開状態、追加条件、登録状態を順に確認します。アーカイブURLの404やループ後の表示ずれとの違いも解説します。
20
実装例
ACFの日付で投稿を絞り込む方法｜WP_Queryのmeta_query
ACF Date Pickerの日付を使い、今日以降・指定期間の投稿をWP_Queryで絞り込む方法を解説します。フィールド名、Ymdの保存値、meta_query、日付順の指定を順に確認します。
21
ツール連携
WP_Queryはどこで試す？Local・wp-env・DDEVなど検証環境を比較
WP_Queryのコードを本番で直接試さず、目的に合うWordPress検証環境を選ぶ方法を比較します。Local、MAMP・XAMPP、wp-env・DDEV、Playground、ステージングの違いが分かります。
22
実装例
カテゴリー・タグをAND・ORで絞る方法｜tax_query
WordPressで「カテゴリーAかつタグB」「カテゴリーAまたはタグB」のように複数条件で絞り込む方法を解説します。tax_queryのrelationをAND / ORで使い分け、operatorとの違いも確認します。
23
トラブル解決
WP_Queryが重いときの高速化方法｜原因の測り方と改善手順
WP_Queryが重いと感じたときに、原因を測ってから高速化する手順を解説します。取得件数、総件数、fields、N+1、条件・並び順、キャッシュを順に見直し、変更前後を同じ条件で比べます。
24
トラブル解決
WP_Queryでランダム表示するときの注意点｜orderby=randの負荷も確認
WordPressの記事や関連記事をランダム表示する方法と、orderby=randで重くなる場面、ページ送りの重複、選んだ記事を一定時間固定する方法を解説します。
25
実装例
WordPressでイベント一覧を作る方法｜WP_QueryとACFの日付で開催予定を表示
WordPressで今日以降のイベント一覧を作る手順を解説。ACFの日付をmeta_queryで絞り、開催日順に並べるコードと配置場所、実際の取得結果を確認します。
26
ツール連携
WP Query Builderの詳細設定の使い方｜条件を組み合わせてコードを作る手順
WP Query Builderの詳細設定を、現行画面の操作、WP Query Builderが生成したevent_date条件の未編集コード、子テーマへの設置、実際の取得結果まで順番に解説します。
27
実装例
記事のタイトルだけを検索する方法｜WP_Queryのsearch_columns
WordPressの記事をタイトルだけ、またはタイトルと抜粋だけから検索したい時に、WP_Queryのsearch_columnsで検索対象を絞る方法を解説します。対応はWordPress 6.2以降です。
28
トラブル解決
orderby=meta_value_numが効かない時の確認ポイント
WP_Queryで価格や点数が数値順にならない時に、meta_key、保存値、meta_value_num、order、meta_queryを順に確認する方法を解説します。
29
ツール連携
WP Query Builderのシンプル設定の使い方｜最短でクエリを作る手順
WP Query Builderのシンプル設定を、現行画面の入力、WP Query Builderが生成した未編集コード、子テーマへの設置、実際の取得結果まで順番に解説します。
30
トラブル解決
ACFの値が検索できない時の確認ポイント｜WP_Queryのmeta_query
ACFに値を入力したのに投稿が出ない時の確認方法を解説します。WP_Queryの標準検索とmeta_query、フィールド名とfield key、表示値と保存値を分け、compare・typeまで順に確認します。
31
基礎
WordPressで投稿を取得する方法｜get_postsとWP_Queryの使い分け
WordPressで投稿を取得するときのget_posts()とWP_Queryの使い分けを説明します。少数の投稿を配列で使う場合と、ページ送りまで作る場合の選び方が分かります。
32
トラブル解決
WP_Queryを書いたのに一覧ページが変わらない原因｜メインクエリとサブクエリを確認
WP_Queryを書いても一覧ページが変わらないときの原因を、メインクエリとサブクエリ、ループ変数、テンプレート、キャッシュの順に切り分けます。
33
ツール連携
WP Query Builderのシンプル設定と詳細設定の違い｜できることと選び方
WP Query Builderのシンプル設定と詳細設定の違いを、入力できる条件、同じコード、モード切替、実際の取得結果から比較します。
34
基礎
WP_Queryガイド｜やりたいこと・困りごと・Builderから探す
WP_Queryを、やりたいこと・症状・Builder・安全な実装から逆引きできる案内ページです。今の目的に合う解説と次の行動を選べます。
35
基礎
WordPressの投稿一覧はどう作る？｜4つの方法とWP_Queryの使い分け
WordPressの投稿一覧を作る4つの方法を比較します。今ある一覧を変えるのか別の一覧を追加するのか、コードやページ送りが必要かで選べます。
36
トラブル解決
関連記事の追加後に記事タイトル・本文が別の記事へ変わる原因｜wp_reset_postdata()を確認
関連記事や新着記事を追加したあと、いま開いている記事のタイトルや本文が別の記事へ変わる原因を、global $postの確認方法とwp_reset_postdata()を置く位置から解説します。
37
実装例
WordPressで検索結果ページを作る方法｜WP_Queryとページネーションの実装
WordPressで独自の検索結果ページを作る方法を解説。WP_Queryのsとpaged、入力値の処理、ページネーション、0件表示を実コードと取得結果で確認します。
38
ツール連携
WP Query Builderでカスタムフィールド条件を作る方法｜meta_query入門
WP Query Builderでmeta_queryを作る手順を、イベントの開催地・料金・開催日を使って解説。実際の保存値を確認し、1条件からAND・OR、生成コードの設置まで進めます。
39
基礎
WordPressの投稿一覧を変える方法｜pre_get_postsとWP_Queryの使い分け
WordPressの投稿一覧を変える方法を、今ある一覧の変更と、別の一覧の追加に分けて説明します。pre_get_postsとWP_Queryの選び方、書く場所、ページ送り、リセットの違いが分かります。
40
トラブル解決
is_main_query()はいつ使う？pre_get_postsで対象クエリを限定する方法
pre_get_postsで関連記事や管理画面まで変わったときの確認方法を解説します。$query-is_main_query()、is_admin()、ページ条件で対象を絞ります。
41
トラブル解決
WordPressのページ送りで投稿が重複・欠落する原因｜offsetの使い方と計算方法
おすすめ記事を別表示したあとに、通常一覧の投稿が重複する、抜ける、最後のページが空になる原因を、offsetとpagedの関係から解説します。
42
実装例
WordPressの記事をタグで絞り込む方法｜WP_Queryのtag_slug__inとAND条件
WP_QueryでWordPressの記事をタグ絞り込みする方法を解説。tag_slug__inのOR、tag_slug__andのAND、スラッグとIDの選び方を実コードと取得結果で確認します。
43
基礎
WordPressの一覧を変える？追加する？｜メインクエリとサブクエリの違い
WordPressの今ある一覧を変える時と、別の一覧を追加する時の違いから、メインクエリ・サブクエリ・ループの役割を図とコードで整理します。
44
基礎
WP_Queryで表示件数とページネーションを設定する方法｜posts_per_page・pagedの基本
WP_Queryの表示件数とページネーションを、posts_per_page、paged、max_num_pages、paginate_links()までつないだ完成例で解説します。
45
実装例
固定ページの子ページを一覧にする方法｜WP_Queryのpost_parentと全子孫の取得
固定ページの直下の子を取得するWP_Queryと、孫以下も含めるget_pagesを解説。親ID・menu_order・公開状態が混在する例で、取得範囲と並び順を確認します。
46
基礎
WordPressで追加した一覧にタイトル・本文を正しく表示する方法｜the_post()の使い方と役割
関連記事や新着記事をWP_Queryで追加するときに、the_post()をどこへ書くか、have_posts()と何が違うか、呼ぶ位置で表示がどう変わるかを解説します。
47
ツール連携
WP Query Builderの入力項目とWP_Queryパラメーターの対応表｜目的から探せる
WP Query Builderの入力項目と生成されるWP_Queryパラメーターを、目的から探せる対応表にしました。プリセットや自動高速化との違いも確認できます。
48
ツール連携
WP Query Builderの生成コードをWordPressへ安全に貼る方法｜本番前の7項目
WP Query Builderで作った$argsをWordPressへ反映する前に、設置場所、子テーマ、バックアップ、構文、実データ、戻し方を7項目で確認します。
49
ツール連携
WP Query Builderとは？できること・できないことと使いどころ
WP Query Builderで作れる条件、現在の非対応範囲、生成後にWordPress側で確認することを整理します。使いどころと初心者向けの調べ方も分かります。
50
ツール連携
WordPressの投稿一覧にページ送りを付ける方法｜WP Query Builderでpagedを設定
WordPressの投稿一覧にページ送りを付ける方法を、WP Query Builderのposts_per_page・paged・no_found_rows設定から、現在ページの取得とpaginate_links()の実装まで解説します。
51
ツール連携
WP Query Builderでカテゴリー絞り込みを作る方法｜ID・slug・Tax Queryの選び方
WP Query Builderでカテゴリー絞り込みを作る手順を解説。管理画面でID・slugを調べ、子カテゴリーを含めるかに合わせて入力欄を選び、生成コードと取得結果を確かめます。