Plugins: Display required WordPress version for incompatible plugins

[kipmyk]

Description

When a plugin is incompatible with the user's current version of WordPress, the plugin card notice and details modal footer notice previously displayed a generic message ("This plugin does not work with your version of WordPress").

This PR updates WP_Plugin_Install_List_Table::display_rows() and install_plugin_information() to output the required minimum version string directly when $requires_wp is available (e.g., "This plugin requires WordPress 6.5 or higher").

Testing Instructions

1. Automated PHPUnit Test

Run the test suite for WP_Plugin_Install_List_Table:

vendor/bin/phpunit tests/phpunit/tests/admin/wpPluginInstallListTable.php

Verify that test_display_rows_incompatible_wp_displays_required_version passes.

2. Manual Verification

1. Open wp-admin/plugin-install.php in your browser.
2. Filter or mock a plugin API response where requires is set to a future version (e.g., 99.0).
3. Verify that the plugin card notice displays:

   "This plugin requires WordPress 99.0 or higher. Please update WordPress."

4. Click More Details on the card and verify the modal footer notice displays:

   "Error: This plugin requires WordPress 99.0 or higher."

Trac ticket: https://core.trac.wordpress.org/ticket/61211

Use of AI Tools

AI assistance: Yes
Tool(s): Visual Studio Code
Model(s): Claude Opus 5
Used for: Identifying the ticket, writing unit tests, and verifying WordPress Coding Standards (PHPCS) compliance.

---

This Pull Request is for code review only. Please keep all other discussion in the Trac ticket. Do not merge this Pull Request. See GitHub Pull Requests for Code Review in the Core Handbook for more details.

[github-actions]

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Unlinked Accounts

The following contributors have not linked their GitHub and WordPress.org accounts: @SergeyBiryukov602fd350-edb4-49c9-b593-d223f7449a82.

Contributors, please read how to link your accounts to ensure your work is properly credited in WordPress releases.

Core Committers: Use this line as a base for the props when committing in SVN:

Props westonruter, mikekipruto.

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

[Copilot]

Pull request overview

Updates the plugin installation UI to show a plugin’s minimum required WordPress version when the current site is running an incompatible WordPress version, improving the specificity of both the plugin card notice and the plugin details modal notice.

Changes:

• Update WP_Plugin_Install_List_Table::display_rows() to display “requires WordPress X or higher” when requires is present.
• Update install_plugin_information() to include the required minimum WordPress version in the modal footer error notice when available.
• Add a PHPUnit test covering the updated list-table incompatible-WordPress notice output.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
tests/phpunit/tests/admin/wpPluginInstallListTable.php	Adds a test asserting the plugin card notice includes the required WP version for incompatible plugins.
src/wp-admin/includes/plugin-install.php	Updates the plugin information modal notice to include the minimum required WP version when present.
src/wp-admin/includes/class-wp-plugin-install-list-table.php	Updates the plugin card notice to include the minimum required WP version when present.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

• All changes will be lost when closing a tab with a Playground instance.
• All changes will be lost when refreshing the page.
• A fresh instance is created each time the link below is clicked.
• Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
  it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

[Copilot]

Pull request overview

Copilot reviewed 3 out of 3 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

src/wp-admin/includes/plugin-install.php:847

• The PR updates install_plugin_information() to include the minimum required WordPress version in the incompatibility notice, but there doesn’t appear to be any PHPUnit coverage asserting this new output. The only added test covers WP_Plugin_Install_List_Table::display_rows(), and a repo-wide search doesn’t find any tests exercising install_plugin_information().

		if ( ! empty( $requires_wp ) ) {
			$compatible_wp_notice_message = sprintf(
				/* translators: %s: Minimum required WordPress version. */
				__( '<strong>Error:</strong> This plugin <strong>requires WordPress %s or higher</strong>.' ),
				esc_html( $requires_wp )
			);
		} else {
			$compatible_wp_notice_message = __( '<strong>Error:</strong> This plugin <strong>requires a newer version of WordPress</strong>.' );
		}