acf_get_local_fields()

WordPressの関数acf_get_local_fields()は、Advanced Custom Fields (ACF) プラグインで定義されたローカルフィールドを取得するために使用されます。この関数は、特定のカスタムフィールドグループに関連付けられたフィールド情報を取得する際に役立ちます。

シンタックス

acf_get_local_fields( int $group_id );

• $group_id (int) — フィールドグループのID。これにより、指定されたフィールドグループのフィールドが取得されます。

例1: 特定のフィールドグループのローカルフィールドを取得

次のコードは、フィールドグループIDが10であるフィールドのローカル情報を取得します。

<?php $fields = acf_get_local_fields( 10 ); ?>

例2: フィールド情報を配列として表示

取得したフィールド情報をループして表示する例です。

<?php
$fields = acf_get_local_fields( 10 );
foreach ( $fields as $field ) {
    echo $field['label'];
}
?>

例3: ACFフィールドの設定を取得して表示

フィールドグループIDから、フィールド設定を表示する例です。

<?php
$fields = acf_get_local_fields( 20 );
foreach ( $fields as $field ) {
    echo 'Field Name: ' . $field['name'];
}
?>

例4: フィールドタイプに基づく条件付き表示

フィールドタイプを基に、特定のフィールドだけを取得して表示する例です。

<?php
$fields = acf_get_local_fields( 30 );
foreach ( $fields as $field ) {
    if ( $field['type'] === 'text' ) {
        echo $field['label'];
    }
}
?>

例5: フィールドグループのフィールドを処理する

フィールド情報を処理して、特定のフィールドの設定を変更する例です。

<?php
$fields = acf_get_local_fields( 40 );
foreach ( $fields as $field ) {
    if ( $field['name'] === 'special_field' ) {
        $field['label'] = 'New Label';
        echo $field['label'];
    }
}
?>

注意事項

• acf_get_local_fields() 関数は、フィールドグループIDを正しく指定しないとエラーが発生する場合があります。