acf_delete_field_group()

WordPressの関数acf_delete_field_group()は、Advanced Custom Fields（ACF）プラグインを使用してカスタムフィールドグループを削除するために使用されます。この関数は、指定されたフィールドグループの削除を実行し、データベースからそのグループを完全に削除します。

構文

acf_delete_field_group( int $field_group_id );

• $field_group_id (int) — 削除するフィールドグループのIDを指定します。

例1: フィールドグループを削除する

このコードは、指定されたフィールドグループIDを使ってフィールドグループを削除します。

acf_delete_field_group( 123 );

例2: フィールドグループIDを動的に取得して削除

フィールドグループのIDを動的に取得し、そのIDを使って削除を行います。

$field_group_id = acf_get_field_group_id_by_name( 'sample_group' );
acf_delete_field_group( $field_group_id );

例3: 投稿のカスタムフィールドを削除する前にチェック

指定されたフィールドグループが存在するかをチェックしてから削除します。

$field_group_id = acf_get_field_group_id_by_name( 'sample_group' );
if( $field_group_id ) {
    acf_delete_field_group( $field_group_id );
}

例4: フィールドグループを削除後に再取得

フィールドグループを削除した後、再度そのIDを使用してフィールドグループが存在しないことを確認します。

acf_delete_field_group( 123 );
$field_group = acf_get_field_group( 123 );
if( !$field_group ) {
    echo 'フィールドグループは削除されました。';
}

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

複数のフィールドグループIDを配列で指定し、一括削除を行います。

$field_group_ids = [123, 124, 125];
foreach( $field_group_ids as $id ) {
    acf_delete_field_group( $id );
}

注意事項

• 削除されたフィールドグループは復元できません。慎重に使用してください。
• フィールドグループが依存するデータや他の設定がある場合、それらも削除される可能性があります。