文章元数据
由于区块模板只是普通的 PHP 文件,你可以在其中使用任意 PHP 代码。在文章编辑器中,区块预览会将正在编辑的文章作为全局 $post 变量进行渲染,因此 get_the_ID() 以及其他依赖该变量的函数也能正常工作。没有正在编辑的文章的编辑器(例如站点编辑器)则没有全局 $post。
Blockstudio 提供了四种不同方式,可在编辑器和前端访问当前文章 ID。
PHP
PHP
echo $post_id;
echo $postId;
echo $block['postId'];
echo $b['postId'];
Twig
Twig
{{ post_id }}
{{ postId }}
{{ block.postId }}
{{ b.postId }}
获取文章元数据
所有常见的自定义字段插件以及 WordPress 本身,都支持通过文章 ID 访问文章元数据。
ACF
PHP
PHP
echo get_field('field_name', $post_id);
Twig
Twig
{{ fn('get_field', 'field_name', postId) }}
元数据框
PHP
PHP
echo rwmb_get_value('field_id', null, $post_id);
Twig
Twig
{{ fn('rwmb_get_value', 'field_id', postId) }}
刷新区块
默认情况下,保存或更新文章时不会刷新区块。因此,保存后编辑器中可能会显示旧数据。若要解决此问题,可以在 block.json 中使用 refreshOn 键,告知 Blockstudio 在保存文章时刷新区块。
JSON
{
"name": "blockstudio/native",
"title": "Native Block",
"category": "text",
"icon": "star-filled",
"description": "Native Blockstudio block.",
"blockstudio": {
"refreshOn": [
"save"
]
}
}