跳转到正文

简介

Blockstudio 让你只用 PHP,通过 WordPress block.json 格式创建自定义 WordPress 区块。它大大简化了区块注册、资源延迟加载和自定义字段方面的开发体验。

设计理念

专注核心

没有什么秘诀。Blockstudio 基于核心 WordPress 功能和 Gutenberg 组件构建。它被设计为一个轻量级抽象层,帮助你快速开始创建自定义区块。

服务端优先

WordPress 仅凭 PHP 就能注册简单区块:从 WordPress 7.0 起,register_block_type() 配合 autoRegister支持,即可通过其 render_callback 渲染区块,并为字符串、整数、布尔值和枚举属性生成基本的检查器控件。这些功能仅限于此;核心明确表示,它并非要取代客户端范式:它不支持内部区块、富文本、媒体字段或交互性,因此,只要需求超出少数几个基本控件,就仍然需要编写 JavaScript、运行构建,并在 PHP 和 JS 之间重复实现逻辑。

Blockstudio 从相同理念出发,并将其贯彻到底。你可以使用 PHP 编写区块模板,并使用类似 JSX 的标签添加 <RichText /> 或 <InnerBlocks /> 等交互内容。在编辑器中,这些标签会被替换为对应的 React。在前端,这些标签会被替换为 HTML 内容。

这样一来,你就能兼得两全:区块由服务器端渲染,同时在编辑器中拥有出色的交互性。

基于文件系统

虽然 WordPress 支持使用 WPDefinedPath 字符串类型采用基于文件的方式,但也可以从其他位置引用资源或模板。Blockstudio 则进一步将文件系统确立为注册区块的主要且唯一方式。这样决定并非为了限制,而是为了明确区块结构,避免产生争议。例如,如果在某个 block.json 所在的文件夹中发现了 style.css 或 script.js 文件,就可以确定它只属于这个区块。

无需设置

Blockstudio 开箱即用。它旨在简化自定义区块的组合过程,不会妨碍你的工作。想在模板中使用 Twig?只需重命名文件扩展名。需要包含一些 CSS?创建一个 style.css 文件即可。每当区块在页面上使用时,Blockstudio 都会自动将其加入队列;即使通过渲染函数在 post_content 之外使用,也同样如此。

有功能需求或问题?给我们留言。