WP_Query

WP_Query は、データベースに保存されている投稿や固定ページ、カスタム投稿を取得するためのWordPressの主要な仕組みです。投稿を表示する際は通常必ずこの WP_Query が使用されていて、投稿一覧ページ、個別投稿ページなどでは自動的に実行されています。( have_posts()the_post()the_title() などのよくあるコードがすぐに使えるのもWordPressが裏で自動的に WP_Query を動かしているおかげです)

手動での使い方

WordPressが自動で動作させるものとは別に、自分で好きな条件で WP_Query を使用して投稿を取得することができます。

典型的なコードは下記のとおりです。

主な条件

WP_Query のすべての条件(検索条件)は Codex日本語版 ) に記載されています。ここでは必要な部分をコピーして使えるように、主な条件を早見表(チートシート)のような形で紹介します。

※ 同じキー(post_typeなど)を一度に使用することはできません。下記をすべて貼り付けても動きませんので、必要な条件のみコピーしてください。
※ 投稿ステータスの一部などの使用頻度が少なそうなもの、nopaging などの役割が他のものと被っているものは省いています。(使用頻度が少なくても書き方が特殊なものは掲載しています)

 

用語集: 索引
ABCDE
FGHIJ
KLMNO
PQRST
UVWXY
Z