micropackage/acf-block-creator

ACF Block Creator - ACF 的自动块创建插件

1.0.6 2022-03-17 08:54 UTC

This package is auto-updated.

Last update: 2024-09-17 13:59:52 UTC


README

BracketSpace Micropackage Latest Stable Version PHP from Packagist Total Downloads License

Micropackage logo

🧬 关于 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、类别等)可以使用字段组创建表单底部的附加字段进行调整。

ACF Block Creator demo

静默初始化

由于这是一个开发包,在生产环境中没有用,我们可能不希望将其初始化代码放入主题的生产包中。因此,如果这两个包都存在,此包将由 Block Loader 自动初始化。

因此,如果我们将其添加为开发依赖项,然后运行 composer install --no-dev,则此包将不存在,并且不会由 BlockLoader 加载。

然后可以直接将此包的所有配置参数传递给 BlockLoader::init 方法。

此外,由于它将自动获取 BlockLoader 的 dir 参数的值,因此不需要 blocks_dir 参数。如果您配置了自定义类别,它也将自动用作新块的默认类别。

⚙️ 配置

所有参数都是可选的。

📦 关于 Micropackage 项目

Micropackages - 如其名所示 - 是具有少量可重用代码的微型包,特别是在 WordPress 开发中非常有用。

目标是拥有多个包,可以将它们组合起来创建更大的东西,只需定义结构即可。

Micropackages 由 BracketSpace 维护。

📖 更新日志

查看更新日志文件.

📃 许可证

GNU 通用公共许可证(GPL)v3.0。有关更多信息,请参阅 LICENSE 文件。