acf_get_valid_field_group()

Advanced Custom Fields（ACF）のacf_get_valid_field_group()関数は、有効なフィールドグループのデータを取得するために使用されます。この関数を使用することで、フィールドグループの配列を取得し、必要に応じて操作することができます。

構文

acf_get_valid_field_group( array $field_group );

• $field_group (array) — 有効なフィールドグループデータを表す配列。この配列には、フィールドグループのプロパティが含まれます。

例 1: 有効なフィールドグループを取得

指定されたフィールドグループを取得し、有効な形式で返します。

$field_group = acf_get_valid_field_group( array( 'title' => 'カスタムフィールドグループ' ) );

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

有効なフィールドグループデータを取得し、そのタイトルを取得します。

$field_group = acf_get_valid_field_group( array( 'title' => 'サンプルグループ' ) );
echo $field_group['title'];

例 3: 配列のプロパティを検証

指定した配列を有効なフィールドグループとして検証します。

$field_group = array( 'key' => 'group_1', 'title' => 'デモグループ' );
$valid_group = acf_get_valid_field_group( $field_group );
var_dump( $valid_group );

例 4: フィールドグループのIDを設定

フィールドグループ配列にIDを追加します。

$field_group = acf_get_valid_field_group( array( 'key' => 'group_2' ) );
$field_group['ID'] = get_the_ID();

例 5: フィールドグループをカスタマイズ

フィールドグループにカスタムプロパティを追加します。

$field_group = acf_get_valid_field_group( array( 'title' => '拡張グループ' ) );
$field_group['custom_property'] = 'カスタム値';

注意事項

• 入力データが不完全または無効な場合、返される配列にはデフォルトのプロパティが含まれます。