跳转到主要内容

将代码反向合并到 WordPress 核心

对于 WordPress 软件的主要版本,需要将 Gutenberg 的功能合并到 WordPress 核心中。这通常涉及获取 Gutenberg 仓库中 .php 文件的更改,并在 WP 核心代码库中进行相应的更新。

标准

文件/目录

对以下文件/目录内文件的更改通常需要反向合并到 WP 核心:

  • lib/
  • phpunit/

忽略的目录/文件

以下目录/文件不需要反向合并到 WP 核心:

  • lib/load.php - 插件特定代码。
  • lib/experiments-page.php - 实验功能是插件特定的。
  • packages/block-library - 这会在包同步过程中自动处理。
  • packages/e2e-tests/plugins - 仅与 e2e 测试相关的 PHP 文件。主要是测试数据生成器。
  • phpunit/blocks - 代码在 Gutenberg 中维护,因此测试也应如此。

请注意,此列表并非详尽无遗。

拉取请求标准

通常,自上一个稳定 WP 核心版本中包含的最终 Gutenberg 发布日期以来,提交到 Gutenberg 仓库的所有 PHP 代码都应考虑反向合并到 WP 核心。

然而,该规则存在某些例外情况。符合以下标准的 PR 不需要反向合并到 WP 核心:

  • 不包含对 PHP 代码的更改。
  • 带有 Backport from WordPress Core 标签 - 此代码已在 WP 核心中,并正在同步回 Gutenberg。
  • 带有 Backported to WordPress Core 标签 - 此代码已同步到 WP 核心。

延伸阅读

另请参阅关于 Gutenberg PHP 代码 的附加文档。