ワードプレス query フィールド一覧


スポンサーリンク

<?php
    $myQuery = new WP_Query(); // WP_Queryオブジェクト生成
    $param = array( //パラメータ
        //カテゴリー引数
        'cat' => '1', //(整数)- カテゴリーIDを指定。コンマ区切りにした複数IDの文字列も指定可能。
        'category_name' => 'my cat name', //(文字列)- カテゴリー名を指定(日本語も可)。
        'category__and' => array('1', '2'), //(配列)- カテゴリーIDの配列。指定した複数のカテゴリーすべてに含まれる投稿のみを取得。
        'category__in' => array('1', '2'), //(配列)- カテゴリーIDの配列。指定した複数のカテゴリーいずれかに含まれる投稿のみを取得。
        'category__not_in' => array('1', '2'), //(配列)- カテゴリーIDの配列。指定した複数のカテゴリーのいずれにもに含まれない投稿のみを取得。
        //タグ引数
        'tag' => 'my tag slug', //(文字列)- タグスラッグを指定。
        'tag_id' => '1', //(整数)- タグ ID を指定。コンマ区切りにした複数IDの文字列も指定可能。
        'tag__and' => array('1', '2'), //(配列)- タグ ID の配列。指定した複数のタグのすべてを含む投稿のみを取得。
        'tag__in' => array('1', '2'), //(配列)- タグ ID の配列。指定した複数のタグのいずれかを含む投稿のみを取得。
        'tag__not_in' => array('1', '2'), //(配列)- タグ ID の配列。指定した複数のタグのいずれも含まない投稿のみを取得。
        'tag_slug__and' => array('1', '2'), //(配列)- タグスラッグの配列。指定した複数のタグすべてを含む投稿のみを取得。
        'tag_slug__in' => array('1', '2'), //(配列)- タグスラッグの配列。指定した複数のタグのいずれかを含む投稿のみを取得。
        //投稿者引数
        'author' => '1', //(整数)- 指定したIDや名前の投稿者による投稿を取得する。
        'author_name' => 'my author nick name', //(文字列)- 投稿者のニックネームを指定(日本語も可)。
        //記事・固定ページ引数
        'p' => '1', //(整数)- 取得する投稿 ID を指定。
        'name' => 'my post slug', //(文字列)- 取得する 投稿スラッグ を指定。
        'page_id' => '1', //(整数)- 取得する固定ページ ID を指定。
        'pagename' => 'my page slug', //(文字列)- 取得する固定ページスラッグを指定。タイトルではありません。
        'posts_per_page' => '-1', //(整数)- 1ページに表示する記事数。-1 ならすべての投稿を取得。
        'post__in' => array('1', '2'), //(配列)- 取得する投稿の ID を配列で指定。
        'post__not_in' => array('1', '2'), //(配列)- 取得しない投稿の ID を配列で指定。
        'post_type' => 'page', //pageタイプのみを指定。
        'post_type' => 'post', //postタイプのみを指定。
        'post_type' => 'attachment', //添付ファイルタイプのみを指定。
        'post_type' => 'revision', //リビジョンタイプのみを指定。
        'post_type' => 'my custom post', //カスタム投稿タイプのみを指定。
        'post_status' => 'publish', //取得するステータスを指定:publish(公開済み)
        'post_status' => 'pending', //取得するステータスを指定:pending(レビュー待ち)
        'post_status' => 'draft', //取得するステータスを指定:draft(下書き)
        'post_status' => 'future', //取得するステータスを指定:future(スケジュール済み)
        'post_status' => 'private', //取得するステータスを指定:private(非公開)
        'post_status' => 'trash', //取得するステータスを指定:trash(ゴミ箱入り)
        'post_status' => 'inherit', //取得するステータスを指定:inherit(get_children/en 参照)
        'post_parent' => '1', //(整数)- 取得する固定ページの親ページ ID を指定。
        //日時引数
        'hour' => '', //(整数)- 時 (0?23)
        'minute' => '', //(整数)-分 (0?59)
        'second' => '', //(整数)- 秒 (0?59)
        'day' => '', //(整数)- 日 (1?31)
        'monthnum' => '', //(整数)- 月 (1?12)
        'year' => '', //(整数)- 4桁の年 (例:2009)
        'w' => '', //(整数)- 0~53 で年間のうちどの週かを選ぶ。MySQL WEEK command Mode=1 を使っている。
        //ページング引数
        'nopaging' => 'true', //ページングを無効にする。
        'paged' => '', //インデックスや月別・カテゴリー別アーカイブページンなどが複数ページにわたる場合の、表示するページ番号を指定。
        //オフセット引数
        'offset' => '1', //投稿の先頭からスキップする件数を指定。
        //並び替え引数
        // - 指定したフィールドで投稿を並び替えて取得する。
        'orderby' => 'author',
        'orderby' => 'date',
        'orderby' => 'title',
        'orderby' => 'modified',
        'orderby' => 'menu_order', //注意: 固定ページ のみ有効。
        'orderby' => 'parent',
        'orderby' => 'ID',
        'orderby' => 'rand',
        'orderby' => 'meta_value', //注意: カスタムフィールド引数として meta_key=keyname が指定されていること。
        'orderby' => 'none',
        'orderby' => 'comment_count',
        //並び順引数
        'order' => 'ASC', //昇順。小さい値から大きい値の順。
        'order' => 'DESC', //降順。大きい値から小さい値の順。
        //カスタムフィールド引数
        // - カスタムフィールドのキーまたは値を元に、投稿(または 固定ページ) を取得。
        'meta_key' => 'my meta_key name',
        'meta_value' => 'my meta_value',
        'meta_compare' => '', //meta_value で指定された値を比較する演算子。デフォルトは '=' で, '!='、'>'、'>='、'<'、'<=' も使える。
        '' => '' //
    );
    $myQuery->query($param);  // クエリにパラメータを渡す
?>
<?php if($myQuery->have_posts()): while($myQuery->have_posts()) : $myQuery->the_post(); ?>
        ここに出力内容
<?php endwhile; endif; ?>

スポンサーリンク