acf_get_raw_field_groups()

ACFの関数acf_get_raw_field_groups()は、登録されたすべてのフィールドグループを取得するために使用される。

シンタックス

acf_get_raw_field_groups();

この関数は引数を受け取らず、すべてのフィールドグループを配列として返す。

例1: すべてのフィールドグループを取得

$groups = acf_get_raw_field_groups();
print_r( $groups );

例2: フィールドグループ名を一覧表示

$groups = acf_get_raw_field_groups();
foreach( $groups as $group ) {
    echo '<li><code>' . esc_html( $group['title'] ) . '</code></li>';
}

例3: フィールドグループのキーを取得

$groups = acf_get_raw_field_groups();
foreach( $groups as $group ) {
    echo '<li><code>' . esc_html( $group['key'] ) . '</code></li>';
}

例4: 特定のフィールドを持つフィールドグループを検索

$groups = acf_get_raw_field_groups();
foreach( $groups as $group ) {
    foreach( $group['fields'] as $field ) {
        if( $field['name'] === 'custom_field' ) {
            echo '<li><code>' . esc_html( $group['title'] ) . '</code></li>';
        }
    }
}

例5: フィールドグループのIDを取得

$groups = acf_get_raw_field_groups();
foreach( $groups as $group ) {
    echo '<li><code>' . esc_html( $group['ID'] ) . '</code></li>';
}

注意点

• acf_get_raw_field_groups()は、データベース内のすべてのフィールドグループを取得するため、必要な情報のみを抽出する処理を追加することが推奨される。
• この関数はキャッシュを使用しないため、頻繁に呼び出すとパフォーマンスに影響を与える可能性がある。