acf_get_terms()

WordPressのacf_get_terms()関数は、Advanced Custom Fields (ACF) プラグインを使用して、カスタムタクソノミーの用語を取得するための関数です。

構文

acf_get_terms( array $args );

• $args (array) — 用語を取得するための引数。詳細は以下を参照。

引数の詳細

• taxonomy (string) — 必須。取得するタクソノミーの名前。
• terms (array|string) — 取得するタームのIDやスラッグの配列。
• orderby (string) — ソート方法。例：’name’、’slug’、’term_group’。
• order (string) — ソート順。’ASC’（昇順）または’DESC’（降順）。
• hide_empty (bool) — 空のタームを非表示にするかどうか。デフォルトはfalse。

例1: タクソノミー「category」の用語を取得する

以下のコードは、’category’タクソノミーの用語を取得します。

<?php
$terms = acf_get_terms( array(
    'taxonomy' => 'category'
) );
print_r($terms);
?>

例2: タクソノミー「post_tag」の空でないタームを取得する

以下のコードは、’post_tag’タクソノミーの空でないタームのみを取得します。

<?php
$terms = acf_get_terms( array(
    'taxonomy' => 'post_tag',
    'hide_empty' => true
) );
print_r($terms);
?>

例3: タクソノミー「genre」のタームを名前でソートして取得する

以下のコードは、’genre’タクソノミーのタームを名前で昇順にソートして取得します。

<?php
$terms = acf_get_terms( array(
    'taxonomy' => 'genre',
    'orderby' => 'name',
    'order' => 'ASC'
) );
print_r($terms);
?>

例4: 特定のタームIDを指定して取得する

以下のコードは、特定のタームID（例：10）のタームを取得します。

<?php
$terms = acf_get_terms( array(
    'taxonomy' => 'category',
    'terms' => array(10)
) );
print_r($terms);
?>

例5: タクソノミー「custom_taxonomy」のタームをスラッグで取得する

以下のコードは、’custom_taxonomy’タクソノミーの特定のスラッグ（例：’term-1’）のタームを取得します。

<?php
$terms = acf_get_terms( array(
    'taxonomy' => 'custom_taxonomy',
    'terms' => 'term-1'
) );
print_r($terms);
?>

注意点

• acf_get_terms()関数は、ACFプラグインが有効である必要があります。
• 引数で指定するタクソノミーは、事前に登録されている必要があります。