acf_get_field_groups()

WordPress関数acf_get_field_groups()は、Advanced Custom Fields（ACF）プラグインを使用して登録されたフィールドグループの情報を取得するために使用されます。

構文

acf_get_field_groups();

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

登録されているすべてのフィールドグループを取得し、それを出力します。

<?php
$field_groups = acf_get_field_groups();
foreach ( $field_groups as $group ) {
    echo $group['title'];
}
?>

例 2: 特定のポストに関連するフィールドグループを取得

現在の投稿に関連付けられたフィールドグループを取得します。

<?php
$field_groups = acf_get_field_groups( array( 'post_id' => get_the_ID() ) );
foreach ( $field_groups as $group ) {
    echo $group['title'];
}
?>

例 3: 特定の条件に基づいてフィールドグループを取得

特定の条件を使用してフィールドグループをフィルタリングします。

<?php
$field_groups = acf_get_field_groups( array( 'key' => 'group_123abc' ) );
foreach ( $field_groups as $group ) {
    echo $group['title'];
}
?>

例 4: 特定の位置に関連するフィールドグループを取得

ACFの「位置ルール」に基づいてフィールドグループを取得します。

<?php
$field_groups = acf_get_field_groups( array( 'location' => array( 'param' => 'post_type', 'operator' => '==', 'value' => 'page' ) ) );
foreach ( $field_groups as $group ) {
    echo $group['title'];
}
?>

例 5: フィールドグループの情報をJSON形式で出力

フィールドグループを取得し、JSON形式で出力します。

<?php
$field_groups = acf_get_field_groups();
echo json_encode( $field_groups );
?>

注意事項

• acf_get_field_groups()を使用する場合、ACFプラグインが有効化されていることを確認してください。
• フィールドグループ情報の変更はacf_add_local_field_group()を使用して行うべきです。
• 取得したデータをそのまま出力する際には、適切なエスケープ処理を実施してください。