micropackage / acf-block-creator
ACF Block Creator - ACF 的自动块创建插件
Requires
- php: >=5.6
- micropackage/dochooks: ^1.0
- micropackage/filesystem: ^1.0
- micropackage/singleton: ^1.1
Requires (Dev)
This package is auto-updated.
Last update: 2024-09-17 13:59:52 UTC
README
🧬 关于 ACF Block Creator
此包简化了 WordPress 中使用高级自定义字段插件 Gutengberg 编辑器的块创建。它扩展了 Block Loader 包的功能,并打算与其一起使用。
在创建块时,此包将自动创建一个带有基本标记的 ACF 字段块模板文件。
💾 安装
composer require --dev micropackage/acf-block-creator
🕹 使用方法
在您开始创建块之前,此包需要初始化
Micropackage\ACFBlockCreator\ACFBlockCreator::init( [ 'blocks_dir' => 'blocks', 'scss_dir' => false, 'default_category' => 'common', 'block_container_class' => 'block-inner', 'package' => true, 'license' => 'GPL-3.0-or-later', ] );
需要做的事情就是创建一个新的以 "Block:" 开头的 ACF 字段组。它将自动创建一个块模板文件并将字段组位置设置为创建的块。
块参数(块名称、slug、类别等)可以使用字段组创建表单底部的附加字段进行调整。
静默初始化
由于这是一个开发包,在生产环境中没有用,我们可能不希望将其初始化代码放入主题的生产包中。因此,如果这两个包都存在,此包将由 Block Loader 自动初始化。
因此,如果我们将其添加为开发依赖项,然后运行 composer install --no-dev
,则此包将不存在,并且不会由 BlockLoader 加载。
然后可以直接将此包的所有配置参数传递给 BlockLoader::init
方法。
此外,由于它将自动获取 BlockLoader 的 dir
参数的值,因此不需要 blocks_dir
参数。如果您配置了自定义类别,它也将自动用作新块的默认类别。
⚙️ 配置
所有参数都是可选的。
📦 关于 Micropackage 项目
Micropackages - 如其名所示 - 是具有少量可重用代码的微型包,特别是在 WordPress 开发中非常有用。
目标是拥有多个包,可以将它们组合起来创建更大的东西,只需定义结构即可。
Micropackages 由 BracketSpace 维护。
📖 更新日志
📃 许可证
GNU 通用公共许可证(GPL)v3.0。有关更多信息,请参阅 LICENSE 文件。