acf_get_reference()


acf_get_reference()関数は、Advanced Custom Fieldsプラグインの関数で、特定のリファレンスを取得するために使用されます。この関数は、フィールドの値を取得する際に、参照関係にあるフィールドを解決するために使用されます。

構文

acf_get_reference( string $field_key );
  • $field_key (string) — リファレンスを取得する対象のフィールドのキー。

例1: フィールドのリファレンスを取得する

以下のコードは、指定されたフィールドキーに基づいてリファレンスを取得します。

<?php $reference = acf_get_reference('field_123abc'); ?>

例2: 取得したリファレンスの値を表示する

リファレンスの値を取得し、表示するコード例です。

<?php 
$reference = acf_get_reference('field_123abc');
echo $reference;
?>

例3: フィールドが存在する場合にのみリファレンスを取得する

指定されたフィールドが存在する場合にのみ、リファレンスを取得して表示します。

<?php 
if( acf_get_reference('field_123abc') ) {
    echo acf_get_reference('field_123abc');
}
?>

例4: リファレンスの取得とエラーハンドリング

リファレンスが取得できなかった場合にエラーメッセージを表示する例です。

<?php 
$reference = acf_get_reference('field_123abc');
if( !$reference ) {
    echo 'リファレンスが見つかりませんでした。';
}
?>

例5: 取得したリファレンスを配列に保存

リファレンスを配列に格納し、その後ループで表示するコード例です。

<?php 
$references = acf_get_reference('field_123abc');
foreach( $references as $reference ) {
    echo $reference;
}
?>

注意点:

  • リファレンスが見つからない場合、falseが返されることがあります。