标题：WordPress 7.0 开发者指南
作者：Amy Kamala
发布日期：2026 年 5 月 14 日
最后修改：2026 年 5 月 18 日

---

Amy Kamala
2026 年 5 月 14 日凌晨 3:44
标签：7-0 ( 67 )、开发者指南 ( 34 )

WordPress 7.0 开发者指南

本指南概述了 7.0 版本中的主要开发者功能和破坏性变更，在发布候选阶段发布，供 WordPress 扩展开发者、Core 开发者及相关人员参考。

WordPress 7.0 包含了超过 419 个 Core Trac7 工单，其中 超过 76 个是增强功能和功能请求，以及 超过 300 个错误修复。此版本包含 40 多个与编辑器相关的工单，以及 90 多个与 wp-admin 相关的工单。

本次发布还包含针对编辑器、仪表盘及 AI 集成的 411 项增强 以及 超过 486 项错误修复。

以下是 WordPress 7.0 中最重要的开发者相关变更的详细说明。

1. 未来的 AI 构建模块
2. a. WP AI Client
   b. 客户端能力 API
   c. AI 连接器屏幕
   d. 连接器 API
3. 现代化仪表盘
4. a. 新的后台配色方案和样式
   b. WP 管理后台中的视图过渡
   c. 命令面板快捷键
   d. 字体库
   e. 可视化修订
   f. 内嵌框架编辑器
   g. 移动端自定义导航覆盖层
   h. 响应式编辑模式
   i. 区块样板编辑与 contentOnly 交互性
5. 设计灵活性
6. a. 区块级自定义 CSS9
   b. 标题区块
   c. 面包屑区块
   d. 导航区块
   e. 视频嵌入封面区块
   f. 画廊区块
   g. 新增

   区块支持
   h. 尺寸支持增强

7. 开发者工具箱
8. a. 纯 PHP11 区块注册
   b. 交互性 API
   c. DataViews 和 DataForms
   d. 区块绑定 API 迭代
   e. 新的插件列表过滤器
   f. 站点编辑器构建与路由
9. 开发者额外福利
10. a. 针对类内容自定义文章类型的区块钩子
    b. 更安全的用户注册
    c. CodeMirror 更新至 v5
    d. 外部库更新
    e. PHP 更新
11. 无障碍性
12. 等等，还有更多！

未来的 AI 构建模块

WordPress 7.0 首次将 AI 功能与能力集成到核心中。不绑定特定提供商的架构让你能够自主选择各项单元和能力，挖掘 AI 的潜力。这些构建模块还只是起点——更多功能（如智能体协作）将在此基础上逐步展开。

WP AI 客户端

WordPress 7.0 将 AI 能力直接引入你的网站。新的 WP AI 客户端提供了一个中央接口，让插件可以与生成式 AI 模型通信，且不绑定任何特定提供商。WordPress 核心负责请求路由。所有配置在 设置 > 连接器 界面中管理，API 密钥通过连接器 API 传递。你可以从内置的预设模型入手，也可以添加自己偏好的模型。

能力 API 已直接集成到 WP AI 客户端，提供了一系列可编排进工作流的新能力，让它们依次流畅运行。

插件开发者可使用新的 using_model_preference() 函数按偏好顺序指定模型，再通过功能检测将能力与可用模型匹配，降低调用成本、加快响应速度。AI 客户端内置了一系列高级配置控件，以及一个 WP_AI_Client_Prompt_Builder 类，用于调用方法。升级方面，wordpress/wp-ai-client 包会自动处理向 7.0 的过渡。

在 WordPress 7.0 中引入 AI 客户端

客户端能力 API

WordPress 7.0 扩展了能力 API，引入了对应的 JavaScript 实现——客户端能力包，涵盖新增与混合能力、直观的用户界面、命令面板，以及过滤器和查询功能。

插件开发者可以注册加载 @wordpress/core-abilities（通过 REST API² 自动获取并注册服务端能力），也可以只注册加载 @wordpress/abilities 来处理插件的客户端能力。已注册的能力按可自定义的类别组织，能力和类别均可通过 PHP API 取消注册。元数据注释受支持，core/abilities 提供了 useSelect，用于在 React⁴ 组件中进行响应式查询。

WordPress 7.0 中的客户端能力 API

AI 连接器屏幕

新的连接器屏幕为所有 AI 提供商连接提供一站式管理。它位于仪表盘的 设置 > 连接器 下，提供连接管理所需的全部功能。已注册的连接器自动显示在页面上，以卡片格式展示详细的注册元数据。连接器屏幕内置三个默认提供商——Anthropic、Google 和 OpenAI——用户也可以自行配置连接。

连接器 API

连接器 API 是连接器屏幕的支柱，它是一个可扩展性 API，用于支持代理的集成。

该 API 基于提供商元数据支持两种认证方式（api_key 和 none），后续版本中还将支持更多连接器类型。连接器 API 利用 WP AI Client 的默认注册表自动发现提供商，并通过对应元数据生成连接器；通过其他方式认证的连接器则存储在 PHP 注册表中。你可以使用 wp_connectors_init 操作来覆盖连接器元数据——这是未来版本中注册新连接器类型的关键机制。连接器 API 提供三个用于查询注册表的公共函数，前端 UI¹⁴ 可通过客户端 JavaScript 注册进行自定义。

在 WordPress 7.0 中引入连接器 API

---

现代化仪表盘

WordPress 7.0 对后台管理（及超级管理员）体验做了全面升级：名为 Modern 的焕新配色方案、仪表盘中众多功能增强、跨屏幕导航时的无缝视觉过渡。顶部工具栏新增了命令面板快捷键，从仪表盘任意位置都能调用工具；新的专用字体管理页面则将字体管理集中到一处。增强后的内嵌框架文章编辑器让编辑界面更加稳定，编辑者可以在区块上留下评论、接收笔记通知，甚至直观地对比两个修订版本。

新的后台配色方案和样式

WordPress 管理界面因仪表盘中全新的 Modern 配色方案而面貌一新。新的 Modern 管理主题已覆盖后台页面头部、Customizer（内置于 WordPress 核心的工具，可挂钩大多数现代主题，用于预览和修改网站外观设置）、配色方案选择器、脚本加载器、各项用户功能，甚至多站点用户注册界面也一并重新设计。多站点指具有多个博客网络的 WordPress 安装，按站点分组。此安装类型共享用户表，并为每个博客创建独立的数据库表（wp_posts 变为 wp_0_posts）。另请参见 网络、博客、站点。Modern 主题简洁明快，拥有焕新的调色板、更高的对比度和升级的排版，整体提升了后台管理体验。

WP 管理后台中的视图过渡

导航仪表盘在 7.0 中变得流畅自然。在 wp-admin 中移动时，用户视图会从一个屏幕平滑滑入下一个。跨文档视图过渡为管理菜单项分配了不同的过渡名称，当活动子菜单切换时触发这一视觉滑动效果。为照顾所有用户的体验，视图过渡仅在操作系统层面未设置”减少动画”偏好时才会激活。

命令面板快捷键

新的命令面板快捷键让你一键即可从仪表盘任意位置调出编辑工具集。WordPress 7.0 在顶部工具栏中为登录用户添加了 ⌘K 或 Ctrl+K 图标，点击即可展开命令面板。这个新快捷键让编辑操作更加顺手，无论你是在构建页面、调整设计，还是翻看笔记，都能在仪表盘各处随时调用。

字体库

7.0 中的字体库进一步扩展，新增了专门的字体管理页面。你和团队现在可以集中管理、上传和安装字体，适用于区块主题、混合主题和经典主题。

可视化修订

可视化修订让编辑工作更加直观。用户可以直接在编辑器中通过滑块对比两个修订版本，并在修订之间自由切换。文档检查器会显示更改摘要；每处修改都有颜色指示器和清晰可见的变更量，点击即可跳转到页面上的对应位置。

内嵌框架编辑器

7.0 中改进的内嵌框架编辑器为文章编辑体验提供了更好的稳定性。当文章中所有已插入的区块 API 版本均为 v3 或更高时，内嵌框架文章编辑器会强制启用。如果不满足此条件，内嵌框架将移除，以确保对低版本区块的向后兼容性。

WordPress 7.0 中的内嵌框架编辑器更改

创意定制

7.0 通过增强的设计工具和新的编辑功能为创作松绑。用户现在可以自定义移动端导航覆盖层、按设备精细控制单个区块的可见性，以及以样板为单位进行编辑。

移动端自定义导航覆盖层

汉堡菜单覆盖层现在可以在站点编辑器中用区块和区块样板自由构建。专用的导航覆盖层关闭区块让你可以在覆盖层内任意位置放置并设置关闭按钮的样式，为用户和主题作者提供了定义移动端导航体验的充分自由度。

就地覆盖层选择与预览功能带来了无缝的编辑体验——用户可以查看并分配覆盖层，主题也可以提供默认模板以快速完成设置。

WordPress 7.0 中的可自定义导航覆盖层

响应式编辑模式

WordPress 7.0 引入了基于设备类型的可自定义区块可见性，编辑者可以按设备隐藏或显示区块，而不影响其他视口。启动区块可见性选项的控件分布在区块工具栏、区块检查器边栏和命令面板中。边栏是 WordPress 中由主题使用的、用于显示非主要内容的、支持小工具的区域。它不限于侧边的垂直列，也可以是内容区域下方或上方的水平矩形、页脚、页眉或主题中的任何位置。列表视图会为设定了可见性规则的区块显示图标，标注它们被隐藏的视口。

7.0 还支持更改不同断点的样式、自定义断点大小等更多响应式控制。

WordPress 7.0 中的区块可见性

区块样板编辑与 contentOnly 交互性

7.0 对区块样板编辑做了多项改进：自定义区块的样板覆盖、上下文样板和符号样板的层级编辑模式、按钮和列表区块的父子树状视图，以及退出 contentOnly 模式的选项。

contentOnly 模式现在将作为此前依赖无限制编辑内部区块的样板的默认设置。新增的 disableContentOnlyForUnsyncedPatterns 设置和 block_editor_settings_all PHP 过滤器，则允许为未同步样板退出 contentOnly 模式。

contentOnly 模式在 7.0 中应用范围更广。这意味着：如果某个区块嵌套在启用了 contentOnly 的样板中，插件开发者须确保代表区块内容的属性在 block.json 中设置了 "role": "content"。这样才能保留其可编辑性，并防止它们在列表视图中被隐藏。

区块开发者可为区块声明 "listView": true 区块支持，这会在区块检查器中新增 列表视图 标签页，提供专用视图，方便编辑者更新和自定义区块。

WordPress 7.0 中的区块样板编辑

支持区块绑定的区块属性现在也支持自定义区块的样板覆盖。样板覆盖现在适用于任何区块（包括自定义区块），并可通过 block_bindings_supported_attributes 过滤器选择启用。属性值会出现在动态和静态区块的渲染标记中。如果静态区块的属性比 HTML（超文本标记语言，主要用于在网页浏览器中输出内容的语义脚本语言）API 能处理的更复杂，可使用 render_callback() 函数来确保绑定的属性值正确渲染。

WP 7.0 中的样板覆盖：支持自定义区块

---

设计灵活性

WordPress 7.0 在设计上更加灵活。7.0 内置了新的标题区块、图标区块和面包屑导航区块；画廊区块新增灯箱支持；导航链接区块支持动态 URL¹²（即互联网上网站或网页的特定网址，例如 www.wordpress.org）。文本行缩进、文本列布局、尺寸宽度和高度支持、尺寸预设与控件、宽图和全图的宽高比控制也同步加入。

区块级自定义 CSS

7.0 允许在页面上对单个区块应用自定义 CSS。这让编辑者可以精细控制内容的每个细节，快速直观地调整样式。

标题区块

新的标题区块整合了所有标题级别变体，可在边栏检查器中轻松切换，支持快速转换，并出现在搜索和斜杠插入器中。

面包屑区块

新的面包屑区块会自动反映站点的导航层级，可在主题头部等站点部件中全局应用。新增的过滤器允许开发者添加、删除和修改面包屑路径，并指定哪些分类法和术语出现在路径中。

面包屑区块过滤器

导航区块

编辑导航区块现在更加简单——改进了插入功能、样板编辑的交互性及 ContentOnly 模式，并优化了”绑定”页面项目的呈现方式。

视频嵌入封面区块

现在可以在封面区块中将视频作为区域背景嵌入。

画廊区块

画廊区块现在支持灯箱效果，并新增了幻灯片选项。只需创建并插入一个画廊，点击展开图标，然后选择”点击放大”。

新增 <p> 区块支持

段落区块中的文本现在可以按列布局排列，并引入了可选的 textIndent 区块支持，用于排版控制。

新增区块支持：文本缩进 (textIndent)

更多关于新增和改进区块的详细信息，请参阅：

每个区块的设计工具清单（WordPress 7.0 版）

尺寸支持增强

7.0 引入了区块的宽度和高度支持、段落中的排版文本缩进支持，以及 theme.json 层面对核心/按钮区块的伪元素支持（':hover'、':focus'、':focus-visible'、':active'）。theme.json 中还为宽度、高度和最小高度等区块支持新增了尺寸预设值。区块变体可以控制相同的伪元素，开发者也可以利用一组预定义的尺寸预设，减少跨多个区块手动设置相同值的工作量。

WordPress 7.0 中的尺寸支持增强

---

开发者工具箱

7.0 为开发者准备了一套丰富的工具箱：新的构建工具、增强的支持性结构，以及扩展的 API 能力。开发者现在可以在服务器端创建纯 PHP 的区块表示，自定义插件列表过滤器，并使用更具可扩展性的站点编辑器基础布局。

纯 PHP 区块注册

WordPress 7.0 允许直接在服务器端使用 PHP 创建区块和区块样板，并通过 Block API 进行注册。纯 PHP 的区块和区块样板表示包括样板创建和语法支持，简化了创建和绑定过程。当区块声明 'supports' => array( 'autoRegister' => true ) 并附带渲染回调时，会自动完成注册，并通过 JavaScript 全局变量暴露给客户端。PHP 注册的区块属性可在编辑器中编辑，检查器控件可从属性自动生成，PHP 自动注册的区块还会自动添加 DataForm 检查器控件。

纯 PHP 区块注册

交互性 API

@wordpress/interactivity 包中引入了新的 watch() 函数，用于订阅回调中访问的任何信号的变化，并在这些信号变化时重新运行回调。API 的 data-wp-watch 可添加到 DOM¹⁰ 元素的生命周期中并对状态变化做出响应。state.url 值现在在指令处理期间由服务器端填充，在首次客户端导航发生前保持不变。

WordPress 7.0 中交互性 API 的变更

DataViews 和 DataForms

体验新的活动布局、详情布局、改进的模态外观，以及在 Field API 中注册第三方类型的支持。

WordPress 7.0 中的 DataViews、DataForm 等

区块绑定 API 迭代

引入了区块绑定和样板覆盖功能，可按格式过滤可用的属性源，与 Field API 保持一致。

新的插件列表过滤器

get_views() 中新增了 plugins_list_status_text 过滤器，支持自定义过滤。通过 plugins_list 添加的自定义状态现在会作为标签页显示，用于过滤相关插件。标签文本可通过新的 plugins_list_status_text 钩子自定义。

站点编辑器构建与路由

7.0 为可扩展的站点编辑器和路由奠定了基础，包括路由验证、新的 @wordpress/boot 包（允许插件构建自定义站点编辑器页面），以及重构的 @wordpress/scripts（从目录构建，减少对 Webpack 的依赖）。

---

开发者额外福利

WordPress 7.0 包含覆盖核心多个领域的更新。这些变更支撑着持续进行的开发计划，为开发者打造灵活的基础，拓展更多可能性。

针对类内容自定义文章类型的区块钩子

区块钩子的逻辑已从单个文章类型过滤器迁移至 REST 控制器。

更安全的用户注册

管理员和编辑角色已从管理界面”常规”设置下的新用户默认角色选择器中移除。站点健康现在会在更新前检测是否选中了这些角色。新增的 default_role_dropdown_excluded_roles 过滤器允许开发者自定义默认排除的角色列表。

CodeMirror 更新至 v5

CodeMirror 已更新至最新的 v5 版本，CSSLint、HTMLHint 和 JSONLint 同步更新。Esprima 已被 Espree 取代，以支持 ES6¹³ 和 JavaScript 代码检查。

外部库更新

• backbone.js 已升级 至最新版本 (1.6.1)。
• Requests 库已从 2.0.11 更新至 2.0.17。

PHP 更新

• WordPress 核心的 最低 PHP 版本现为 7.4。
• PHPMailer 已更新 至版本 7.0.2，其中包含发件人地址错误修复。

---

无障碍性

WordPress 7.0 包含大量改进，让内容对所有人都更易于访问。登录密码重置功能现在会预填用户名，符合 WCAG⁶（Web Content Accessibility Guidelines，网页内容无障碍指南）2.2 标准。这些指南旨在确保无论用户以何种方式访问互联网——屏幕阅读器、仅键盘操作等——都能无障碍使用。

新增的 wp_get_image_alttext() 函数可从图片 IPTC⁸ 元数据中导入替代文本。.screen-reader-text 已添加 word-break 属性，确保屏幕阅读器不会将隐藏文本中的单词拆分为单个字母读取，并且仅在未设置减少动效时才启用视图过渡。

通过新增的 $use_title_attr 参数，现在可以从两个函数中移除标题属性，并且三个作者链接函数的标题属性已默认移除。

---

等等，还有更多！

7.0 带来的远不止这些！已有超过 300 个核心缺陷、486 个 Gutenberg¹（古腾堡）项目是 WordPress 的新编辑器界面。该编辑器改进了创建新内容的过程和体验，使编写富文本内容更加简单。它使用”块”来增加丰富性，而非短代码、自定义 HTML 等。https://wordpress.org/gutenberg/ 缺陷、77 项增强和功能请求，以及 35 项已批准的任务已被标记为在 WordPress 7.0 中修复。

以下是一些亮点：

• 站点健康：OPCache³ 已添加到 站点健康 > 信息 > 服务器（Trac #63697）
• 编辑器：保存区块样板时，会添加名称/描述元数据（Trac #64123）
• 脚本加载器：允许脚本依赖模块（Trac #61500）
• 脚本加载器：HTML5⁵ 脚本主题支持已弃用并移除（Trac #64442）
• 常规：当 WP_DEBUG 不为真时，允许挂钩到 wp_trigger_error()（Trac #60886）
• 多站点：网络和站点不再在账户被标记为垃圾时自动将网站标记为垃圾（Trac #61146）
• 主题：PHP 8.1 弃用通知处理（Trac #64864）
• 编辑器：所有组件底部边距已移除，无外边距样式现为默认（GB15 #39358）

感谢所有为这个 WordPress 版本做出贡献的人，无论是通过代码、测试还是其他方式——你们的贡献至关重要，并帮助成就了 WordPress。

致谢 @westonruter、@sabernhardt、@marybaum、@jeffpaul、@jorbin、@desrosj、@coffee2code、@audrasjb、@wildworks 和 @ankit-k-gupta 的合作与审阅。

编辑于 5/17/26：添加 DataViews 开发者说明。WordPress Core 中的每个重要变更都会记录在开发者说明（通常称为 dev note）中。好的开发者说明通常包括变更描述、导致此变更的决策，以及开发者应如何处理该变更的描述。开发者说明在 WordPress 发布周期的 beta 阶段发布在 Make/Core 博客上。当插件/主题作者和 WordPress 开发者需要了解这些变更时，发布开发者说明尤为重要。通常，所有开发者说明会在发布候选阶段开始时汇编成一份开发者指南。更新连接器屏幕图像，添加 textIndent 区块支持开发者说明，移除播放列表区块的提及，添加无外边距样式默认的提及。

编辑于 5/18/26：移除注释部分，插入新的画廊区块幻灯片图像。

#7-0、#field-guide

---

名词解释

1. Gutenberg：WordPress 的区块编辑器项目名称 ↩︎
2. REST API：基于 HTTP 的应用程序接口 ↩︎
3. OPCache：PHP 字节码缓存组件，可提升 PHP 执行性能 ↩︎
4. React：Meta 开源的 JavaScript 界面库 ↩︎
5. HTML5：网页内容展示标准 ↩︎
6. WCAG：Web 内容无障碍指南 ↩︎
7. Trac：WordPress 使用的项目管理和缺陷追踪系统 ↩︎
8. IPTC：国际新闻电信理事会元数据 ↩︎
9. CSS：层叠样式表，控制网页外观和排版 ↩︎
10. DOM：文档对象模型，网页结构的编程接口 ↩︎
11. PHP：WordPress 核心使用的服务端编程语言 ↩︎
12. URL：统一资源定位符，即网址 ↩︎
13. ES6：JavaScript第6版标准 ↩︎
14. UI：用户界面，用户与软件交互的视觉部分 ↩︎
15. GB：千兆字节存储单位 ↩︎