acf_get_valid_terms()

WordPress関数acf_get_valid_terms()は、Advanced Custom Fields（ACF）プラグインで使用され、指定されたタクソノミーに関連する有効な用語（ターム）を取得するために使用されます。

構文

acf_get_valid_terms( int|string $post_id = 0, string $taxonomy = '' );

引数の説明:

• $post_id (int|string) — 投稿ID。デフォルトでは現在の投稿ID（0または空文字の場合はグローバルな$postオブジェクトを使用）。
• $taxonomy (string) — タクソノミー名。指定されない場合は、デフォルトのタクソノミーが使用されます。

例1: 投稿に関連する有効な用語を取得する

指定した投稿IDに関連する有効なタクソノミーの用語を取得する基本的な例です。

<?php $terms = acf_get_valid_terms( get_the_ID(), 'category' ); ?>

例2: 特定のタクソノミーから有効な用語を取得する

特定のタクソノミー（この例では「タグ」）から有効な用語を取得します。

<?php $terms = acf_get_valid_terms( 123, 'post_tag' ); ?>

例3: 投稿IDが指定されていない場合にデフォルトの投稿を使用

投稿IDが指定されていない場合、現在の投稿のタクソノミー用語を取得します。

<?php $terms = acf_get_valid_terms( 0, 'category' ); ?>

例4: 特定のタクソノミーが指定されない場合にデフォルトタクソノミーを使用

タクソノミーが指定されていない場合、デフォルトのタクソノミーを使用して用語を取得します。

<?php $terms = acf_get_valid_terms( get_the_ID() ); ?>

例5: 用語が取得できなかった場合の処理

用語が見つからない場合のエラーハンドリングを追加します。

<?php
$terms = acf_get_valid_terms( get_the_ID(), 'category' );
if ( empty( $terms ) ) {
    echo '有効なタームは見つかりませんでした。';
} else {
    print_r( $terms );
}
?>

注意事項

• 指定された投稿IDとタクソノミーによって異なる結果が得られます。
• 有効な用語がない場合、空の配列が返されます。