插件开发文档

发布确认邮件

💡 云策文档标注

概述

WordPress.org 为插件引入了一项新的可选功能——发布确认,旨在防止意外发布。启用后,插件提交者需要通过 Release Management 仪表板确认新版本发布,所有操作均通过邮件中的令牌链接进行验证。

关键要点

  • 发布确认功能为可选,启用后需在 SVN 中标记新版本,并在 Release Management 仪表板确认。
  • 访问权限仅限于插件提交者,操作需通过邮件发送的令牌链接确认。
  • 新版本标记后,所有提交者会自动收到包含发布详情和仪表板链接的邮件通知。
  • 插件页面顶部会显示横幅,引导提交者前往 Release Management 仪表板。
  • 确认后,发布流程正常进行,更新通常在几分钟内完成。

注意事项

  • 插件必须使用标签发布新版本,不能从主干(trunk)直接发布。
  • 必须更新主干(trunk)中 readme.txt 文件的 Stable Tag 头部。
  • 发布后,已标记版本不可修改,包括 readme 文件(如 tested up to 字段)。
  • 提交者必须能直接接收邮件,不能使用共享收件箱或支持工单系统。
  • 如需多提交者批准发布,需联系 Plugins 团队申请。

📄 原文内容

In order to better protect plugins from inadvertent releases, we’ve added a new opt-in feature for plugins: Release Confirmation.

When enabled on a plugin, to release a new version of a plugin you’ll need to tag a new release in SVN as normal, and then confirm on the Release Management dashboard.

Access to the Release Management dashboard is limited to plugin committers, and all actions require confirmation via a tokenised link which is emailed to you as needed.

When WordPress.org detects a new version has been tagged in SVN, all committers are automatically sent an email notifying them that a new release is pending, who made it, and a link to the dashboard to confirm the release.
Plugin committers will also see a banner on the top of your WordPress.org plugins page directing you to the Release Management dashboard.

Once confirmed, the release will proceed as usual and should update within a few minutes.

Requirements

  • Plugins are required to use tags for new versions, you cannot release your plugin from trunk.
  • You must still update the Stable Tag: header in your trunk/readme.txt file.
  • Once released, alterations cannot be made to the tagged version. This includes changing the readme (for tested up to).
  • Committers must be able to receive emails directly, and not have it go to a shared inbox or support ticket system.

Requiring double approval

Release Confirmations are opt-in, but only requires a singular committer to confirm the release.
If a group would like to require multiple committers to approve a release, please contact the Plugins team with your request.