acf_is_field_group_key()

Advanced Custom Fields (ACF)プラグインにおけるacf_is_field_group_key()関数は、指定されたキーが有効なフィールドグループキーかどうかを確認するために使用されます。

シンタックス

acf_is_field_group_key( string $key );

• $key (string) — 確認したいフィールドグループキー。

戻り値:

• フィールドグループキーが有効な場合はtrueを返します。
• それ以外の場合はfalseを返します。

例 1: フィールドグループキーの確認

<?php if ( acf_is_field_group_key( 'group_1234567890abc' ) ) { echo '有効なキーです。'; } ?>

例 2: 管理画面での条件付き表示

管理画面の特定のページでフィールドグループキーを確認します。

<?php
if ( is_admin() && acf_is_field_group_key( 'group_1234567890abc' ) ) {
    echo 'このフィールドグループは管理画面で利用可能です。';
}
?>

例 3: カスタムフィールドグループの削除

キーが有効な場合にフィールドグループを削除します。

<?php
$key = 'group_1234567890abc';
if ( acf_is_field_group_key( $key ) ) {
    acf_delete_field_group( $key );
}
?>

例 4: 配列内のキーの検証

配列に含まれる複数のキーを検証します。

<?php
$keys = ['group_1', 'group_2', 'group_3'];
foreach ( $keys as $key ) {
    if ( acf_is_field_group_key( $key ) ) {
        echo $key . 'は有効なキーです。';
    }
}
?>

例 5: フロントエンドでの条件付き表示

特定のフィールドグループキーが有効である場合にフロントエンドで表示を切り替えます。

<?php
if ( ! is_admin() && acf_is_field_group_key( 'group_9876543210xyz' ) ) {
    echo 'このキーに関連するフィールドグループは有効です。';
}
?>

注意事項:

• キーはACFによって生成される一意のIDである必要があります。
• 無効なキーを渡した場合はfalseが返されます。