插件开发文档

警报与警告

💡 云策文档标注

概述

本文档介绍了 WordPress.org 插件页面上的警报和警告系统,旨在帮助用户了解插件的状态,包括已批准但未上传代码、已关闭和过时等情况。

关键要点

  • 警报和警告用于指示插件的状态,如已批准但未上传代码、已关闭或过时。
  • 已关闭的插件会显示通知,并可能包含关闭原因,如作者请求、违反指南、许可/商标问题、合并到核心或安全问题。
  • 过时插件指不支持最近 3 个主要 WordPress 版本的插件,开发者可通过更新 readme 中的 `Tested up to:` 值来避免此警报。

注意事项

  • 已批准但未上传代码的警报仅对插件所有者显示,上传代码后消失。
  • 插件关闭原因通常不对外公开,除非特殊情况,仅 WordPress.org 安全团队或插件作者可见。
  • 开发者会在每个主要 WordPress 版本发布前收到邮件,提醒更新 `Tested up to:` 值,无需推送新版本。

📄 原文内容

When you visit plugin pages on WordPress.org, you may notice special alerts or warnings. These exist to help visitors understand the status of various plugins.

Approved and Pending Data

Blue background - This plugin is approved and awaiting data upload but not visible to the public yet. Once you make your first commit, the plugin will become public.

Plugins that have been approved but no code has yet been uploaded will see this message:This only displays to the plugin owner and will go away once code has been pushed via SVN.

Closed

As of November 2017, plugins that are closed display a notice:

Red background: This plugin has been closed and is no longer available for download.

This is viewable by all visitors and indicates a plugin was closed. Plugins closed after January 2018 will include a date:

Red background: This plugin was closed on February 7, 2018 and is no longer available for download.

After 60 days, the alert will be updated to explain why the plugin was closed:

Alert detailing why a plugin was closed

Plugin committers will see the following additional note:

Blue background: If you did not request this change, please contact plugins@wordpress.org for a status. All developers with commit access are contacted when a plugin is closed, with the reasons why, so check your spam email too.

Reasons why plugins are closed

  • Author Request – the author has asked the plugin to be closed
  • Guideline Violation – a violation of any of the guideline
  • Licensing/Trademark Violation – non-GPL code in use, or trademarks are being misused
  • Merged Into Core – the plugin is now a part of core (reserved for feature projects)
  • Security Issue – a security concern has been found in this plugin

Additional details on why a plugin is closed are not provided to anyone outside the WordPress.org security team or the plugin authors, unless there is an extreme circumstance.

Out of Date

Plugins that do not support the last 3 major releases of WordPress have the following notice:

Yellow background: This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

Previously this message alerted users to plugins not updated within the last 2 years. In 2018 it was modified to rely on more pertinent data. Since WordPress updates major releases 2 to 3 times per year, and a maintained a plugin should be testing with the recent versions, this alert can be avoided by updating a plugin readme when new versions of WordPress is released.

Developers are emailed before every major release of WordPress and asked to update this value. They do not need to push a new version, just update the readme and edit the value of `Tested up to:` to the latest version of WordPress.