acf_get_raw_fields()


ACFの関数acf_get_raw_fields()は、フィールドグループ内のすべての生のフィールドデータを取得するために使用されます。

シンタックス

acf_get_raw_fields();

使用例:

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

指定したフィールドグループIDに基づいてすべてのフィールドを取得します。

<?php 
$fields = acf_get_raw_fields();
print_r( $fields );
?>

例2: 取得したフィールドの名前を表示

フィールドグループからフィールド名のみを一覧表示します。

<?php 
$fields = acf_get_raw_fields();
foreach ( $fields as $field ) {
    echo $field['name'];
}
?>

例3: 特定のキーに一致するフィールドを検索

特定のキーでフィールドをフィルタリングします。

<?php 
$fields = acf_get_raw_fields();
foreach ( $fields as $field ) {
    if ( $field['key'] === 'field_123abc' ) {
        print_r( $field );
    }
}
?>

例4: カスタムHTML出力

フィールドをHTMLリスト形式で出力します。

<?php 
$fields = acf_get_raw_fields();
echo '<ul>';
foreach ( $fields as $field ) {
    echo '<li>' . $field['label'] . ' (' . $field['name'] . ')</li>';
}
echo '</ul>';
?>

例5: フィールドタイプごとの分類

取得したフィールドをタイプごとに分類して表示します。

<?php 
$fields = acf_get_raw_fields();
$field_groups = [];
foreach ( $fields as $field ) {
    $type = $field['type'];
    if ( !isset( $field_groups[$type] ) ) {
        $field_groups[$type] = [];
    }
    $field_groups[$type][] = $field;
}
print_r( $field_groups );
?>

注意事項

  • 関数はACFプラグインが有効でない場合エラーを引き起こします。
  • 返される配列は非常に大きい場合がありますので、適切なメモリ管理が必要です。