acf_update_field_group()

WordPressのacf_update_field_group()関数は、既存のフィールドグループを更新するために使用される。

シンタックス

acf_update_field_group( array $field_group );

引数の説明:

• $field_group (array) — 更新するフィールドグループのデータ。以下のキーを含む。
• key (string) — フィールドグループの一意のキー。
• title (string) — フィールドグループのタイトル。
• fields (array) — フィールドの配列。
• location (array) — フィールドグループの表示条件。
• menu_order (int) — 管理画面での表示順。
• position (string) — 表示位置（normal, side, acf_after_title）。

例1: フィールドグループのタイトルを変更

acf_update_field_group(array(
    'key' => 'group_123456',
    'title' => '新しいタイトル'
));

例2: フィールドグループに新しいフィールドを追加

$field_group = acf_get_field_group('group_123456');
$field_group['fields'][] = array(
    'key' => 'field_789',
    'label' => '新しいフィールド',
    'name' => 'new_field',
    'type' => 'text'
);
acf_update_field_group($field_group);

例3: 表示条件を変更

$field_group = acf_get_field_group('group_123456');
$field_group['location'] = array(
    array(
        array(
            'param' => 'post_type',
            'operator' => '==',
            'value' => 'page'
        )
    )
);
acf_update_field_group($field_group);

例4: 表示順を変更

acf_update_field_group(array(
    'key' => 'group_123456',
    'menu_order' => 2
));

例5: 表示位置を変更

acf_update_field_group(array(
    'key' => 'group_123456',
    'position' => 'side'
));

注意点

• 既存のフィールドグループのkeyが正しいか確認すること。
• 誤ったデータを渡すとエラーの原因になるため、データの整合性を保つこと。
• フィールドの変更を反映するためにはキャッシュのクリアが必要になる場合がある。