跳转到正文

初始化

区块模板只会在区块渲染时执行。这对大多数区块来说已经足够;但有时你需要在更早的执行阶段运行代码。例如,你可能想注册新的文章类型,或执行其他与区块无关的设置。

为此,请在区块目录中添加一个或多个 PHP 文件,文件名以 init 开头,例如 init.php、init-helpers.php 或 init-post-types.php。每个匹配的文件都会在 init 操作期间执行一次。有关此特定阶段的更多信息,请参阅 文档WordPress。

Init 文件可以放在 block.json 旁边,也可以放在独立目录中。放在区块旁边时,每个 init 文件仅负责执行:区块仍拥有同级资源以及 rpc.php、cron.php 和 db.php 定义。放在独立目录中时,init 入口拥有该目录的同级资源,因此支持基于文件的 代码片段。

示例

PHP
<?php
// Register a custom post type
register_post_type('project', [
  'labels' => [
    'name' => 'Projects',
    'singular_name' => 'Project',
  ],
  'public' => true,
  'has_archive' => true,
  'supports' => ['title', 'editor', 'thumbnail'],
]);