W3cubDocs

/WordPress

update_nag()

Return

(void|false)

Source

File: wp-admin/includes/update.php 

function update_nag() {
	if ( is_multisite() && ! current_user_can( 'update_core' ) ) {
		return false;
	}

	global $pagenow;

	if ( 'update-core.php' === $pagenow ) {
		return;
	}

	$cur = get_preferred_from_update_core();

	if ( ! isset( $cur->response ) || 'upgrade' !== $cur->response ) {
		return false;
	}

	$version_url = sprintf(
		/* translators: %s: WordPress version. */
		esc_url( __( 'https://wordpress.org/support/wordpress-version/version-%s/' ) ),
		sanitize_title( $cur->current )
	);

	if ( current_user_can( 'update_core' ) ) {
		$msg = sprintf(
			/* translators: 1: URL to WordPress release notes, 2: New WordPress version, 3: URL to network admin, 4: Accessibility text. */
			__( '<a href="%1$s">WordPress %2$s</a> is available! <a href="%3$s" aria-label="%4$s">Please update now</a>.' ),
			$version_url,
			$cur->current,
			network_admin_url( 'update-core.php' ),
			esc_attr__( 'Please update WordPress now' )
		);
	} else {
		$msg = sprintf(
			/* translators: 1: URL to WordPress release notes, 2: New WordPress version. */
			__( '<a href="%1$s">WordPress %2$s</a> is available! Please notify the site administrator.' ),
			$version_url,
			$cur->current
		);
	}

	echo "<div class='update-nag notice notice-warning inline'>$msg</div>";
}

Uses

Uses Description
wp-admin/includes/update.php: get_preferred_from_update_core()

Selects the first update version from the update_core option.
wp-includes/capabilities.php: current_user_can()

Returns whether the current user has the specified capability.
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/l10n.php: esc_attr__()

Retrieve the translation of $text and escapes it for safe use in an attribute.
wp-includes/formatting.php: esc_url()

Checks and cleans a URL.
wp-includes/formatting.php: sanitize_title()

Sanitizes a string into a slug, which can be used in URLs or HTML attributes.
wp-includes/load.php: is_multisite()

If Multisite is enabled.
wp-includes/link-template.php: network_admin_url()

Retrieves the URL to the admin area for the network.

Changelog

Version Description
2.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/update_nag