取得条件とパラメーターを確認したい
WP_Queryの全パラメーターや使い方を知りたい。
公式資料
WP_Query Class
分かること利用できる全パラメーターの一覧と、各引数の意味・型・初期値を確認できます。
OFFICIAL REFERENCE
公式資料を、調べたいことから選ぶ
WordPressの一次資料と、理解を助ける解説記事を対応づけました。
何を確認したいですか？
WP_Queryの全体像をつかみたい
クエリが投稿を取得する基本の流れを確認したい。
公式資料
WP_Query — More Information
分かることリクエストの判定と投稿のループという、WP_Queryの主な役割を確認できます。
ループの基本構造を確認したい
取得した投稿を安全に表示する流れを確認したい。
公式資料
The Loop
分かることループの基本構造と、主要なテンプレートタグの使い方を確認できます。
現在のページやクエリ状態を判定したい
is_*系の条件分岐をどこで使うか確認したい。
公式資料
Conditional Tags
分かること現在のページやクエリの状態を判定する条件分岐タグの一覧を確認できます。
カスタムフィールドで絞り込みたい
メタキーやメタ値を条件にして投稿を絞り込みたい。
公式資料
WP_Meta_Query
分かることメタキー・メタ値・比較演算子など、メタクエリの指定方法を確認できます。
カテゴリー・タグで絞り込みたい
タクソノミーの条件を組み合わせて投稿を取得したい。
公式資料
WP_Tax_Query
分かることタクソノミーの条件指定や、IN・NOT IN・ANDなどの指定方法を確認できます。
メインクエリを変更したい
アーカイブや検索結果などのクエリを調整したい。
公式資料
pre_get_posts
分かることメインクエリを変更するためのフックと、安全な実装方法を確認できます。
どのテンプレートが使われるか確認したい
クエリとテーマテンプレートの関係を整理したい。
公式資料
Template Hierarchy
分かることWordPressが表示に使うテンプレートファイルの選択順序を確認できます。
ページネーションを出力したい
一覧ページの前後リンクやページ番号を組み立てたい。
公式資料
paginate_links()
分かることページ番号、前後リンク、出力形式などの引数と返り値を確認できます。
カスタムループ後の投稿データを戻したい
ループ後にタイトルや本文が別投稿になる問題を防ぎたい。
公式資料
wp_reset_postdata()
分かることカスタムループの後に元の投稿データを復元する関数です。
エラーや意図しない挙動を調査したい
ログ出力やデバッグ設定を使って原因を切り分けたい。
公式資料
Debugging in WordPress
分かることWP_DEBUG、ログ出力、script debugなど、WordPressのデバッグ方法を確認できます。
よく確認する公式資料
迷ったときに戻りやすい一次資料です。実装前の最終確認や、記事の解説を仕様までさかのぼって確かめたいときにご利用ください。
wp_reset_postdata()
カスタムループの後に元の投稿データを復元する関数です。
公式資料を開く やさしい解説を読むThe Loop
ループの基本構造と、主要なテンプレートタグの使い方を確認できます。
公式資料を開く やさしい解説を読むConditional Tags
現在のページやクエリの状態を判定する条件分岐タグの一覧を確認できます。
公式資料を開く やさしい解説を読む