roots / acorn-fse-helper
在基于Acorn的WordPress主题中提供Bootstrap FSE支持。
v1.0.1
2024-04-22 07:12 UTC
Requires
- php: >=8.1
Requires (Dev)
- laravel/pint: ^1.15
- roots/acorn: ^4.2
README
Acorn FSE Helper提供了一个简单的方式来初始化和在由Acorn提供动力的主题中使用块模板。
需求
安装
通过Composer安装
$ composer require roots/acorn-fse-helper
入门指南
安装完成后,请使用Acorn的CLI在您的主题中初始化全站编辑。
$ wp acorn fse:init
初始化确保您的当前激活的主题支持block-templates
,并提供选项以发布初始占位符以开始。
用法
初始化后,位于templates/
中的任何块模板都将优先于现有的Blade视图。
Blade指令
为了帮助进行混合主题开发,Acorn FSE Helper自带了一些有用的Blade指令,用于在视图中处理块。
@blocks
@blocks
指令允许您在视图中使用do_blocks()
渲染原始块标记。
@blocks <!-- wp:paragraph {"align":"center"} --> <p>Lorem ipsum...</p> <!-- /wp:paragraph --> @endblocks
@blockpart
@blockpart
指令提供了一种方便的方法,可以在视图中使用block_template_part()
渲染块模板部分。
@blockpart('header')
要一次性渲染多个模板部分,您可以按希望渲染的顺序传递一个数组。
@blockpart(['header', 'footer'])
错误报告
如果您发现Acorn FSE Helper中存在错误,请打开一个问题。
贡献
无论是通过PR、报告问题还是提出建议,都鼓励并感谢您的贡献。
许可
Acorn FSE Helper在MIT许可下提供。