X-Git-Url: https://scripts.mit.edu/gitweb/autoinstalls/wordpress.git/blobdiff_plain/42aebe6945a3a60c8f73853bea2c8b202d64a20b..refs/tags/wordpress-4.3:/wp-admin/includes/update.php diff --git a/wp-admin/includes/update.php b/wp-admin/includes/update.php index 5ee195a7..9bbb0c0f 100644 --- a/wp-admin/includes/update.php +++ b/wp-admin/includes/update.php @@ -7,9 +7,9 @@ */ /** - * 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(); @@ -21,11 +21,11 @@ function get_preferred_from_update_core() { } /** - * 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-dismissed 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 ); @@ -67,14 +67,14 @@ function get_core_updates( $options = array() ) { * * @since 3.7.0 * - * @return bool|array False on failure, otherwise the core update offering. + * @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'; + include_once( ABSPATH . 'wp-admin/includes/class-wp-upgrader.php' ); $auto_update = false; $upgrader = new WP_Automatic_Updater; @@ -101,8 +101,6 @@ function find_core_auto_update() { * @return bool|array False on failure. An array of checksums on success. */ function get_core_checksums( $version, $locale ) { - $return = array(); - $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' ) ) ) @@ -114,7 +112,7 @@ function get_core_checksums( $version, $locale ) { $response = wp_remote_get( $url, $options ); if ( $ssl && is_wp_error( $response ) ) { - trigger_error( __( '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.' ) . ' ' . '(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 ); + trigger_error( __( '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.' ) . ' ' . __( '(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 ); } @@ -130,12 +128,23 @@ function get_core_checksums( $version, $locale ) { 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; 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; @@ -147,6 +156,12 @@ function undismiss_core_update( $version, $locale ) { 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' ); @@ -161,6 +176,11 @@ function find_core_update( $version, $locale ) { return false; } +/** + * + * @param string $msg + * @return string + */ function core_update_footer( $msg = '' ) { if ( !current_user_can('update_core') ) return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) ); @@ -181,20 +201,21 @@ function core_update_footer( $msg = '' ) { switch ( $cur->response ) { case 'development' : return sprintf( __( 'You are using a development version (%1$s). Cool! Please stay updated.' ), get_bloginfo( 'version', 'display' ), network_admin_url( 'update-core.php' ) ); - break; case 'upgrade' : return sprintf( ''.__( 'Get Version %2$s' ).'', network_admin_url( 'update-core.php' ), $cur->current); - break; case 'latest' : default : return sprintf( __( 'Version %s' ), get_bloginfo( 'version', 'display' ) ); - break; } } -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; @@ -210,29 +231,39 @@ function update_nag() { 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' ) ); + $msg = sprintf( __('WordPress %1$s is available! Please update now.'), $cur->current, network_admin_url( 'update-core.php' ) ); } else { - $msg = sprintf( __('WordPress %1$s is available! Please notify the site administrator.'), $cur->current ); + $msg = sprintf( __('WordPress %1$s is available! Please notify the site administrator.'), $cur->current ); } echo "
$msg
"; } -add_action( 'admin_notices', 'update_nag', 3 ); -add_action( 'network_admin_notices', 'update_nag', 3 ); // Called directly from dashboard function update_right_now_message() { - $msg = sprintf( __( 'You are using WordPress %s.' ), get_bloginfo( 'version', 'display' ) ); + $theme_name = wp_get_theme(); + if ( current_user_can( 'switch_themes' ) ) { + $theme_name = sprintf( '%1$s', $theme_name ); + } + + $msg = ''; if ( current_user_can('update_core') ) { $cur = get_preferred_from_update_core(); if ( isset( $cur->response ) && $cur->response == 'upgrade' ) - $msg .= " " . sprintf( __('Update to %s'), $cur->current ? $cur->current : __( 'Latest' ) ) . ''; + $msg .= '' . sprintf( __( 'Update to %s' ), $cur->current ? $cur->current : __( 'Latest' ) ) . ' '; } - echo "$msg"; + $msg .= sprintf( '' . __( 'WordPress %1$s running %2$s theme.' ) . '', 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(); @@ -247,6 +278,9 @@ function get_plugin_updates() { return $upgrade_plugins; } +/** + * @since 2.9.0 + */ function wp_plugin_update_rows() { if ( !current_user_can('update_plugins' ) ) return; @@ -259,8 +293,13 @@ function wp_plugin_update_rows() { } } } -add_action( 'admin_init', 'wp_plugin_update_rows' ); +/** + * + * @param string $file + * @param array $plugin_data + * @return false|void + */ function wp_plugin_update_row( $file, $plugin_data ) { $current = get_site_transient( 'update_plugins' ); if ( !isset( $current->response[ $file ] ) ) @@ -276,23 +315,67 @@ function wp_plugin_update_row( $file, $plugin_data ) { $wp_list_table = _get_list_table('WP_Plugins_List_Table'); if ( is_network_admin() || !is_multisite() ) { - echo '
'; + if ( is_network_admin() ) { + $active_class = is_plugin_active_for_network( $file ) ? ' active': ''; + } else { + $active_class = is_plugin_active( $file ) ? ' active' : ''; + } - if ( ! current_user_can('update_plugins') ) + 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) ) + } elseif ( 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 now.'), $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) ); - - do_action( "in_plugin_update_message-$file", $plugin_data, $r ); + } else { + printf( __( 'There is a new version of %1$s available. View version %4$s details or update now.' ), $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 ) ); + } + /** + * 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 $r { + * 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, $r ); echo '
'; } } +/** + * + * @return array + */ function get_theme_updates() { - $themes = wp_get_themes(); $current = get_site_transient('update_themes'); if ( ! isset( $current->response ) ) @@ -307,6 +390,9 @@ function get_theme_updates() { return $update_themes; } +/** + * @since 3.1.0 + */ function wp_theme_update_rows() { if ( !current_user_can('update_themes' ) ) return; @@ -320,35 +406,61 @@ function wp_theme_update_rows() { } } } -add_action( 'admin_init', 'wp_theme_update_rows' ); +/** + * + * @param string $theme_key + * @param WP_Theme $theme + * @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 = add_query_arg( array( 'TB_iframe' => 'true', 'width' => 1024, 'height' => 800 ), $current->response[ $theme_key ]['url'] ); $wp_list_table = _get_list_table('WP_MS_Themes_List_Table'); echo '
'; - if ( ! current_user_can('update_themes') ) + 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'] ) ) + } elseif ( empty( $r['package'] ) ) { 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), esc_attr($theme['Name']), $r['new_version'] ); - else + } else { printf( __('There is a new version of %1$s available. View version %4$s details or update now.'), $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 ); + } + /** + * 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 $r { + * 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, $r ); echo '
'; } +/** + * + * @global int $upgrading + * @return false|void + */ function maintenance_nag() { - include ABSPATH . WPINC . '/version.php'; // include an unmodified $wp_version + include( ABSPATH . WPINC . '/version.php' ); // include an unmodified $wp_version global $upgrading; $nag = isset( $upgrading ); if ( ! $nag ) { @@ -378,5 +490,3 @@ function maintenance_nag() { echo "
$msg
"; } -add_action( 'admin_notices', 'maintenance_nag' ); -add_action( 'network_admin_notices', 'maintenance_nag' );