acf-builder

ACF Builder

使用构建器模式和流畅 API 为 Advanced Custom Fields Pro 创建配置数组。 快速创建、注册和重复使用 ACF 配置,并将其保存在源代码仓库中。如需了解如何通过 php 注册 ACF 字段,请参阅 https://www.advancedcustomfields.com/resources/register-fields-via-php/

简单示例

$banner = new StoutLogic\AcfBuilder\FieldsBuilder('banner');
$banner
    ->addText('title')
    ->addWysiwyg('content')
    ->addImage('background_image')
    ->setLocation('post_type', '==', 'page')
        ->or('post_type', '==', 'post');

add_action('acf/init', function() use ($banner) {
   acf_add_local_field_group($banner->build());
});

$banner->build(); 将返回:

…

如您所见,这节省了大量的输入工作,而且错误发生的可能性也小了。但简洁性和正确性并不是唯一的优势,您可以在多个地方重复使用字段配置。例如,用于背景的字段组:

重用示例

…

这里创建了一个background字段组，然后在另外两个字段组中使用，其中section字段组中使用了两次。这可以真正地简化您的代码，并保持您的管理界面一致。如果您想根据使用的背景为文本颜色字段添加一个亮/暗字段，只需在一个位置添加它，并在所有地方使用即可。

要求 PHP 5.4 到 7.2 支持,但自动化测试无法继续运行,因此可能在某个时候停止工作。 >= 7.4, 8 已测试