wp_term_query()


WordPressのwp_term_query()関数は、カテゴリ、タグ、またはカスタム分類を基に用語をクエリするために使用されます。この関数は、特定の条件に基づいて用語を取得したい場合に便利です。

構文

<?php $query = new WP_Term_Query( array $args ); ?>

引数の説明:

  • $taxonomy (string|array) — クエリする分類のスラッグまたはスラッグの配列。
  • $hide_empty (bool) — 子供のない用語を隠すかどうか。デフォルトはtrue。
  • $orderby (string) — 用語の並び替え方法。例: 'name', 'count'。
  • $order (string) — 並び替え順序。'ASC'または'DESC'。
  • $number (int) — 取得する用語の最大数。

例 1. すべてのカテゴリの取得

以下のコードは、すべてのカテゴリを取得して表示します。

<?php
$args = array( 'taxonomy' => 'category', 'hide_empty' => false );
$query = new WP_Term_Query( $args );
foreach ( $query->get_terms() as $term ) { echo $term->name; }
?>

例 2. 投稿数があるタグのみを取得

投稿数が0でないタグを取得する例です。

<?php
$args = array( 'taxonomy' => 'post_tag', 'hide_empty' => true );
$query = new WP_Term_Query( $args );
foreach ( $query->get_terms() as $term ) { echo $term->name; }
?>

例 3. 特定の分類スラッグで並び替え

分類名で並び替えられた結果を取得します。

<?php
$args = array( 'taxonomy' => 'category', 'orderby' => 'name', 'order' => 'ASC' );
$query = new WP_Term_Query( $args );
foreach ( $query->get_terms() as $term ) { echo $term->name; }
?>

例 4. カスタム分類の用語取得

カスタム分類'product_category'の用語を取得します。

<?php
$args = array( 'taxonomy' => 'product_category', 'hide_empty' => false );
$query = new WP_Term_Query( $args );
foreach ( $query->get_terms() as $term ) { echo $term->name; }
?>

例 5. 用語数の制限

最大3件の用語を取得します。

<?php
$args = array( 'taxonomy' => 'category', 'number' => 3 );
$query = new WP_Term_Query( $args );
foreach ( $query->get_terms() as $term ) { echo $term->name; }
?>

注意事項

取得する分類や条件に応じて$argsを正しく設定してください。不適切な設定は予期しない結果を引き起こす可能性があります。

関連機能：