acf_remove_local_field_group()


WordPressの関数acf_remove_local_field_group()は、Advanced Custom Fields (ACF) プラグインを使用して、ローカルに登録されたカスタムフィールドグループを削除するための関数です。

構文

acf_remove_local_field_group( int|string $key );
  • $key (int|string) — 削除するフィールドグループのキー。フィールドグループのIDまたは名前を指定します。

例1: フィールドグループの削除

指定したIDのフィールドグループを削除します。

<?php acf_remove_local_field_group( 123 ); ?>

例2: フィールドグループ名を使用して削除

フィールドグループの名前を指定して削除します。

<?php acf_remove_local_field_group( 'my_custom_group' ); ?>

例3: フィールドグループをカスタム投稿タイプに追加する前に削除

フィールドグループをカスタム投稿タイプに追加する前に、以前に登録されたグループを削除します。

<?php
acf_remove_local_field_group( 'custom_field_group' );
acf_add_local_field_group(array(
    'key' => 'group_1',
    'title' => 'Custom Fields',
    'fields' => array(
        array(
            'key' => 'field_1',
            'label' => 'Custom Field',
            'name' => 'custom_field',
            'type' => 'text',
        ),
    ),
    'location' => array(
        array(
            array(
                'param' => 'post_type',
                'operator' => '==',
                'value' => 'post',
            ),
        ),
    ),
));
?>

例4: 条件に基づいてフィールドグループを削除

特定の条件に基づいてフィールドグループを削除します。

<?php
if ( is_admin() ) {
    acf_remove_local_field_group( 'admin_only_group' );
}
?>

例5: 複数のフィールドグループを削除

複数のフィールドグループを削除するために、ループを使用して削除します。

<?php
$groups = array( 'group_1', 'group_2', 'group_3' );
foreach ( $groups as $group ) {
    acf_remove_local_field_group( $group );
}
?>

注意点

  • フィールドグループが存在しない場合、この関数は何も行いません。
  • 引数として渡すキーは、フィールドグループのIDまたは名前である必要があります。

関連機能：