acf_get_raw_field_group()

acf_get_raw_field_group()は、Advanced Custom Fields (ACF) プラグインにおいて、指定されたフィールドグループの生のデータを取得するための関数です。この関数を使用することで、フィールドグループの詳細な構造を取得し、カスタム処理を行うことができます。

シンタックス

acf_get_raw_field_group( int $post_id );

• $post_id (int) — フィールドグループを取得するための投稿ID。

例1: フィールドグループの生データを取得する

指定された投稿IDのフィールドグループの生データを取得します。

<?php
$field_group = acf_get_raw_field_group( 123 );
print_r( $field_group );
?>

例2: フィールドグループが存在するか確認する

指定された投稿IDのフィールドグループが存在するかを確認します。

<?php
$field_group = acf_get_raw_field_group( get_the_ID() );
if( $field_group ) {
    echo 'フィールドグループが見つかりました';
} else {
    echo 'フィールドグループが見つかりません';
}
?>

例3: フィールドグループのタイトルを取得する

フィールドグループのタイトルを取得する方法です。

<?php
$field_group = acf_get_raw_field_group( 123 );
echo $field_group['title'];
?>

例4: フィールドグループのフィールドを表示する

フィールドグループ内のフィールドをループして表示する方法です。

<?php
$field_group = acf_get_raw_field_group( 123 );
if( isset( $field_group['fields'] ) ) {
    foreach( $field_group['fields'] as $field ) {
        echo $field['label'] . ': ' . $field['name'] . '<br>';
    }
}
?>

例5: フィールドグループから特定のフィールドを取得する

特定のフィールドグループから特定のフィールドを取得する方法です。

<?php
$field_group = acf_get_raw_field_group( 123 );
$fields = $field_group['fields'];
$field = $fields[0]; // 最初のフィールド
echo $field['label'];
?>

例6: フィールドグループの設定を変更する

フィールドグループの設定を変更する方法です。

<?php
$field_group = acf_get_raw_field_group( 123 );
$field_group['title'] = '新しいタイトル';
acf_update_field_group( $field_group );
?>

注意点

• 指定された投稿IDが存在しない場合、acf_get_raw_field_group()はnullを返します。