acf_get_encoded_terms()

WordPressのacf_get_encoded_terms()関数は、Advanced Custom Fields（ACF）プラグインで使用される関数で、エンコードされたタームデータを取得するために利用されます。この関数は、特定のフィールドに関連付けられたタームデータをエンコードして返します。

構文

acf_get_encoded_terms( array $field );

• $field(array) — エンコードされたタームデータを取得したいフィールドの配列。

例1: 基本的な使用法

この例では、特定のフィールドに関連付けられたエンコードされたタームデータを取得します。

<?php $encoded_terms = acf_get_encoded_terms( get_field('field_name') ); ?>

例2: エンコードされたタームデータをデコードする

エンコードされたタームデータをデコードして、実際のターム情報を取得します。

<?php $decoded_terms = json_decode( acf_get_encoded_terms( get_field('field_name') ), true ); ?>

例3: タームデータをループして表示する

デコードされたタームデータをループして、各タームの情報を表示します。

<?php $terms = json_decode( acf_get_encoded_terms( get_field('field_name') ), true ); foreach( $terms as $term ) { echo $term['name']; } ?>

例4: 特定のタームの情報を取得する

デコードされたタームデータから特定のタームの情報を取得します。

<?php $terms = json_decode( acf_get_encoded_terms( get_field('field_name') ), true ); $specific_term = $terms[0]; ?>

例5: タームデータを配列として保存する

エンコードされたタームデータを配列として保存し、後で使用します。

<?php $encoded_terms = acf_get_encoded_terms( get_field('field_name') ); $terms_array = json_decode( $encoded_terms, true ); ?>

注意点

• エンコードされたタームデータは、JSON形式で返されるため、デコードが必要です。
• フィールドが存在しない場合、関数は空の文字列を返します。