WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

core_update_footer()

core_update_footer( string $msg = ” ): string

In this article

Back to top

Returns core update footer message.

Parameters

$msgstringoptional

Default:''

Return

string

Source

function core_update_footer( $msg = '' ) {
	if ( ! current_user_can( 'update_core' ) ) {
		/* translators: %s: WordPress version. */
		return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );
	}

	$cur = get_preferred_from_update_core();

	if ( ! is_object( $cur ) ) {
		$cur = new stdClass();
	}

	if ( ! isset( $cur->current ) ) {
		$cur->current = '';
	}

	if ( ! isset( $cur->response ) ) {
		$cur->response = '';
	}

	// Include an unmodified $wp_version.
	require ABSPATH . WPINC . '/version.php';

	$is_development_version = preg_match( '/alpha|beta|RC/', $wp_version );

	if ( $is_development_version ) {
		return sprintf(
			/* translators: 1: WordPress version number, 2: URL to WordPress Updates screen. */
			__( 'You are using a development version (%1$s). Cool! Please <a href="%2$s">stay updated</a>.' ),
			get_bloginfo( 'version', 'display' ),
			network_admin_url( 'update-core.php' )
		);
	}

	switch ( $cur->response ) {
		case 'upgrade':
			return sprintf(
				'<strong><a href="%s">%s</a></strong>',
				network_admin_url( 'update-core.php' ),
				/* translators: %s: WordPress version. */
				sprintf( __( 'Get Version %s' ), $cur->current )
			);

		case 'latest':
		default:
			/* translators: %s: WordPress version. */
			return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );
	}
}

View all references View on Trac View on GitHub

UsesDescription
get_preferred_from_update_core()wp-admin/includes/update.php

Selects the first update version from the update_core option.

network_admin_url()wp-includes/link-template.php

Retrieves the URL to the admin area for the network.

current_user_can()wp-includes/capabilities.php

Returns whether the current user has the specified capability.

__()wp-includes/l10n.php

Retrieves the translation of $text.

get_bloginfo()wp-includes/general-template.php

Retrieves information about the current site.

Show 3 moreShow less

Changelog

VersionDescription
2.3.0Introduced.

User Contributed Notes

  1. Skip to note 2 content
    pixeline
    You must log in to vote on the helpfulness of this noteVote results for this note: 2You must log in to vote on the helpfulness of this note

    I find it annoying when the admin footer tells you that a new WordPress version is available (for example “Get Version 4.6.1”) but does not tell you what your current version is.
    Here is a patch:

    // Improve Admin footer update notice.
if (!function_exists('smarter_update_footer')){
	function smarter_update_footer( $msg = '' ) {
		if ( !current_user_can('update_core') )
			return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );

		$cur = get_preferred_from_update_core();
		if ( ! is_object( $cur ) )
			$cur = new stdClass;

		if ( ! isset( $cur->current ) )
			$cur->current = '';

		if ( ! isset( $cur->url ) )
			$cur->url = '';

		if ( ! isset( $cur->response ) )
			$cur->response = '';

		switch ( $cur->response ) {
		case 'development' :
			return sprintf( __( 'You are using a development version (%1$s). Cool! Please <a href="%2$s">stay updated</a>.' ), get_bloginfo( 'version', 'display' ), network_admin_url( 'update-core.php' ) );

		case 'upgrade' :
			return '<strong>'.sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) ).' - <a href="' . network_admin_url( 'update-core.php' ) . '">' . sprintf( __( 'Get Version %s' ), $cur->current ) . '</a></strong>';

		case 'latest' :
		default :
			return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) );
		}
	}
	add_filter( 'update_footer', 'smarter_update_footer', 9999);
}

You must log in before being able to contribute a note or feedback.