wp_theme_update_row( string $theme_key, WP_Theme $theme ): void|false

Parameters

$theme_keystring

Theme stylesheet.

$themeWP_Theme

Theme object.

Return

void|false

Void on success, false if the theme update is not available.

Hooks fired · 1

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

1. 1
   do_action( in_theme_update_message-{$theme_key} )actionline 837 (+163 into the body)

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

Uses · 15

• get_site_transient()Retrieves the value of a site transient.
• add_query_arg()Retrieves a modified URL query string.
• _get_list_table()Fetches an instance of a WP_List_Table class.
• is_wp_version_compatible()Checks compatibility with the current WordPress version.
• is_php_version_compatible()Checks compatibility with the current PHP version.
• esc_attr()Escaping for HTML attributes.
• current_user_can()Returns whether the current user has the specified capability.
• __()Retrieves the translation of $text.
• esc_url()Checks and cleans a URL.
• wp_nonce_url()Retrieves URL with nonce added to URL query.
• self_admin_url()Retrieves the URL to the admin area for either the current site or the network depending on context.
• _x()Retrieves translated string with gettext context.

Source

View on Trac ↗View on GitHub ↗

674function wp_theme_update_row( $theme_key, $theme ) {675	$current = get_site_transient( 'update_themes' );676 677	if ( ! isset( $current->response[ $theme_key ] ) ) {678		return false;679	}680 681	$response = $current->response[ $theme_key ];682 683	$details_url = add_query_arg(684		array(685			'TB_iframe' => 'true',686			'width'     => 1024,687			'height'    => 800,688		),689		$current->response[ $theme_key ]['url']690	);691 692	/** @var WP_MS_Themes_List_Table $wp_list_table */693	$wp_list_table = _get_list_table( 'WP_MS_Themes_List_Table' );694 695	$active = $theme->is_allowed( 'network' ) ? ' active' : '';696 697	$requires_wp  = $response['requires'] ?? null;698	$requires_php = $response['requires_php'] ?? null;699 700	$compatible_wp  = is_wp_version_compatible( $requires_wp );701	$compatible_php = is_php_version_compatible( $requires_php );702 703	printf(704		'<tr class="plugin-update-tr%s" id="%s" data-slug="%s">' .705		'<td colspan="%s" class="plugin-update colspanchange">' .706		'<div class="update-message notice inline notice-warning notice-alt"><p>',707		$active,708		esc_attr( $theme->get_stylesheet() . '-update' ),709		esc_attr( $theme->get_stylesheet() ),710		$wp_list_table->get_column_count()711	);712 713	if ( $compatible_wp && $compatible_php ) {714		if ( ! current_user_can( 'update_themes' ) ) {715			printf(716				/* translators: 1: Theme name, 2: Details URL, 3: Additional link attributes, 4: Version number. */717				__( 'There is a new version of %1$s available. <a href="%2$s" %3$s>View version %4$s details</a>.' ),718				$theme['Name'],719				esc_url( $details_url ),720				sprintf(721					'class="thickbox open-plugin-details-modal" aria-label="%s"',722					/* translators: 1: Theme name, 2: Version number. */723					esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme['Name'], $response['new_version'] ) )724				),725				$response['new_version']726			);727		} elseif ( empty( $response['package'] ) ) {728			printf(729				/* translators: 1: Theme name, 2: Details URL, 3: Additional link attributes, 4: Version number. */730				__( '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 theme.</em>' ),731				$theme['Name'],732				esc_url( $details_url ),733				sprintf(734					'class="thickbox open-plugin-details-modal" aria-label="%s"',735					/* translators: 1: Theme name, 2: Version number. */736					esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme['Name'], $response['new_version'] ) )737				),738				$response['new_version']739			);740		} else {741			printf(742				/* translators: 1: Theme name, 2: Details URL, 3: Additional link attributes, 4: Version number, 5: Update URL, 6: Additional link attributes. */743				__( '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>.' ),744				$theme['Name'],745				esc_url( $details_url ),746				sprintf(747					'class="thickbox open-plugin-details-modal" aria-label="%s"',748					/* translators: 1: Theme name, 2: Version number. */749					esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme['Name'], $response['new_version'] ) )750				),751				$response['new_version'],752				wp_nonce_url( self_admin_url( 'update.php?action=upgrade-theme&theme=' ) . $theme_key, 'upgrade-theme_' . $theme_key ),753				sprintf(

History

Introduced in 3.1.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 7.1.0 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.