Skip to content

Tests: Add unit test coverage for the site screen action links in WP_Plugins_List_Table::single_row() - #14598

Open
huzaifaalmesbah wants to merge 2 commits into
WordPress:trunkfrom
huzaifaalmesbah:tests/plugins-list-table-action-links
Open

huzaifaalmesbah wants to merge 2 commits into
WordPress:trunkfrom
huzaifaalmesbah:tests/plugins-list-table-action-links

Conversation

@huzaifaalmesbah

Copy link
Copy Markdown
Member

Description

Adds tests for the action links that WP_Plugins_List_Table::single_row() builds for a plugin on a site's Plugins screen. The method is long and its existing tests only cover the auto-updates column; this PR covers the site screen's Activate, Deactivate, Resume and Delete links. The network admin screen and the rest of the row can follow separately.

The tests render a row for a temporary plugin, read the links from the plugin_action_links filter, and set the dependency state through the static properties of WP_Plugin_Dependencies, which the shared plugin dependencies test case resets. Each test uses its own plugin slug, because single_row() remembers the ID attributes it has used. They cover:

  • the Deactivate link of an active plugin, and plain text when an active plugin requires it;
  • the Resume link of a paused plugin;
  • the Activate and Delete links of an inactive plugin;
  • "Cannot Activate" when the plugin's PHP or WordPress requirement is not met, and plain text for unmet dependencies;
  • plain text instead of the Delete link when other plugins require the plugin, unless the dependency is circular;
  • no links for a user who cannot manage plugins;
  • only "Network Active" on a site in a network for a network-active plugin;
  • the filter receiving the plugin file, data and context.

Removing or changing each branch of the site screen links makes at least one test fail on single site or multisite.

This is a test-only change; no production code is modified.

Testing Instructions

  1. Run the tests on single site:
    npm run test:php -- --filter Tests_Admin_wpPluginsListTableActionLinks
  2. Run them on multisite:
    npm run test:php -- --filter Tests_Admin_wpPluginsListTableActionLinks -c tests/phpunit/multisite.xml
  3. Run them in random order:
    npm run test:php -- --filter Tests_Admin_wpPluginsListTableActionLinks --order-by=random
  4. Run the plugins group:
    npm run test:php -- --group plugins
  5. Run PHPCS on the test file:
    node ./tools/local-env/scripts/docker.js run --rm php ./vendor/bin/phpcs tests/phpunit/tests/admin/wpPluginsListTableActionLinks.php

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

Use of AI Tools

AI assistance: Yes
Tool(s): Claude Code
Model(s): Claude Opus 5.5
Used for: Brainstorming edge-case scenarios and drafting test boilerplate; test architecture, assertions, and local PHPUnit verification were written and validated by me.

@huzaifaalmesbah
huzaifaalmesbah marked this pull request as ready for review October 21, 2026 01:22
@github-actions

github-actions Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

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.

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

Props huzaifaalmesbah, mukesh27.

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

@mukeshpanchal27 mukeshpanchal27 left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The assertions match the source, and CI passes. One note about fixture cleanup inline.

private function get_actions( $plugin_data = array() ) {
// is_network_only_plugin() reads the plugin headers on multisite.
$dir = WP_PLUGIN_DIR . '/' . $this->slug;
$this->assertTrue( mkdir( $dir ), 'The test plugin directory should be created.' );

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In core tests, WP_PLUGIN_DIR is tests/phpunit/data/plugins, which is a tracked directory. If a run stops partway, such as on a fatal error or Ctrl+C, tear_down() never runs and this fixture folder stays there. The slug comes from a counter that starts at 1 again on the next run, so mkdir() fails on the same folder name. So every test in the class fails here until someone deletes the folder by hand. The leftover also shows up in git status.

Could this helper, or set_up(), remove a leftover folder first? #14600 already does this: its remove_plugin() helper runs in both set_up() and tear_down().

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good catch, thanks! Added a remove_plugin() helper that clears a leftover folder before mkdir() and in tear_down(), in 4605203. I checked it with a leftover folder in place: the old code failed and the new code passes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants