跳转到正文

文章元数据

由于区块模板只是普通的 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"
    ]
  }
}