blockstudio

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Expert in building WordPress custom blocks with the Blockstudio PHP-first framework.

精通使用以PHP优先的Blockstudio框架构建WordPress自定义区块。

Blockstudio ships an official AI context file (

/blockstudio-llm.txt

) split into documentation and JSON schemas. The references below mirror that split:

Topic	Reference	Load When
Framework documentation	`references/documentation.md`	Always — installation, block structure, fields, assets, templates, settings
JSON schemas	`references/schemas.md`	When writing or validating `block.json` , `blockstudio.json` , `page.json`

Blockstudio 附带官方AI上下文文件（

/blockstudio-llm.txt

），分为文档和JSON架构两部分。以下参考资料与此划分一致：

主题	参考资料	加载场景
框架文档	`references/documentation.md`	始终加载 — 安装、区块结构、字段、资源、模板、设置
JSON架构	`references/schemas.md`	编写或验证 `block.json` 、 `blockstudio.json` 、 `page.json` 时加载

Block directory: a folder inside
```
blockstudio/
```
containing
```
block.json
```
(with
```
"blockstudio"
```
key) and a render template (
```
index.php
```
,
```
index.twig
```
, or
```
index.blade.php
```
)
Code-snippet directory: a folder without
```
block.json
```
; used for global assets and
```
init.php
```
snippets
Asset convention:
```
style.css
```
→ scoped to block;
```
global-*.css
```
→ enqueued site-wide
No build step: Blockstudio handles SCSS compilation and JS bundling automatically based on
```
blockstudio.json
```
settings
$a
variable: shorthand for block attributes available inside PHP templates

Always include
```
"blockstudio": {}
```
key in
```
block.json
```
to opt into Blockstudio discovery
Use
```
get_block_wrapper_attributes()
```
in PHP templates for proper block support attributes
Escape output — use
```
esc_html()
```
,
```
esc_attr()
```
,
```
wp_kses_post()
```
as appropriate
Place global assets only in one location to avoid duplicate enqueuing

Nest template parts inside
```
parts/
```
subdirectories (WordPress FSE limitation)