WordPress Version: 6.1
/**
* Displays update information for a plugin.
*
* @since 2.3.0
*
* @param string $file Plugin basename.
* @param array $plugin_data Plugin information.
* @return void|false
*/
function wp_plugin_update_row($file, $plugin_data)
{
$current = get_site_transient('update_plugins');
if (!isset($current->response[$file])) {
return false;
}
$response = $current->response[$file];
$plugins_allowedtags = array('a' => array('href' => array(), 'title' => array()), 'abbr' => array('title' => array()), 'acronym' => array('title' => array()), 'code' => array(), 'em' => array(), 'strong' => array());
$plugin_name = wp_kses($plugin_data['Name'], $plugins_allowedtags);
$plugin_slug = isset($response->slug) ? $response->slug : $response->id;
if (isset($response->slug)) {
$details_url = self_admin_url('plugin-install.php?tab=plugin-information&plugin=' . $plugin_slug . '§ion=changelog');
} elseif (isset($response->url)) {
$details_url = $response->url;
} else {
$details_url = $plugin_data['PluginURI'];
}
$details_url = add_query_arg(array('TB_iframe' => 'true', 'width' => 600, 'height' => 800), $details_url);
/** @var WP_Plugins_List_Table $wp_list_table */
$wp_list_table = _get_list_table('WP_Plugins_List_Table', array('screen' => get_current_screen()));
if (is_network_admin() || !is_multisite()) {
if (is_network_admin()) {
$active_class = is_plugin_active_for_network($file) ? ' active' : '';
} else {
$active_class = is_plugin_active($file) ? ' active' : '';
}
$requires_php = isset($response->requires_php) ? $response->requires_php : null;
$compatible_php = is_php_version_compatible($requires_php);
$notice_type = $compatible_php ? 'notice-warning' : 'notice-error';
printf('<tr class="plugin-update-tr%s" id="%s" data-slug="%s" data-plugin="%s">' . '<td colspan="%s" class="plugin-update colspanchange">' . '<div class="update-message notice inline %s notice-alt"><p>', $active_class, esc_attr($plugin_slug . '-update'), esc_attr($plugin_slug), esc_attr($file), esc_attr($wp_list_table->get_column_count()), $notice_type);
if (!current_user_can('update_plugins')) {
printf(
/* translators: 1: Plugin name, 2: Details URL, 3: Additional link attributes, 4: Version number. */
__('There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>.'),
$plugin_name,
esc_url($details_url),
sprintf(
'class="thickbox open-plugin-details-modal" aria-label="%s"',
/* translators: 1: Plugin name, 2: Version number. */
esc_attr(sprintf(__('View %1$s version %2$s details'), $plugin_name, $response->new_version))
),
esc_attr($response->new_version)
);
} elseif (empty($response->package)) {
printf(
/* translators: 1: Plugin name, 2: Details URL, 3: Additional link attributes, 4: Version number. */
__('There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>. <em>Automatic update is unavailable for this plugin.</em>'),
$plugin_name,
esc_url($details_url),
sprintf(
'class="thickbox open-plugin-details-modal" aria-label="%s"',
/* translators: 1: Plugin name, 2: Version number. */
esc_attr(sprintf(__('View %1$s version %2$s details'), $plugin_name, $response->new_version))
),
esc_attr($response->new_version)
);
} else if ($compatible_php) {
printf(
/* translators: 1: Plugin name, 2: Details URL, 3: Additional link attributes, 4: Version number, 5: Update URL, 6: Additional link attributes. */
__('There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a> or <a href="%5$s" %6$s>update now</a>.'),
$plugin_name,
esc_url($details_url),
sprintf(
'class="thickbox open-plugin-details-modal" aria-label="%s"',
/* translators: 1: Plugin name, 2: Version number. */
esc_attr(sprintf(__('View %1$s version %2$s details'), $plugin_name, $response->new_version))
),
esc_attr($response->new_version),
wp_nonce_url(self_admin_url('update.php?action=upgrade-plugin&plugin=') . $file, 'upgrade-plugin_' . $file),
sprintf(
'class="update-link" aria-label="%s"',
/* translators: %s: Plugin name. */
esc_attr(sprintf(_x('Update %s now', 'plugin'), $plugin_name))
)
);
} else {
printf(
/* translators: 1: Plugin name, 2: Details URL, 3: Additional link attributes, 4: Version number 5: URL to Update PHP page. */
__('There is a new version of %1$s available, but it does not work with your version of PHP. <a href="%2$s" %3$s>View version %4$s details</a> or <a href="%5$s">learn more about updating PHP</a>.'),
$plugin_name,
esc_url($details_url),
sprintf(
'class="thickbox open-plugin-details-modal" aria-label="%s"',
/* translators: 1: Plugin name, 2: Version number. */
esc_attr(sprintf(__('View %1$s version %2$s details'), $plugin_name, $response->new_version))
),
esc_attr($response->new_version),
esc_url(wp_get_update_php_url())
);
wp_update_php_annotation('<br><em>', '</em>');
}
/**
* Fires at the end of the update message container in each
* row of the plugins list table.
*
* The dynamic portion of the hook name, `$file`, refers to the path
* of the plugin's primary file relative to the plugins directory.
*
* @since 2.8.0
*
* @param array $plugin_data An array of plugin metadata. See get_plugin_data()
* and the {@see 'plugin_row_meta'} filter for the list
* of possible values.
* @param object $response {
* An object of metadata about the available plugin update.
*
* @type string $id Plugin ID, e.g. `w.org/plugins/[plugin-name]`.
* @type string $slug Plugin slug.
* @type string $plugin Plugin basename.
* @type string $new_version New plugin version.
* @type string $url Plugin URL.
* @type string $package Plugin update package URL.
* @type string[] $icons An array of plugin icon URLs.
* @type string[] $banners An array of plugin banner URLs.
* @type string[] $banners_rtl An array of plugin RTL banner URLs.
* @type string $requires The version of WordPress which the plugin requires.
* @type string $tested The version of WordPress the plugin is tested against.
* @type string $requires_php The version of PHP which the plugin requires.
* }
*/
do_action("in_plugin_update_message-{$file}", $plugin_data, $response);
// phpcs:ignore WordPress.NamingConventions.ValidHookName.UseUnderscores
echo '</p></div></td></tr>';
}
}