do_action( “after_plugin_row_{$plugin_file}”, string $plugin_file, array $plugin_data, string $status )

Fires after each specific row in the Plugins list table.

Description

The dynamic portion of the hook name, $plugin_file, refers to the path to the plugin file, relative to the plugins directory.

Parameters

$plugin_filestring
Path to the plugin file relative to the plugins directory.
$plugin_dataarray
An array of plugin data. See get_plugin_data() and the 'plugin_row_meta' filter for the list of possible values.
$statusstring
Status filter currently applied to the plugin list.
Possible values are: 'all', 'active', 'inactive', 'recently_activated', 'upgrade', 'mustuse', 'dropins', 'search', 'paused', 'auto-update-enabled', 'auto-update-disabled'.

Source

do_action( "after_plugin_row_{$plugin_file}", $plugin_file, $plugin_data, $status );

Changelog

VersionDescription
5.5.0Added 'auto-update-enabled' and 'auto-update-disabled' to possible values for $status.
2.7.0Introduced.

User Contributed Notes

  1. Skip to note 2 content

    This an action on which the update link information is hooked. When a plugin is found to have an updated version, an additional row is added after the plugin entry (on the plugins.php admin page), enabling a user to view the update details as well as upgrade.

    Most users simply upgrade and hope for the best without necessarily looking at the details and this hook is a means to add a warning message on the upgrade link for example, asking a user to view the details in case a major code change may affect their setup.

    The parameters passed in the filter are,
    $plugin_file – this is a little redundant as the hook already has the file name in it
    $plugin_data – an array of plugin attributes which is useful to set some conditions, see below.
    $status – if the plugins page is being filtered (for example to show only the activated ones), by default it is set to all.

    You could compare your currently installed plugin version to the $plugin_data['new_version'] to determine if you need to show some warning message or something else.

You must log in before being able to contribute a note or feedback.