模板

欢迎来到关于使用 theme.json 文件的课程,我们将从零开始注册一个自定义模板。

通过本课程,你将能够:

  • 从零构建一个自定义模板,并将其导出到本地主题文件夹中,
  • 使用 theme.json 文件注册自定义模板,以及
  • 熟悉使用 Create Block Theme 插件更新模板的工作流程。

创建自定义模板

构建主题最快的方法是在站点编辑器中工作,并使用像 Create Block Theme 这样的插件,你可以直接将更改推送到主题文件中。

让我们进入站点编辑器。我们将查看默认的 Twenty Twenty-Four 主题中可用的模板。我们可以看到所有这些模板的作者都是 Twenty Twenty-Four。现在我们可以进入代码编辑器查看这些文件。我们在 templates 文件夹中找到了它们全部列在这里。

在 theme.json 中注册自定义模板

所有自定义模板都在 theme.json 中注册。我们有多个页面模板和一个单篇文章模板。我们在这里看到名称与文件名对应。

添加新模板

回到 WordPress 中,我们首先点击“添加新模板”来创建自定义模板。我们将选择“单篇文章”和“所有文章”。接下来,选择一个模式以节省时间,或者你可以从头开始。如果点击保存,模板将保存到数据库中。

如果我们进入模板,我们会看到它在那里,即“单篇文章”。如果我们进入“管理所有模板”,我们会看到它显示为用户更改,这意味着它存在于数据库中,尚未成为主题文件的一部分。

使用 Create Block Theme 插件更新主题文件

为了导出模板,我们需要使用 Create Block Theme 插件。我们从进行更改并将这些更改保存到数据库开始。每次,我们都可以使用 Create Block Theme 插件保存更改,将这些更改从数据库推送到主题文件中。

如果我们进入代码编辑器,我们会看到自定义模板 Single-Post。现在,如果我们愿意,可以将其重命名为更具描述性的名称。我将命名为 No Image。

注册自定义模板

现在你可以使用 theme.json 文件注册新的自定义模板。这使我们能够为模板指定一个自定义名称。我们将名称设为 No Image,与文件名对应,然后给它一个标题。这就是用户在前端看到的内容。

保存这些更改,然后返回站点编辑器并重新加载。现在进入“所有模板”并向下滚动,你会看到 single No Featured Image 模板现在是主题文件的一部分。

下一步

一如既往,你可以参考 WordPress.org 上的主题手册。在下一个模块中,我们将深入探讨创建模板、模板层次结构和模板部分。