acf_get_fields()


WordPressのacf_get_fields()関数は、Advanced Custom Fields（ACF）プラグインで使用される関数で、指定されたフィールドグループに属するフィールドの配列を取得します。

構文

acf_get_fields( $field_group );
  • $field_group(mixed) — フィールドグループのID、キー、または配列を指定します。

例1: フィールドグループのIDを使用してフィールドを取得

フィールドグループのIDを使用して、そのフィールドグループに属するフィールドを取得します。

$fields = acf_get_fields( 123 );

例2: フィールドグループのキーを使用してフィールドを取得

フィールドグループのキーを使用して、そのフィールドグループに属するフィールドを取得します。

$fields = acf_get_fields( 'group_5f9d8c8b8a7b6' );

例3: フィールドグループの配列を使用してフィールドを取得

フィールドグループの配列を使用して、そのフィールドグループに属するフィールドを取得します。

$field_group = acf_get_field_group( 'group_5f9d8c8b8a7b6' ); $fields = acf_get_fields( $field_group );

例4: フィールドグループのフィールドをループして表示

取得したフィールドをループして、各フィールドのラベルと値を表示します。

$fields = acf_get_fields( 123 ); foreach( $fields as $field ) { echo $field['label'] . ': ' . $field['value'] . '<br>'; }

例5: フィールドグループのフィールドをフィルタリング

特定の条件に基づいてフィールドをフィルタリングします。

$fields = acf_get_fields( 123 ); $filtered_fields = array_filter( $fields, function( $field ) { return $field['type'] === 'text'; } );

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

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

$fields = acf_get_fields( 123 ); echo json_encode( $fields );

例7: フィールドグループのフィールドをデバッグ

取得したフィールドをデバッグ用に出力します。

$fields = acf_get_fields( 123 ); echo '<pre>'; print_r( $fields ); echo '</pre>';

例8: フィールドグループのフィールドをカスタムテンプレートで表示

取得したフィールドをカスタムテンプレートを使用して表示します。

$fields = acf_get_fields( 123 ); foreach( $fields as $field ) { include( 'field-template.php' ); }

注意点:

  • フィールドグループが存在しない場合、acf_get_fields()は空の配列を返します。
  • フィールドグループのIDやキーが正しくない場合、期待した結果が得られないことがあります。
  • ACFプラグインが有効化されていない場合、この関数は使用できません。

関連機能：