WordPress 块主题的 functions.php 应该写什么:经典主题到块主题的迁移对照
如果你从经典主题转向块主题开发,会发现 functions.php 的角色发生了根本性变化。在经典主题中,functions.php 承担了大量配置工作;在块主题中,大部分工作被 theme.json 接管了。
经典主题中由 functions.php 完成的工作
经典主题的 functions.php 通常包含:注册导航菜单位置、注册小工具区域、启用特色图片和标题标签支持、定义编辑器颜色调色板、设置内容宽度、加载样式和脚本、添加自定义功能函数。
块主题中这些工作的去向
注册菜单:块主题使用 theme.json 或站点编辑器管理菜单,不需要在 functions.php 中注册。注册小工具区域:块主题的小工具区域在站点编辑器中管理。编辑器颜色调色板:由 theme.json 的 settings.color.palette 定义。内容宽度:由 theme.json 的 settings.layout 控制。
块主题 functions.php 中仍然需要的内容
加载样式表:块主题的 style.css 不会自动加载,需要在 functions.php 中使用 wp_enqueue_style 加载,并使用 get_stylesheet_uri 获取正确的路径,子主题时指向子主题的样式表。
启用块样式支持:add_theme_support('wp-block-styles') 启用核心块的默认样式。自定义 Logo 支持:add_theme_support('custom-logo') 如果主题需要 Logo 上传功能。
编辑器样式:如果主题的 style.css 需要影响编辑器中的显示,使用 add_editor_style('style.css')。块主题的 theme.json 样式会自动应用到编辑器,但 style.css 中的规则不会,除非显式添加。
子主题的注意事项
块主题的子主题中,theme.json 是合并而非替换。子主题只需要声明要覆盖的部分,不需要重复父主题的完整配置。另外,从 WordPress 5.7 开始,块主题的父主题样式表不再自动加载,需要在子主题中判断是否需要手动加载。

