acf_import_field_group()

Advanced Custom Fields (ACF)プラグインのacf_import_field_group()関数は、フィールドグループをインポートするために使用されます。この関数は、JSON形式で定義されたフィールドグループをWordPressに登録します。

構文

acf_import_field_group( array $field_group );

• $field_group (array) — インポートするフィールドグループの配列。

例 1: シンプルなフィールドグループのインポート

acf_import_field_group( array(
    'key' => 'group_1',
    'title' => 'カスタムフィールドグループ',
    'fields' => array(),
    'location' => array(
        array(
            array(
                'param' => 'post_type',
                'operator' => '==',
                'value' => 'post',
            ),
        ),
    ),
));

例 2: カスタムフィールドを含むインポート

acf_import_field_group( array(
    'key' => 'group_2',
    'title' => '商品情報',
    'fields' => array(
        array(
            'key' => 'field_1',
            'label' => '価格',
            'name' => 'price',
            'type' => 'number',
        ),
    ),
    'location' => array(
        array(
            array(
                'param' => 'post_type',
                'operator' => '==',
                'value' => 'product',
            ),
        ),
    ),
));

例 3: 特定の条件でのフィールドグループのインポート

acf_import_field_group( array(
    'key' => 'group_3',
    'title' => 'イベント情報',
    'fields' => array(
        array(
            'key' => 'field_2',
            'label' => '開催日',
            'name' => 'event_date',
            'type' => 'date_picker',
        ),
    ),
    'location' => array(
        array(
            array(
                'param' => 'taxonomy',
                'operator' => '==',
                'value' => 'event',
            ),
        ),
    ),
));

例 4: サブフィールドを持つリピーターフィールドのインポート

acf_import_field_group( array(
    'key' => 'group_4',
    'title' => 'ギャラリー',
    'fields' => array(
        array(
            'key' => 'field_3',
            'label' => '画像リスト',
            'name' => 'image_list',
            'type' => 'repeater',
            'sub_fields' => array(
                array(
                    'key' => 'sub_field_1',
                    'label' => '画像',
                    'name' => 'image',
                    'type' => 'image',
                ),
            ),
        ),
    ),
    'location' => array(
        array(
            array(
                'param' => 'post_type',
                'operator' => '==',
                'value' => 'gallery',
            ),
        ),
    ),
));

例 5: 高度な条件でのフィールドグループのインポート

acf_import_field_group( array(
    'key' => 'group_5',
    'title' => 'ページ設定',
    'fields' => array(
        array(
            'key' => 'field_4',
            'label' => 'ヘッダー画像',
            'name' => 'header_image',
            'type' => 'image',
        ),
    ),
    'location' => array(
        array(
            array(
                'param' => 'page_template',
                'operator' => '==',
                'value' => 'template-custom.php',
            ),
        ),
    ),
));