WP_Queryとは?初心者向けに役割と使い方を解説
WP_Queryの役割、通常のループとの違い、最小コード、よくあるつまずきを初心者向けに整理します。
POPULAR ARTICLES
読者の閲覧・反応をもとに、よく読まれている記事をまとめました。目的や期間で絞り込めます。
集計期間:累計
WP_Queryの役割、通常のループとの違い、最小コード、よくあるつまずきを初心者向けに整理します。
WP_Queryで投稿が表示されない原因を、最小構成から順番に切り分けます。投稿タイプ、ページ位置、絞り込み、ループ、外部処理の確認方法を解説します。
WP_Queryの基本構文を、$argsの作り方、最小コード、ループの読み方、wp_reset_postdata()まで順番に解説します。
WP_Queryのmeta_queryを使い、カスタムフィールドの値で投稿を絞り込む方法を解説します。key・value・compare・typeの読み方も確認できます。
tax_queryは、WP_Queryでカテゴリ・タグ・カスタムタクソノミーを絞り込む指定です。基本構文とfield・terms・operatorの読み方を解説します。
WP_Queryのpost_typeに指定するpost、page、any、カスタム投稿タイプ、attachmentの違いを解説します。複数指定や投稿タイプ名の確認方法、anyの注意点も整理します。
wp_reset_postdata()が必要な理由を、書かないときにタイトルやURLがずれる仕組み、サブループ後の正しい位置、wp_reset_query()との違いから解説します。
WordPressの記事一覧を新しい順・古い順に並べる指定を、WP_Queryのorderbyとorderの違いからコード例付きで解説します。
WP_Queryの2ページ目が同じ、リンクが出ない、404になる時に、paged、paginate_links()、固定フロントページ、offsetなどを確認する順番を解説します。
古いテーマや解説でquery_postsを見つけた人向けに、使わないほうがいい理由と、pre_get_posts・WP_Query・get_postsの選び分け、安全な置き換え手順を解説します。
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で全件取得するposts_per_page=-1は、投稿数とループ処理が増えるほど重くなります。使える条件と、件数制限・ページ分割・ID取得・分割処理の選び方を解説します。
WP_Queryで同じ記事が重複表示されたら、まず投稿IDを確認します。同じ一覧内の重複か、複数の表示枠での再取得かを分け、除外ID、先頭固定表示、ループ後処理を順に直します。
WP_Queryで日付順に並ばない時は、まず投稿日・更新日・ACFなどの独自日付のどれを並べたいか確認します。orderby、order、保存値、同日データ、クエリ上書きを順に切り分けます。
ACF Date Pickerの日付を使い、今日以降・指定期間の投稿をWP_Queryで絞り込む方法を解説します。フィールド名、Ymdの保存値、meta_query、日付順の指定を順に確認します。
WP_Queryでカスタム投稿が0件になる時は、post_typeのスラッグ、公開状態、追加条件、登録状態を順に確認します。アーカイブURLの404やループ後の表示ずれとの違いも解説します。