(1.5.0以降)
query_posts - 条件を指定して投稿情報をロードする

説明

投稿情報を条件を指定して検索し、マッチしたすべてのデータをグローバル変数$postsに、その先頭データを$postにロードする。

パラメータ

• $query
  検索条件を指定する文字列（または連想配列）。文字列の場合はname=valueの形式で指定し、複数の条件はname1=value1&name2=value2のように'&'の後に続ける。主なキーワードは次の通り。

  キーワード	意味
  p	投稿ID
  post__in	取得する投稿IDを指定（複数指定する場合は,で区切る）
  post__not_in	除外する投稿IDを指定（複数指定する場合は,で区切る）
  s	検索キーワード
  cat	何れかのカテゴリーに属する投稿情報はカテゴリーIDを、何れのカテゴリーにも属さない投稿情報は-を付けたカテゴリーIDを指定（複数指定する場合は,で区切る）
  category__in	何れかのカテゴリーに属する投稿情報をカテゴリーID（複数指定する場合は,で区切る文字列ではなく連想配列を使う）で検索
  category__not_in	何れのカテゴリーにも属さない投稿情報をカテゴリーID（複数指定する場合は,で区切る文字列ではなく連想配列を使う）で検索
  category_name	投稿情報の属するカテゴリーのスラッグ（複数指定する場合は,で区切る）
  tag	何れかのタグが設定された投稿情報はタグスラッグ（複数指定する場合は,で区切る）で、すべてのタグが設定された投稿情報はタグスラッグを+で区切って指定
  tag_slug__in	何れかのタグが設定された投稿情報をタグスラッグ（複数指定する場合は,で区切る）で検索
  tag_slug__and	すべてのタグが設定された投稿情報をタグスラッグ（複数指定する場合は,で区切る）で検索
  tag__in	何れかのタグが設定された投稿情報をタグID（複数指定する場合は,で区切る）で検索
  tag__not_in	何れかのタグも設定されていない投稿情報をタグID（複数指定する場合は,で区切る）で検索
  meta_key	カスタムフィールドの名前
  meta_value	カスタムフィールドの値
  author	投稿者ID
  author_name	投稿者名
  order	ソート順を示すASCかDESC（省略時はDESC）
  orderby	ソート対象を示すauthor、date、category、title、modified、ID、randなど（省略時は投稿日時）
  posts_per_page	最大取得件数（省略時は管理画面「表示設定」の「1ページの投稿数」）
  offset	取得開始位置（先頭は0。省略時は取得件数とページ番号から算出）
  name	投稿名
  m	投稿日時（書式はYYYY～YYYYMMDDhhmmss。数字以外は取り除かれる）
  hour	投稿日時の時
  minute	投稿日時の分
  second	投稿日時の秒
  year	投稿日時の年
  monthnum	投稿日時の月
  day	投稿日時の日
  fields	取得したい項目名（'ids'の場合は投稿IDのみ、'id=>parent'の場合は投稿IDおよび親ID（投稿IDがキーで中身が親IDの配列）、そのほかの場合は全部）
  nopaging	1を指定した場合、posts_per_pageの指定値を無視して条件にマッチする全件数を取得
  tax_query	タクソノミーに関連する条件を配列で指定。配列の形式は次の通り。 array( 'relation' => 'AND', array( 'taxonomy' => '', 'terms' => array(), 'include_children' => true, 'field' => 'term_id', 'operator' => 'IN' ), ) ・'relation'には、'OR'または'AND'のいずれかを指定（省略時は'AND'）。 ・詳細条件を指定する配列は複数指定でき、'relation'の指定にしたがって条件を組み合わせる。 ・詳細条件の'taxonomy'には、'category'、'post_tag'、'post_format'などのタクソノミー名を指定。 ・詳細条件の'terms'には、タクソノミーの値を配列で指定。 ・詳細条件の'field'には、'term_id'、'slug'などのフィールド名を指定。 ・詳細条件の'operator'には、'AND'、'IN'、'NOT IN'の何れかを指定。
  meta_query	カスタムフィールドに関連する条件を配列で指定。配列の形式は次の通り。 array( 'relation' => 'AND', array( 'key' => 文字列, 'value' => 文字列または配列, 'compare' => '=', 'type' => 'CHAR' ), ) ・'relation'には、'OR'または'AND'のいずれかを指定（省略時は'AND'）。 ・詳細条件を指定する配列は複数指定でき、'relation'の指定にしたがって条件を組み合わせる。 ・詳細条件の'key'には、カスタムフィールドの名前を指定。 ・詳細条件の'value'には、カスタムフィールドの値を文字列または配列（複数の値を指定する場合）で指定。 ・詳細条件の'compare'には、条件として'='、'!='、'>'、'>='、'<'、'<='、'LIKE'、'NOT LIKE'、'IN'、'NOT IN'、'BETWEEN'、'NOT BETWEEN'の何れかを指定（省略時は'='）。 ・詳細条件の'type'には、値（'value'）のデータ型として'NUMERIC'、'BINARY'、'CHAR'、'DATE'、'DATETIME'、'DECIMAL'、'SIGNED'、'TIME'、'UNSIGNED'の何れかを指定（省略時は'CHAR'）。

返り値

マッチしたすべてのデータが格納された配列を返す。データの中身は、基本的に投稿情報すべてになるが、パラメータとして'fields'の値が'ids'が指定された場合は投稿IDの配列、'id=>parent'を指定指定された場合はキーが投稿IDで中身が親投稿IDとなる。

注意

現バージョンでは、カテゴリーとタグに関する条件を同時に指定できない。また、WordPressシステムがデフォルトの条件でロードしていた投稿情報はこの呼び出しによって上書きされてしまうので、必要に応じて退避しておくか、query_posts関数の代わりにWP_Queryクラスを使用する。
パラメータnameは投稿名であり、投稿タイトルではない。
パラメータmは実際の検索前に数字以外の文字は除外され、年月日時分秒の順に分割される（年のみ4桁、ほかは2桁）。具体的には、「m=2011年04月01日」と指定された場合は、「year=2011&monthnum=04&day=01」と同じ意味となる。

---

参考：
query_posts（WP_Queryクラス）でカテゴリーを絞り込む
query_posts（WP_Queryクラス）で投稿タグを絞り込む
query_posts（WP_Queryクラス）で'tax_query'を使いこなす
query_posts（WP_Queryクラス）でカスタムフィールドを使う
もうquery_postsは呼ばない

使用例

• カテゴリー名が'日記'の投稿情報をロードする。
  <?php query_posts( 'category_name=日記' ); ?>

関連

• get_posts - 条件にマッチする投稿情報を取得する
• have_posts - 次の投稿データがあるか調べる
• the_post - 投稿データをロードする
• $post - 投稿情報
• $posts - ある条件でロードされた投稿情報配列
• $query_string - 直前の投稿情報検索時の条件

参考

• 不死屋ウェブサイト » カテゴリー項目・最新の投稿の表示設定の変更

お勧めコンテンツ