WP_Queryとは?初心者向けに役割と使い方を解説
WP_Queryの役割、通常のループとの違い、最小コード、よくあるつまずきを初心者向けに整理します。
POPULAR ARTICLES
読者の閲覧・反応をもとに、よく読まれている記事をまとめました。目的や期間で絞り込めます。
集計期間:累計
WP_Queryの役割、通常のループとの違い、最小コード、よくあるつまずきを初心者向けに整理します。
WP_Queryのmeta_queryを使い、カスタムフィールドの値で投稿を絞り込む方法を解説します。key・value・compare・typeの読み方も確認できます。
WordPressの記事一覧を新しい順・古い順に並べる指定を、WP_Queryのorderbyとorderの違いからコード例付きで解説します。
WP_Queryで投稿が表示されない原因を、最小構成から順番に切り分けます。投稿タイプ、ページ位置、絞り込み、ループ、外部処理の確認方法を解説します。
WP_Queryの2ページ目が同じ、リンクが出ない、404になる時に、paged、paginate_links()、固定フロントページ、offsetなどを確認する順番を解説します。
WP_Queryでカテゴリー絞り込みが効かない時に、category_nameへ渡すslug、catやcategory__inへ渡すID、子カテゴリー、tax_query、post_typeを確認する順番を解説します。
posts_per_pageを指定しても表示件数が合わないときに、WP_Queryが取得した件数と実際に画面へ出した件数を分けて確認します。
WP_Queryのmeta_queryが効かず0件になる、出すぎる時に、実際に保存されているkeyとvalue、compare、type、relation、post_typeを確認する順番を解説します。
WP_Queryで日付順に並ばない時は、まず投稿日・更新日・ACFなどの独自日付のどれを並べたいか確認します。orderby、order、保存値、同日データ、クエリ上書きを順に切り分けます。
WP_Queryで同じ記事が重複表示されたら、まず投稿IDを確認します。同じ一覧内の重複か、複数の表示枠での再取得かを分け、除外ID、先頭固定表示、ループ後処理を順に直します。
WP_Queryでカスタム投稿が0件になる時は、post_typeのスラッグ、公開状態、追加条件、登録状態を順に確認します。アーカイブURLの404やループ後の表示ずれとの違いも解説します。
WP_Queryが重いと感じたときに、原因を測ってから高速化する手順を解説します。取得件数、総件数、fields、N+1、条件・並び順、キャッシュを順に見直し、変更前後を同じ条件で比べます。
WordPressの記事や関連記事をランダム表示する方法と、orderby=randで重くなる場面、ページ送りの重複、選んだ記事を一定時間固定する方法を解説します。
WP_Queryで価格や点数が数値順にならない時に、meta_key、保存値、meta_value_num、order、meta_queryを順に確認する方法を解説します。
ACFに値を入力したのに投稿が出ない時の確認方法を解説します。WP_Queryの標準検索とmeta_query、フィールド名とfield key、表示値と保存値を分け、compare・typeまで順に確認します。
WP_Queryを書いても一覧ページが変わらないときの原因を、メインクエリとサブクエリ、ループ変数、テンプレート、キャッシュの順に切り分けます。
関連記事や新着記事を追加したあと、いま開いている記事のタイトルや本文が別の記事へ変わる原因を、global $postの確認方法とwp_reset_postdata()を置く位置から解説します。
pre_get_postsで関連記事や管理画面まで変わったときの確認方法を解説します。$query-is_main_query()、is_admin()、ページ条件で対象を絞ります。
おすすめ記事を別表示したあとに、通常一覧の投稿が重複する、抜ける、最後のページが空になる原因を、offsetとpagedの関係から解説します。