acf_untrash_field_group()

Advanced Custom Fields（ACF）の関数acf_untrash_field_group()は、削除されたフィールドグループを復元するために使用されます。この関数は、WordPressサイトでACFプラグインを使用する際に役立ちます。

シンタックス

acf_untrash_field_group( $field_group_key );

• $field_group_key (string) — 復元するフィールドグループのキー。

例1: 特定のフィールドグループを復元

フィールドグループキーを指定して復元します。

<?php acf_untrash_field_group( 'group_123abc' ); ?>

例2: 投稿メタデータを利用して復元

投稿に保存されたフィールドグループキーを利用して復元します。

<?php
$field_group_key = get_post_meta( get_the_ID(), 'acf_field_group_key', true );
acf_untrash_field_group( $field_group_key );
?>

例3: 全ての削除済みフィールドグループを復元

削除されたフィールドグループのリストを取得して復元します。

<?php
$trashed_groups = acf_get_field_groups(['status' => 'trash']);
foreach ( $trashed_groups as $group ) {
    acf_untrash_field_group( $group['key'] );
}
?>

例4: 特定条件に基づく復元

条件に一致するフィールドグループのみ復元します。

<?php
$trashed_groups = acf_get_field_groups(['status' => 'trash']);
foreach ( $trashed_groups as $group ) {
    if ( strpos( $group['title'], 'カスタム' ) !== false ) {
        acf_untrash_field_group( $group['key'] );
    }
}
?>

例5: フィルターフックを使用した復元

カスタムフィルターロジックを利用してフィールドグループを復元します。

<?php
add_action( 'init', function() {
    $groups_to_restore = apply_filters( 'my_custom_restore_filter', [] );
    foreach ( $groups_to_restore as $group_key ) {
        acf_untrash_field_group( $group_key );
    }
});
?>

注意事項

• フィールドグループキーが正確であることを確認してください。
• 復元後、フィールドグループの設定を確認して再度保存することを推奨します。