この記事は最後に更新してから1年以上経過しています。

query_posts（WP_Queryクラス）で’tax_query’を使いこなす

tax_queryを理解する(3)

説明

2日にわたって投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」「query_posts（WP_Queryクラス）で投稿タグを絞り込む」の続き。今日はカテゴリーや投稿タグ以外ののタクソノミーによる絞り込み、複数のタクソノミーの絞り込みの組み合わせについてまとめてみる。
そもそも一連の投稿のきっかけになったのは、新テーマ「Twenty Eleven」の短冊ウィジェットがきっかけだった。その部分はこちら。

'tax_query' => array(
	array(
		'taxonomy' => 'post_format',
		'terms' => array( 'post-format-aside', 'post-format-link', 'post-format-status', 'post-format-quote' ),
		'field' => 'slug',
		'operator' => 'IN',
	),
),

これは投稿フォーマット（'post_format'）がアサイド（'post-format-aside'）、リンク（'post-format-link'）、ステータス（'post-format-status'）、引用（'post-format-quote'）の何れかにマッチする投稿情報を絞り込む指定になる。'tax_query'の指定は、カテゴリーや投稿タグで絞り込む場合と同様で、スラッグを直接使用できるのがいい。

投稿フォーマットが「標準」の投稿記事

投稿フォーマットで絞り込む際に注意する点は、投稿フォーマットとして「標準」が指定された投稿記事の場合。これは内部的に「標準」という投稿フォーマットは存在していないためで、投稿フォーマットが「標準」の投稿記事を取得する場合は次のように指定する必要がある。

query_posts( array(
	'tax_query' => array( 
		array(
			'taxonomy'=>'post_format',
			'terms'=>array( 'post-format-aside', 'post-format-link', 'post-format-gallery', 'post-format-image', 'post-format-status', 'post-format-quote' ),
			'field'=>'slug',
			'operator'=>'NOT IN'
			),
		'relation' => 'AND'
		)
	)
);

これは標準の投稿フォーマット6種類が登録されている場合で、独自に投稿フォーマットが追加されている場合は、それらも含めて指定しなければならない。

組み合わせは自由自在

ここまで'tax_query'を使用してカテゴリー、投稿タグ、投稿フォーマットそれぞれの絞り込み方法を紹介してきた。'tax_query'を使うメリットは、どのタクソノミーであってもIDだけでなくスラッグを指定でき、さらに複数の条件を組み合わせるが可能なことだ。
例えば、'news'または'topics'カテゴリーに属し、'product'または'service'という投稿タグが付いた投稿記事を絞り込む場合は

query_posts( array(
	'tax_query' => array( 
		array(
			'taxonomy'=>'category',
			'terms'=>array( 'news', 'topics' ),
			'field'=>'slug',
			'include_children'=>true,
			'operator'=>'IN'
			),
		array(
			'taxonomy'=>'post_tag',
			'terms'=>array( 'product', 'service' ),
			'field'=>'slug',
			'operator'=>'IN'
			),
		'relation' => 'AND'
		)
	)
);

といった感じになる。
また、'news'または'topics'カテゴリーに属し、'service'および'price-down'という投稿タグが付いた投稿記事を絞り込む場合は

query_posts( array(
	'tax_query' => array( 
		array(
			'taxonomy'=>'category',
			'terms'=>array( 'news', 'topics' ),
			'field'=>'slug',
			'include_children'=>true,
			'operator'=>'IN'
			),
		array(
			'taxonomy'=>'post_tag',
			'terms'=>array( 'service', 'price-down' ),
			'field'=>'slug',
			'operator'=>'AND'
			),
		'relation' => 'AND'
		)
	)
);

と、赤字の部分の指定を「OR」から「AND」に変更すればいい。
さらに、上記と同じ条件で投稿フォーマットのアサイドまたは引用の投稿情報を絞り込む場合は

query_posts( array(
	'tax_query' => array( 
		array(
			'taxonomy'=>'category',
			'terms'=>array( 'news', 'topics' ),
			'field'=>'slug',
			'include_children'=>true,
			'operator'=>'IN'
			),
		array(
			'taxonomy'=>'post_tag',
			'terms'=>array( 'service', 'price-down' ),
			'field'=>'slug',
			'operator'=>'AND'
			),
		array(
			'taxonomy' => 'post_format',
			'terms' => array( 'post-format-aside', 'post-format-quote' ),
			'field' => 'slug',
			'operator' => 'IN',
			),
		'relation' => 'AND'
		)
	)
);

のように、赤字の部分を追加するだけだ。

'taxonomy'と'term'の場合

おまけとして、最後にquery_posts関数（WP_Queryクラス）の'taxonomy'と'term'によるタクソノミーの絞り込みパラメータについて触れておく。例えば'news'カテゴリーで絞り込む場合は次のように指定できる。

query_posts( 'taxonomy=category&term=news' );

'taxonomy'にはタクソノミーの種類を1つだけ、'term'にはカテゴリーのスラッグを1つだけ指定する。
この指定は、内部では次に示す'tax_query'パラメータとして展開されている。

'tax_query' => array(
	array(
		'taxonomy'=>'category',
		'terms'=>array( 'news' ),
		'field'=>'slug',
		'operator'=>'IN'
		),
	'relation' => 'AND'
	)

query_posts関数（WP_Queryクラス）のパラメータとして、カテゴリー（'cat'や'category_name'、'category__○○'）や投稿タグ（'tag'や'tag_id'、'tag__○○'、'tag_slug__○○'）の絞り込みパラメータと、'tax_query'パラメータは同時に利用できるが、指定内容によっては矛盾する（マッチする投稿情報が1件もない）条件になる可能性高くなる。'tax_query'パラメータを使用する場合は、カテゴリーや投稿タグの絞り込みパラメータは使用しないほうがいいだろう。

最終更新 : 2011年09月14日 18:23

お勧め

wp_authenticate（2022年1月31日更新）

WP_User | WP_Error wp_authenticate( string $username, string $password )

ユーザー認証を行う。

wp_send_json_success（2020年12月10日更新）

void wp_send_json_success( [ mixed $response = null [ , int $status_code = null [ , int $options = 0 ] ] ] )

AJAXリクエストの成功レスポンスとしてJSON情報を返す。

wp_oembed_get（2014年11月16日更新）

mixed wp_oembed_get( string $url [ , mixed $args = '' ] )

oEmbedに対応したページの埋め込み用コンテンツを取得する。

setup_postdata（2014年11月16日更新）

bool setup_postdata( stdClass $post )

投稿記事に関連するグローバル変数を設定する。

the_permalink（2018年5月27日更新）

void the_permalink( [ mixed $post = 0 ] )

現在の投稿データのパーマリンクを表示する。