X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/f9001779751f83dc8a10e478bfecb4d8dd5f964c..e3ff8f35458a959c1879c0a4976701ed8dcfe651:/wp-admin/includes/update.php diff --git a/wp-admin/includes/update.php b/wp-admin/includes/update.php index 06e06c24..e7a8b5e7 100644 --- a/wp-admin/includes/update.php +++ b/wp-admin/includes/update.php @@ -6,89 +6,196 @@ * @subpackage Administration */ -// The admin side of our 1.1 update system - /** - * Selects the first update version from the update_core option + * Selects the first update version from the update_core option. * - * @return object the response from the API + * @return object|array|false The response from the API on success, false on failure. */ function get_preferred_from_update_core() { $updates = get_core_updates(); - if ( !is_array( $updates ) ) + if ( ! is_array( $updates ) ) return false; if ( empty( $updates ) ) - return (object)array('response' => 'latest'); + return (object) array( 'response' => 'latest' ); return $updates[0]; } /** - * Get available core updates + * Get available core updates. * * @param array $options Set $options['dismissed'] to true to show dismissed upgrades too, - * set $options['available'] to false to skip not-dimissed updates. - * @return array Array of the update objects + * set $options['available'] to false to skip not-dismissed updates. + * @return array|false Array of the update objects on success, false on failure. */ function get_core_updates( $options = array() ) { - $options = array_merge( array('available' => true, 'dismissed' => false ), $options ); + $options = array_merge( array( 'available' => true, 'dismissed' => false ), $options ); $dismissed = get_site_option( 'dismissed_update_core' ); - if ( !is_array( $dismissed ) ) $dismissed = array(); + + if ( ! is_array( $dismissed ) ) + $dismissed = array(); + $from_api = get_site_transient( 'update_core' ); - if ( empty($from_api) ) + + if ( ! isset( $from_api->updates ) || ! is_array( $from_api->updates ) ) return false; - if ( !isset( $from_api->updates ) || !is_array( $from_api->updates ) ) return false; + $updates = $from_api->updates; - if ( !is_array( $updates ) ) return false; $result = array(); - foreach($updates as $update) { - if ( array_key_exists( $update->current.'|'.$update->locale, $dismissed ) ) { + foreach ( $updates as $update ) { + if ( $update->response == 'autoupdate' ) + continue; + + if ( array_key_exists( $update->current . '|' . $update->locale, $dismissed ) ) { if ( $options['dismissed'] ) { $update->dismissed = true; - $result[]= $update; + $result[] = $update; } } else { if ( $options['available'] ) { $update->dismissed = false; - $result[]= $update; + $result[] = $update; } } } return $result; } +/** + * Gets the best available (and enabled) Auto-Update for WordPress Core. + * + * If there's 1.2.3 and 1.3 on offer, it'll choose 1.3 if the install allows it, else, 1.2.3 + * + * @since 3.7.0 + * + * @return array|false False on failure, otherwise the core update offering. + */ +function find_core_auto_update() { + $updates = get_site_transient( 'update_core' ); + if ( ! $updates || empty( $updates->updates ) ) + return false; + + include_once( ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' ); + + $auto_update = false; + $upgrader = new WP_Automatic_Updater; + foreach ( $updates->updates as $update ) { + if ( 'autoupdate' != $update->response ) + continue; + + if ( ! $upgrader->should_update( 'core', $update, ABSPATH ) ) + continue; + + if ( ! $auto_update || version_compare( $update->current, $auto_update->current, '>' ) ) + $auto_update = $update; + } + return $auto_update; +} + +/** + * Gets and caches the checksums for the given version of WordPress. + * + * @since 3.7.0 + * + * @param string $version Version string to query. + * @param string $locale Locale to query. + * @return bool|array False on failure. An array of checksums on success. + */ +function get_core_checksums( $version, $locale ) { + $url = $http_url = 'http://api.wordpress.org/core/checksums/1.0/?' . http_build_query( compact( 'version', 'locale' ), null, '&' ); + + if ( $ssl = wp_http_supports( array( 'ssl' ) ) ) + $url = set_url_scheme( $url, 'https' ); + + $options = array( + 'timeout' => ( ( defined('DOING_CRON') && DOING_CRON ) ? 30 : 3 ), + ); + + $response = wp_remote_get( $url, $options ); + if ( $ssl && is_wp_error( $response ) ) { + trigger_error( + sprintf( + /* translators: %s: support forums URL */ + __( 'An unexpected error occurred. Something may be wrong with WordPress.org or this server’s configuration. If you continue to have problems, please try the support forums.' ), + __( 'https://wordpress.org/support/' ) + ) . ' ' . __( '(WordPress could not establish a secure connection to WordPress.org. Please contact your server administrator.)' ), + headers_sent() || WP_DEBUG ? E_USER_WARNING : E_USER_NOTICE + ); + $response = wp_remote_get( $http_url, $options ); + } + + if ( is_wp_error( $response ) || 200 != wp_remote_retrieve_response_code( $response ) ) + return false; + + $body = trim( wp_remote_retrieve_body( $response ) ); + $body = json_decode( $body, true ); + + if ( ! is_array( $body ) || ! isset( $body['checksums'] ) || ! is_array( $body['checksums'] ) ) + return false; + + return $body['checksums']; +} + +/** + * + * @param object $update + * @return bool + */ function dismiss_core_update( $update ) { $dismissed = get_site_option( 'dismissed_update_core' ); - $dismissed[ $update->current.'|'.$update->locale ] = true; + $dismissed[ $update->current . '|' . $update->locale ] = true; return update_site_option( 'dismissed_update_core', $dismissed ); } +/** + * + * @param string $version + * @param string $locale + * @return bool + */ function undismiss_core_update( $version, $locale ) { $dismissed = get_site_option( 'dismissed_update_core' ); - $key = $version.'|'.$locale; - if ( !isset( $dismissed[$key] ) ) return false; + $key = $version . '|' . $locale; + + if ( ! isset( $dismissed[$key] ) ) + return false; + unset( $dismissed[$key] ); return update_site_option( 'dismissed_update_core', $dismissed ); } +/** + * + * @param string $version + * @param string $locale + * @return object|false + */ function find_core_update( $version, $locale ) { $from_api = get_site_transient( 'update_core' ); - if ( !is_array( $from_api->updates ) ) return false; + + if ( ! isset( $from_api->updates ) || ! is_array( $from_api->updates ) ) + return false; + $updates = $from_api->updates; - foreach($updates as $update) { + foreach ( $updates as $update ) { if ( $update->current == $version && $update->locale == $locale ) return $update; } return false; } +/** + * + * @param string $msg + * @return string + */ function core_update_footer( $msg = '' ) { - if ( is_multisite() && !current_user_can('update_core') ) - return false; - if ( !current_user_can('update_core') ) - return sprintf( __( 'Version %s' ), $GLOBALS['wp_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 = ''; @@ -100,21 +207,23 @@ function core_update_footer( $msg = '' ) { switch ( $cur->response ) { case 'development' : - return sprintf( __( 'You are using a development version (%1$s). Cool! Please stay updated.' ), $GLOBALS['wp_version'], network_admin_url( 'update-core.php' ) ); - break; + /* translators: 1: WordPress version number, 2: WordPress updates admin screen URL */ + return sprintf( __( 'You are using a development version (%1$s). Cool! Please stay updated.' ), get_bloginfo( 'version', 'display' ), network_admin_url( 'update-core.php' ) ); case 'upgrade' : - return sprintf( ''.__( 'Get Version %2$s' ).'', network_admin_url( 'update-core.php' ), $cur->current); - break; + return '' . sprintf( __( 'Get Version %s' ), $cur->current ) . ''; case 'latest' : default : - return sprintf( __( 'Version %s' ), $GLOBALS['wp_version'] ); - break; + return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) ); } } -add_filter( 'update_footer', 'core_update_footer' ); +/** + * + * @global string $pagenow + * @return false|void + */ function update_nag() { if ( is_multisite() && !current_user_can('update_core') ) return false; @@ -129,31 +238,74 @@ function update_nag() { if ( ! isset( $cur->response ) || $cur->response != 'upgrade' ) return false; - if ( current_user_can('update_core') ) { - $msg = sprintf( __('WordPress %1$s is available! Please update now.'), $cur->current, network_admin_url( 'update-core.php' ) ); + if ( current_user_can( 'update_core' ) ) { + $msg = sprintf( + /* translators: 1: Codex URL to release notes, 2: new WordPress version, 3: URL to network admin, 4: accessibility text */ + __( 'WordPress %2$s is available! Please update now.' ), + sprintf( + /* translators: %s: WordPress version */ + esc_url( __( 'https://codex.wordpress.org/Version_%s' ) ), + $cur->current + ), + $cur->current, + network_admin_url( 'update-core.php' ), + esc_attr__( 'Please update WordPress now' ) + ); } else { - $msg = sprintf( __('WordPress %1$s is available! Please notify the site administrator.'), $cur->current ); + $msg = sprintf( + /* translators: 1: Codex URL to release notes, 2: new WordPress version */ + __( 'WordPress %2$s is available! Please notify the site administrator.' ), + sprintf( + /* translators: %s: WordPress version */ + esc_url( __( 'https://codex.wordpress.org/Version_%s' ) ), + $cur->current + ), + $cur->current + ); } echo "
$msg
"; } -add_action( 'admin_notices', 'update_nag', 3 ); // Called directly from dashboard function update_right_now_message() { - if ( is_multisite() && !current_user_can('update_core') ) - return false; + $theme_name = wp_get_theme(); + if ( current_user_can( 'switch_themes' ) ) { + $theme_name = sprintf( '%1$s', $theme_name ); + } - $cur = get_preferred_from_update_core(); + $msg = ''; - $msg = sprintf( __('You are using WordPress %s.'), $GLOBALS['wp_version'] ); + if ( current_user_can('update_core') ) { + $cur = get_preferred_from_update_core(); - if ( isset( $cur->response ) && $cur->response == 'upgrade' && current_user_can('update_core') ) { - $msg .= " " . sprintf( __('Update to %s'), $cur->current ? $cur->current : __( 'Latest' ) ) . ''; + if ( isset( $cur->response ) && $cur->response == 'upgrade' ) + $msg .= '' . sprintf( __( 'Update to %s' ), $cur->current ? $cur->current : __( 'Latest' ) ) . ' '; } - echo "$msg"; + /* translators: 1: version number, 2: theme name */ + $content = __( 'WordPress %1$s running %2$s theme.' ); + + /** + * Filters the text displayed in the 'At a Glance' dashboard widget. + * + * Prior to 3.8.0, the widget was named 'Right Now'. + * + * @since 4.4.0 + * + * @param string $content Default text. + */ + $content = apply_filters( 'update_right_now_text', $content ); + + $msg .= sprintf( '' . $content . '', get_bloginfo( 'version', 'display' ), $theme_name ); + + echo "

$msg

"; } +/** + * @since 2.9.0 + * + * @return array + */ function get_plugin_updates() { $all_plugins = get_plugins(); $upgrade_plugins = array(); @@ -168,6 +320,9 @@ function get_plugin_updates() { return $upgrade_plugins; } +/** + * @since 2.9.0 + */ function wp_plugin_update_rows() { if ( !current_user_can('update_plugins' ) ) return; @@ -175,76 +330,154 @@ function wp_plugin_update_rows() { $plugins = get_site_transient( 'update_plugins' ); if ( isset($plugins->response) && is_array($plugins->response) ) { $plugins = array_keys( $plugins->response ); - foreach( $plugins as $plugin_file ) { + foreach ( $plugins as $plugin_file ) { add_action( "after_plugin_row_$plugin_file", 'wp_plugin_update_row', 10, 2 ); } } } -add_action( 'admin_init', 'wp_plugin_update_rows' ); +/** + * Displays update information for a plugin. + * + * @param string $file Plugin basename. + * @param array $plugin_data Plugin information. + * @return false|void + */ function wp_plugin_update_row( $file, $plugin_data ) { $current = get_site_transient( 'update_plugins' ); - if ( !isset( $current->response[ $file ] ) ) + if ( ! isset( $current->response[ $file ] ) ) { return false; + } - $r = $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 ); - - $details_url = self_admin_url('plugin-install.php?tab=plugin-information&plugin=' . $r->slug . '&TB_iframe=true&width=600&height=800'); + $response = $current->response[ $file ]; - $wp_list_table = _get_list_table('WP_Plugins_List_Table'); + $plugins_allowedtags = array( + 'a' => array( 'href' => array(), 'title' => array() ), + 'abbr' => array( 'title' => array() ), + 'acronym' => array( 'title' => array() ), + 'code' => array(), + 'em' => array(), + 'strong' => array(), + ); - if ( is_network_admin() || !is_multisite() ) { - echo '
'; - if ( ! current_user_can('update_plugins') ) - printf( __('There is a new version of %1$s available. View version %4$s details.'), $plugin_name, esc_url($details_url), esc_attr($plugin_name), $r->new_version ); - else if ( empty($r->package) ) - printf( __('There is a new version of %1$s available. View version %4$s details. Automatic update is unavailable for this plugin.'), $plugin_name, esc_url($details_url), esc_attr($plugin_name), $r->new_version ); - else - printf( __('There is a new version of %1$s available. View version %4$s details or update automatically.'), $plugin_name, esc_url($details_url), esc_attr($plugin_name), $r->new_version, wp_nonce_url( self_admin_url('update.php?action=upgrade-plugin&plugin=') . $file, 'upgrade-plugin_' . $file) ); - } + $plugin_name = wp_kses( $plugin_data['Name'], $plugins_allowedtags ); + $details_url = self_admin_url( 'plugin-install.php?tab=plugin-information&plugin=' . $response->slug . '§ion=changelog&TB_iframe=true&width=600&height=800' ); - do_action( "in_plugin_update_message-$file", $plugin_data, $r ); + /** @var WP_Plugins_List_Table $wp_list_table */ + $wp_list_table = _get_list_table( 'WP_Plugins_List_Table' ); - echo '
'; -} + 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' : ''; + } -function wp_update_plugin($plugin, $feedback = '') { - if ( !empty($feedback) ) - add_filter('update_feedback', $feedback); + echo '

'; + + if ( ! current_user_can( 'update_plugins' ) ) { + /* translators: 1: plugin name, 2: details URL, 3: additional link attributes, 4: version number */ + printf( __( 'There is a new version of %1$s available. View version %4$s details.' ), + $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 ) ) + ), + $response->new_version + ); + } elseif ( empty( $response->package ) ) { + /* translators: 1: plugin name, 2: details URL, 3: additional link attributes, 4: version number */ + printf( __( 'There is a new version of %1$s available. View version %4$s details. Automatic update is unavailable for this plugin.' ), + $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 ) ) + ), + $response->new_version + ); + } else { + /* translators: 1: plugin name, 2: details URL, 3: additional link attributes, 4: version number, 5: update URL, 6: additional link attributes */ + printf( __( 'There is a new version of %1$s available. View version %4$s details or update now.' ), + $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 ) ) + ), + $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( __( 'Update %s now' ), $plugin_name ) ) + ) + ); + } - include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php'; - $upgrader = new Plugin_Upgrader(); - return $upgrader->upgrade($plugin); + /** + * 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. + * + * @type string $name The human-readable name of the plugin. + * @type string $plugin_uri Plugin URI. + * @type string $version Plugin version. + * @type string $description Plugin description. + * @type string $author Plugin author. + * @type string $author_uri Plugin author URI. + * @type string $text_domain Plugin text domain. + * @type string $domain_path Relative path to the plugin's .mo file(s). + * @type bool $network Whether the plugin can only be activated network wide. + * @type string $title The human-readable title of the plugin. + * @type string $author_name Plugin author's name. + * @type bool $update Whether there's an available update. Default null. + * } + * @param array $response { + * An array of metadata about the available plugin update. + * + * @type int $id Plugin ID. + * @type string $slug Plugin slug. + * @type string $new_version New plugin version. + * @type string $url Plugin URL. + * @type string $package Plugin update package URL. + * } + */ + do_action( "in_plugin_update_message-{$file}", $plugin_data, $response ); + + echo '

'; + } } +/** + * + * @return array + */ function get_theme_updates() { - $themes = get_themes(); $current = get_site_transient('update_themes'); - $update_themes = array(); - foreach ( $themes as $theme ) { - $theme = (object) $theme; - if ( isset($current->response[ $theme->Stylesheet ]) ) { - $update_themes[$theme->Stylesheet] = $theme; - $update_themes[$theme->Stylesheet]->update = $current->response[ $theme->Stylesheet ]; - } + if ( ! isset( $current->response ) ) + return array(); + + $update_themes = array(); + foreach ( $current->response as $stylesheet => $data ) { + $update_themes[ $stylesheet ] = wp_get_theme( $stylesheet ); + $update_themes[ $stylesheet ]->update = $data; } return $update_themes; } -function wp_update_theme($theme, $feedback = '') { - if ( !empty($feedback) ) - add_filter('update_feedback', $feedback); - - include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php'; - $upgrader = new Theme_Upgrader(); - return $upgrader->upgrade($theme); -} - +/** + * @since 3.1.0 + */ function wp_theme_update_rows() { if ( !current_user_can('update_themes' ) ) return; @@ -253,51 +486,130 @@ function wp_theme_update_rows() { if ( isset($themes->response) && is_array($themes->response) ) { $themes = array_keys( $themes->response ); - foreach( $themes as $theme ) { + foreach ( $themes as $theme ) { add_action( "after_theme_row_$theme", 'wp_theme_update_row', 10, 2 ); } } } -add_action( 'admin_init', 'wp_theme_update_rows' ); +/** + * Displays update information for a theme. + * + * @param string $theme_key Theme stylesheet. + * @param WP_Theme $theme Theme object. + * @return false|void + */ function wp_theme_update_row( $theme_key, $theme ) { $current = get_site_transient( 'update_themes' ); - if ( !isset( $current->response[ $theme_key ] ) ) - return false; - $r = $current->response[ $theme_key ]; - $themes_allowedtags = array('a' => array('href' => array(),'title' => array()),'abbr' => array('title' => array()),'acronym' => array('title' => array()),'code' => array(),'em' => array(),'strong' => array()); - $theme_name = wp_kses( $theme['Name'], $themes_allowedtags ); - - $details_url = self_admin_url("theme-install.php?tab=theme-information&theme=$theme_key&TB_iframe=true&width=600&height=400"); - $wp_list_table = _get_list_table('WP_MS_Themes_List_Table'); - - echo '
'; - if ( ! current_user_can('update_themes') ) - printf( __('There is a new version of %1$s available. View version %4$s details.'), $theme['Name'], esc_url($details_url), esc_attr($theme['Name']), $r->new_version ); - else if ( empty( $r['package'] ) ) - printf( __('There is a new version of %1$s available. View version %4$s details. Automatic update is unavailable for this plugin.'), $theme['Name'], esc_url($details_url), esc_attr($theme['Name']), $r['new_version'] ); - else - printf( __('There is a new version of %1$s available. View version %4$s details or update automatically.'), $theme['Name'], esc_url($details_url), esc_attr($theme['Name']), $r['new_version'], wp_nonce_url( self_admin_url('update.php?action=upgrade-theme&theme=') . $theme_key, 'upgrade-theme_' . $theme_key) ); - - do_action( "in_theme_update_message-$theme_key", $theme, $r ); - - echo '
'; -} - -function wp_update_core($current, $feedback = '') { - if ( !empty($feedback) ) - add_filter('update_feedback', $feedback); + if ( ! isset( $current->response[ $theme_key ] ) ) { + return false; + } - include ABSPATH . 'wp-admin/includes/class-wp-upgrader.php'; - $upgrader = new Core_Upgrader(); - return $upgrader->upgrade($current); + $response = $current->response[ $theme_key ]; + + $details_url = add_query_arg( array( + 'TB_iframe' => 'true', + 'width' => 1024, + 'height' => 800, + ), $current->response[ $theme_key ]['url'] ); + + /** @var WP_MS_Themes_List_Table $wp_list_table */ + $wp_list_table = _get_list_table( 'WP_MS_Themes_List_Table' ); + + $active = $theme->is_allowed( 'network' ) ? ' active' : ''; + + echo '

'; + if ( ! current_user_can( 'update_themes' ) ) { + /* translators: 1: theme name, 2: details URL, 3: additional link attributes, 4: version number */ + printf( __( 'There is a new version of %1$s available. View version %4$s details.'), + $theme['Name'], + esc_url( $details_url ), + sprintf( 'class="thickbox open-plugin-details-modal" aria-label="%s"', + /* translators: 1: theme name, 2: version number */ + esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme['Name'], $response['new_version'] ) ) + ), + $response['new_version'] + ); + } elseif ( empty( $response['package'] ) ) { + /* translators: 1: theme name, 2: details URL, 3: additional link attributes, 4: version number */ + printf( __( 'There is a new version of %1$s available. View version %4$s details. Automatic update is unavailable for this theme.' ), + $theme['Name'], + esc_url( $details_url ), + sprintf( 'class="thickbox open-plugin-details-modal" aria-label="%s"', + /* translators: 1: theme name, 2: version number */ + esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme['Name'], $response['new_version'] ) ) + ), + $response['new_version'] + ); + } else { + /* translators: 1: theme name, 2: details URL, 3: additional link attributes, 4: version number, 5: update URL, 6: additional link attributes */ + printf( __( 'There is a new version of %1$s available. View version %4$s details or update now.' ), + $theme['Name'], + esc_url( $details_url ), + sprintf( 'class="thickbox open-plugin-details-modal" aria-label="%s"', + /* translators: 1: theme name, 2: version number */ + esc_attr( sprintf( __( 'View %1$s version %2$s details' ), $theme['Name'], $response['new_version'] ) ) + ), + $response['new_version'], + wp_nonce_url( self_admin_url( 'update.php?action=upgrade-theme&theme=' ) . $theme_key, 'upgrade-theme_' . $theme_key ), + sprintf( 'class="update-link" aria-label="%s"', + /* translators: %s: theme name */ + esc_attr( sprintf( __( 'Update %s now' ), $theme['Name'] ) ) + ) + ); + } + /** + * Fires at the end of the update message container in each + * row of the themes list table. + * + * The dynamic portion of the hook name, `$theme_key`, refers to + * the theme slug as found in the WordPress.org themes repository. + * + * @since 3.1.0 + * + * @param WP_Theme $theme The WP_Theme object. + * @param array $response { + * An array of metadata about the available theme update. + * + * @type string $new_version New theme version. + * @type string $url Theme URL. + * @type string $package Theme update package URL. + * } + */ + do_action( "in_theme_update_message-{$theme_key}", $theme, $response ); + + echo '

'; } +/** + * + * @global int $upgrading + * @return false|void + */ function maintenance_nag() { + include( ABSPATH . WPINC . '/version.php' ); // include an unmodified $wp_version global $upgrading; - if ( ! isset( $upgrading ) ) + $nag = isset( $upgrading ); + if ( ! $nag ) { + $failed = get_site_option( 'auto_core_update_failed' ); + /* + * If an update failed critically, we may have copied over version.php but not other files. + * In that case, if the install claims we're running the version we attempted, nag. + * This is serious enough to err on the side of nagging. + * + * If we simply failed to update before we tried to copy any files, then assume things are + * OK if they are now running the latest. + * + * This flag is cleared whenever a successful update occurs using Core_Upgrader. + */ + $comparison = ! empty( $failed['critical'] ) ? '>=' : '>'; + if ( version_compare( $failed['attempted'], $wp_version, $comparison ) ) + $nag = true; + } + + if ( ! $nag ) return false; if ( current_user_can('update_core') ) @@ -307,6 +619,146 @@ function maintenance_nag() { echo "
$msg
"; } -add_action( 'admin_notices', 'maintenance_nag' ); -?> +/** + * Prints the JavaScript templates for update admin notices. + * + * Template takes one argument with four values: + * + * param {object} data { + * Arguments for admin notice. + * + * @type string id ID of the notice. + * @type string className Class names for the notice. + * @type string message The notice's message. + * @type string type The type of update the notice is for. Either 'plugin' or 'theme'. + * } + * + * @since 4.6.0 + */ +function wp_print_admin_notice_templates() { + ?> + + + + + +