acf_get_local_field()


WordPressの関数acf_get_local_field()は、Advanced Custom Fields (ACF) プラグインを使用して、指定されたカスタムフィールドのローカル設定を取得するために使用されます。

構文

acf_get_local_field( int|string $field_key );
  • $field_key (int|string) — フィールドのキーまたはID。これは、設定を取得したいフィールドを特定するために使用されます。

例 1: フィールドの設定を取得する

指定されたフィールドキーの設定情報を取得します。

$field = acf_get_local_field( 'field_1a2b3c' );
var_dump( $field );

例 2: フィールドキーを動的に取得する

フィールドのキーを動的に取得して設定を取得する例です。

$field_key = 'field_' . get_the_ID();
$field = acf_get_local_field( $field_key );
var_dump( $field );

例 3: グローバル変数からフィールドの設定を取得する

グローバル変数を使用して、現在の投稿のフィールド設定を取得する例です。

global $post;
$field = acf_get_local_field( 'field_' . $post->ID );
var_dump( $field );

例 4: カスタムフィールドの設定を取得する

特定のカスタムフィールドの設定を取得するためのコードです。

$field = acf_get_local_field( 'custom_field_name' );
var_dump( $field );

例 5: フィールドが存在するかチェックする

フィールドが存在するかどうかを確認し、存在すればその設定を表示します。

if( acf_get_local_field( 'field_key' ) ) {
    echo 'フィールドは存在します';
} else {
    echo 'フィールドは存在しません';
}

注意事項:

  • 関数が返すのはフィールドのローカル設定のみであり、フィールドの値を取得するものではありません。
  • フィールドが存在しない場合、関数はNULLを返します。