告别繁琐的ACF配置：使用stoutlogic/acf-builder优雅管理你的WordPress自定义字段

<code class="bash">composer require stoutlogic/acf-builder</code>

<code class="php"><?php

use StoutLogic\AcfBuilder\FieldsBuilder;

// 创建一个名为 'banner' 的字段组
$banner = new FieldsBuilder('banner');
$banner
    ->addText('title') // 添加一个文本字段
    ->addWysiwyg('content') // 添加一个富文本编辑器字段
    ->addImage('background_image') // 添加一个图片字段
    // 设置字段组的显示位置：在页面或文章类型为 'page' 或 'post' 的地方显示
    ->setLocation('post_type', '==', 'page')
        ->or('post_type', '==', 'post');

// 在 ACF 初始化时注册字段组
add_action('acf/init', function() use ($banner) {
   acf_add_local_field_group($banner->build()); // 使用 build() 方法生成 ACF 兼容的数组
});</code>

<code class="php"><?php

use StoutLogic\AcfBuilder\FieldsBuilder;

// 定义一个可复用的背景字段组
$background = new FieldsBuilder('background');
$background
    ->addTab('Background') // 添加一个标签页
    ->addImage('background_image')
    ->addTrueFalse('fixed')
        ->instructions("勾选以添加视差效果，背景图片在滚动时不会移动")
    ->addColorPicker('background_color');

// 在 'banner' 字段组中复用背景字段
$banner = new FieldsBuilder('banner');
$banner
    ->addTab('Content')
    ->addText('title')
    ->addWysiwyg('content')
    ->addFields($background) // 插入背景字段组
    ->setLocation('post_type', '==', 'page');

// 在 'section' 字段组中多次复用背景字段
$section = new FieldsBuilder('section');
$section
    ->addTab('Content')
    ->addText('section_title')
    ->addRepeater('columns', ['min' => 1, 'layout' => 'block'])
        ->addTab('Content')
        ->addText('title')
        ->addWysiwyg('content')
        ->addFields($background) // 在重复字段内插入背景字段组
        ->endRepeater()
    ->addFields($background) // 在重复字段外也插入背景字段组
    ->setLocation('post_type', '==', 'page');

// 别忘了在 acf/init 钩子中注册它们
add_action('acf/init', function() use ($banner, $section) {
   acf_add_local_field_group($banner->build());
   acf_add_local_field_group($section->build());
});</code>