wp_plugin_update_row( string $file, array $plugin_data ): void|false

Parameters

$filestring

Plugin basename.

$plugin_dataarray

Plugin information.

Return

void|false

Hooks fired · 1

One hook fires while wp_plugin_update_row() runs, in this order:

1. 1
   do_action( in_plugin_update_message-{$file} )actionline 616 (+165 into the body)

   Fires at the end of the update message container in each row of the plugins list table.

Uses · 20

• get_site_transient()Retrieves the value of a site transient.
• wp_kses()Filters text content and strips out disallowed HTML.
• self_admin_url()Retrieves the URL to the admin area for either the current site or the network depending on context.
• add_query_arg()Retrieves a modified URL query string.
• _get_list_table()Fetches an instance of a WP_List_Table class.
• get_current_screen()Get the current screen object
• is_network_admin()Determines whether the current request is for the network administrative interface.
• is_multisite()Determines whether Multisite is enabled.
• is_plugin_active_for_network()Determines whether the plugin is active for the entire network.
• is_plugin_active()Determines whether a plugin is active.
• is_php_version_compatible()Checks compatibility with the current PHP version.
• esc_attr()Escaping for HTML attributes.

Source

View on Trac ↗View on GitHub ↗

451function wp_plugin_update_row( $file, $plugin_data ) {452	$current = get_site_transient( 'update_plugins' );453 454	if ( ! isset( $current->response[ $file ] ) ) {455		return false;456	}457 458	$response = $current->response[ $file ];459 460	$plugins_allowedtags = array(461		'a'       => array(462			'href'  => array(),463			'title' => array(),464		),465		'abbr'    => array( 'title' => array() ),466		'acronym' => array( 'title' => array() ),467		'code'    => array(),468		'em'      => array(),469		'strong'  => array(),470	);471 472	$plugin_name = wp_kses( $plugin_data['Name'], $plugins_allowedtags );473	$plugin_slug = isset( $response->slug ) ? $response->slug : $response->id;474 475	if ( isset( $response->slug ) ) {476		$details_url = self_admin_url( 'plugin-install.php?tab=plugin-information&plugin=' . $plugin_slug . '&section=changelog' );477	} elseif ( isset( $response->url ) ) {478		$details_url = $response->url;479	} else {480		$details_url = $plugin_data['PluginURI'];481	}482 483	$details_url = add_query_arg(484		array(485			'TB_iframe' => 'true',486			'width'     => 600,487			'height'    => 800,488		),489		$details_url490	);491 492	/** @var WP_Plugins_List_Table $wp_list_table */493	$wp_list_table = _get_list_table(494		'WP_Plugins_List_Table',495		array(496			'screen' => get_current_screen(),497		)498	);499 500	if ( is_network_admin() || ! is_multisite() ) {501		if ( is_network_admin() ) {502			$active_class = is_plugin_active_for_network( $file ) ? ' active' : '';503		} else {504			$active_class = is_plugin_active( $file ) ? ' active' : '';505		}506 507		$requires_php   = isset( $response->requires_php ) ? $response->requires_php : null;508		$compatible_php = is_php_version_compatible( $requires_php );509		$notice_type    = $compatible_php ? 'notice-warning' : 'notice-error';510 511		printf(512			'<tr class="plugin-update-tr%s" id="%s" data-slug="%s" data-plugin="%s">' .513			'<td colspan="%s" class="plugin-update colspanchange">' .514			'<div class="update-message notice inline %s notice-alt"><p>',515			$active_class,516			esc_attr( $plugin_slug . '-update' ),517			esc_attr( $plugin_slug ),518			esc_attr( $file ),519			esc_attr( $wp_list_table->get_column_count() ),520			$notice_type521		);522 523		if ( ! current_user_can( 'update_plugins' ) ) {524			printf(525				/* translators: 1: Plugin name, 2: Details URL, 3: Additional link attributes, 4: Version number. */526				__( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>.' ),527				$plugin_name,528				esc_url( $details_url ),529				sprintf(530					'class="thickbox open-plugin-details-modal" aria-label="%s"',

History

Introduced in 2.3.0. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.7.7 tag, from src/wp-admin/includes/update.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.