WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

after_plugin_row_{$plugin_file}

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

In this article

Back to top

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 );

View all references View on Trac View on GitHub

Used byDescription
WP_Plugins_List_Table::single_row()wp-admin/includes/class-wp-plugins-list-table.php

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
    Aurovrata Venet
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    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.