]> scripts.mit.edu Git - autoinstalls/wordpress.git/blobdiff - wp-admin/includes/upgrade.php
WordPress 4.4.1-scripts
[autoinstalls/wordpress.git] / wp-admin / includes / upgrade.php
index 4919fd4317c65e992c487466f80eedb1f4d43103..72d99b77b9a6c783f808e16e1ebf17666a0e6c32 100644 (file)
@@ -2,7 +2,7 @@
 /**
  * WordPress Upgrade API
  *
- * Most of the functions are pluggable and can be overwritten
+ * Most of the functions are pluggable and can be overwritten.
  *
  * @package WordPress
  * @subpackage Administration
@@ -20,21 +20,25 @@ require_once(ABSPATH . 'wp-admin/includes/schema.php');
 
 if ( !function_exists('wp_install') ) :
 /**
- * {@internal Missing Short Description}}
+ * Installs the site.
  *
- * {@internal Missing Long Description}}
+ * Runs the required functions to set up and populate the database,
+ * including primary admin user and initial options.
  *
- * @since unknown
+ * @since 2.1.0
  *
- * @param string $blog_title Blog title.
- * @param string $user_name User's username.
- * @param string $user_email User's email.
- * @param bool $public Whether blog is public.
- * @param null $deprecated Optional. Not used.
- * @return array Array keys 'url', 'user_id', 'password'.
+ * @param string $blog_title    Blog title.
+ * @param string $user_name     User's username.
+ * @param string $user_email    User's email.
+ * @param bool   $public        Whether blog is public.
+ * @param string $deprecated    Optional. Not used.
+ * @param string $user_password Optional. User's chosen password. Default empty (random password).
+ * @param string $language      Optional. Language chosen. Default empty.
+ * @return array Array keys 'url', 'user_id', 'password', and 'password_message'.
  */
-function wp_install($blog_title, $user_name, $user_email, $public, $deprecated='') {
-       global $wp_rewrite;
+function wp_install( $blog_title, $user_name, $user_email, $public, $deprecated = '', $user_password = '', $language = '' ) {
+       if ( !empty( $deprecated ) )
+               _deprecated_argument( __FUNCTION__, '2.6' );
 
        wp_check_mysql_version();
        wp_cache_flush();
@@ -46,6 +50,10 @@ function wp_install($blog_title, $user_name, $user_email, $public, $deprecated='
        update_option('admin_email', $user_email);
        update_option('blog_public', $public);
 
+       if ( $language ) {
+               update_option( 'WPLANG', $language );
+       }
+
        $guessurl = wp_guess_url();
 
        update_option('siteurl', $guessurl);
@@ -54,14 +62,25 @@ function wp_install($blog_title, $user_name, $user_email, $public, $deprecated='
        if ( ! $public )
                update_option('default_pingback_flag', 0);
 
-       // Create default user.  If the user already exists, the user tables are
-       // being shared among blogs.  Just set the role in that case.
+       /*
+        * Create default user. If the user already exists, the user tables are
+        * being shared among blogs. Just set the role in that case.
+        */
        $user_id = username_exists($user_name);
-       if ( !$user_id ) {
-               $random_password = wp_generate_password();
-               $user_id = wp_create_user($user_name, $random_password, $user_email);
+       $user_password = trim($user_password);
+       $email_password = false;
+       if ( !$user_id && empty($user_password) ) {
+               $user_password = wp_generate_password( 12, false );
+               $message = __('<strong><em>Note that password</em></strong> carefully! It is a <em>random</em> password that was generated just for you.');
+               $user_id = wp_create_user($user_name, $user_password, $user_email);
+               update_user_option($user_id, 'default_password_nag', true, true);
+               $email_password = true;
+       } elseif ( ! $user_id ) {
+               // Password has been provided
+               $message = '<em>'.__('Your chosen password.').'</em>';
+               $user_id = wp_create_user($user_name, $user_password, $user_email);
        } else {
-               $random_password = __('User already exists.  Password inherited.');
+               $message = __('User already exists. Password inherited.');
        }
 
        $user = new WP_User($user_id);
@@ -69,98 +88,288 @@ function wp_install($blog_title, $user_name, $user_email, $public, $deprecated='
 
        wp_install_defaults($user_id);
 
-       $wp_rewrite->flush_rules();
+       wp_install_maybe_enable_pretty_permalinks();
 
-       wp_new_blog_notification($blog_title, $guessurl, $user_id, $random_password);
+       flush_rewrite_rules();
+
+       wp_new_blog_notification($blog_title, $guessurl, $user_id, ($email_password ? $user_password : __('The password you chose during the install.') ) );
 
        wp_cache_flush();
 
-       return array('url' => $guessurl, 'user_id' => $user_id, 'password' => $random_password);
+       /**
+        * Fires after a site is fully installed.
+        *
+        * @since 3.9.0
+        *
+        * @param WP_User $user The site owner.
+        */
+       do_action( 'wp_install', $user );
+
+       return array('url' => $guessurl, 'user_id' => $user_id, 'password' => $user_password, 'password_message' => $message);
 }
 endif;
 
 if ( !function_exists('wp_install_defaults') ) :
 /**
- * {@internal Missing Short Description}}
+ * Creates the initial content for a newly-installed site.
  *
- * {@internal Missing Long Description}}
+ * Adds the default "Uncategorized" category, the first post (with comment),
+ * first page, and default widgets for default theme for the current version.
+ *
+ * @since 2.1.0
  *
- * @since unknown
+ * @global wpdb       $wpdb
+ * @global WP_Rewrite $wp_rewrite
+ * @global string     $table_prefix
  *
  * @param int $user_id User ID.
  */
-function wp_install_defaults($user_id) {
-       global $wpdb;
+function wp_install_defaults( $user_id ) {
+       global $wpdb, $wp_rewrite, $table_prefix;
 
        // Default category
-       $cat_name = $wpdb->escape(__('Uncategorized'));
-       $cat_slug = sanitize_title(_c('Uncategorized|Default category slug'));
-       $wpdb->query("INSERT INTO $wpdb->terms (name, slug, term_group) VALUES ('$cat_name', '$cat_slug', '0')");
-       $wpdb->query("INSERT INTO $wpdb->term_taxonomy (term_id, taxonomy, description, parent, count) VALUES ('1', 'category', '', '0', '1')");
-
-       // Default link category
-       $cat_name = $wpdb->escape(__('Blogroll'));
-       $cat_slug = sanitize_title(_c('Blogroll|Default link category slug'));
-       $wpdb->query("INSERT INTO $wpdb->terms (name, slug, term_group) VALUES ('$cat_name', '$cat_slug', '0')");
-       $wpdb->query("INSERT INTO $wpdb->term_taxonomy (term_id, taxonomy, description, parent, count) VALUES ('2', 'link_category', '', '0', '7')");
-
-       // Now drop in some default links
-       $wpdb->query("INSERT INTO $wpdb->links (link_url, link_name, link_category, link_rss, link_notes) VALUES ('http://codex.wordpress.org/', 'Documentation', 0, '', '');");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (1, 2)" );
+       $cat_name = __('Uncategorized');
+       /* translators: Default category slug */
+       $cat_slug = sanitize_title(_x('Uncategorized', 'Default category slug'));
+
+       if ( global_terms_enabled() ) {
+               $cat_id = $wpdb->get_var( $wpdb->prepare( "SELECT cat_ID FROM {$wpdb->sitecategories} WHERE category_nicename = %s", $cat_slug ) );
+               if ( $cat_id == null ) {
+                       $wpdb->insert( $wpdb->sitecategories, array('cat_ID' => 0, 'cat_name' => $cat_name, 'category_nicename' => $cat_slug, 'last_updated' => current_time('mysql', true)) );
+                       $cat_id = $wpdb->insert_id;
+               }
+               update_option('default_category', $cat_id);
+       } else {
+               $cat_id = 1;
+       }
 
-       $wpdb->query("INSERT INTO $wpdb->links (link_url, link_name, link_category, link_rss, link_notes) VALUES ('http://wordpress.org/development/', 'Development Blog', 0, 'http://wordpress.org/development/feed/', '');");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (2, 2)" );
+       $wpdb->insert( $wpdb->terms, array('term_id' => $cat_id, 'name' => $cat_name, 'slug' => $cat_slug, 'term_group' => 0) );
+       $wpdb->insert( $wpdb->term_taxonomy, array('term_id' => $cat_id, 'taxonomy' => 'category', 'description' => '', 'parent' => 0, 'count' => 1));
+       $cat_tt_id = $wpdb->insert_id;
 
-       $wpdb->query("INSERT INTO $wpdb->links (link_url, link_name, link_category, link_rss, link_notes) VALUES ('http://wordpress.org/extend/ideas/', 'Suggest Ideas', 0, '', '');");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (3, 2)" );
+       // First post
+       $now = current_time( 'mysql' );
+       $now_gmt = current_time( 'mysql', 1 );
+       $first_post_guid = get_option( 'home' ) . '/?p=1';
 
-       $wpdb->query("INSERT INTO $wpdb->links (link_url, link_name, link_category, link_rss, link_notes) VALUES ('http://wordpress.org/support/', 'Support Forum', 0, '', '');");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (4, 2)" );
+       if ( is_multisite() ) {
+               $first_post = get_site_option( 'first_post' );
 
-       $wpdb->query("INSERT INTO $wpdb->links (link_url, link_name, link_category, link_rss, link_notes) VALUES ('http://wordpress.org/extend/plugins/', 'Plugins', 0, '', '');");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (5, 2)" );
+               if ( ! $first_post ) {
+                       /* translators: %s: site link */
+                       $first_post = __( 'Welcome to %s. This is your first post. Edit or delete it, then start blogging!' );
+               }
 
-       $wpdb->query("INSERT INTO $wpdb->links (link_url, link_name, link_category, link_rss, link_notes) VALUES ('http://wordpress.org/extend/themes/', 'Themes', 0, '', '');");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (6, 2)" );
+               $first_post = sprintf( $first_post,
+                       sprintf( '<a href="%s">%s</a>', esc_url( network_home_url() ), get_current_site()->site_name )
+               );
 
-       $wpdb->query("INSERT INTO $wpdb->links (link_url, link_name, link_category, link_rss, link_notes) VALUES ('http://planet.wordpress.org/', 'WordPress Planet', 0, '', '');");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (7, 2)" );
+               // Back-compat for pre-4.4
+               $first_post = str_replace( 'SITE_URL', esc_url( network_home_url() ), $first_post );
+               $first_post = str_replace( 'SITE_NAME', get_current_site()->site_name, $first_post );
+       } else {
+               $first_post = __( 'Welcome to WordPress. This is your first post. Edit or delete it, then start writing!' );
+       }
 
-       // First post
-       $now = date('Y-m-d H:i:s');
-       $now_gmt = gmdate('Y-m-d H:i:s');
-       $first_post_guid = get_option('home') . '/?p=1';
-       $wpdb->query("INSERT INTO $wpdb->posts (post_author, post_date, post_date_gmt, post_content, post_excerpt, post_title, post_category, post_name, post_modified, post_modified_gmt, guid, comment_count, to_ping, pinged, post_content_filtered) VALUES ($user_id, '$now', '$now_gmt', '".$wpdb->escape(__('Welcome to WordPress. This is your first post. Edit or delete it, then start blogging!'))."', '', '".$wpdb->escape(__('Hello world!'))."', '0', '".$wpdb->escape(_c('hello-world|Default post slug'))."', '$now', '$now_gmt', '$first_post_guid', '1', '', '', '')");
-       $wpdb->query( "INSERT INTO $wpdb->term_relationships (`object_id`, `term_taxonomy_id`) VALUES (1, 1)" );
+       $wpdb->insert( $wpdb->posts, array(
+               'post_author' => $user_id,
+               'post_date' => $now,
+               'post_date_gmt' => $now_gmt,
+               'post_content' => $first_post,
+               'post_excerpt' => '',
+               'post_title' => __('Hello world!'),
+               /* translators: Default post slug */
+               'post_name' => sanitize_title( _x('hello-world', 'Default post slug') ),
+               'post_modified' => $now,
+               'post_modified_gmt' => $now_gmt,
+               'guid' => $first_post_guid,
+               'comment_count' => 1,
+               'to_ping' => '',
+               'pinged' => '',
+               'post_content_filtered' => ''
+       ));
+       $wpdb->insert( $wpdb->term_relationships, array('term_taxonomy_id' => $cat_tt_id, 'object_id' => 1) );
 
        // Default comment
-       $wpdb->query("INSERT INTO $wpdb->comments (comment_post_ID, comment_author, comment_author_email, comment_author_url, comment_date, comment_date_gmt, comment_content) VALUES ('1', '".$wpdb->escape(__('Mr WordPress'))."', '', 'http://wordpress.org/', '$now', '$now_gmt', '".$wpdb->escape(__('Hi, this is a comment.<br />To delete a comment, just log in and view the post&#039;s comments. There you will have the option to edit or delete them.'))."')");
+       $first_comment_author = __('Mr WordPress');
+       $first_comment_url = 'https://wordpress.org/';
+       $first_comment = __('Hi, this is a comment.
+To delete a comment, just log in and view the post&#039;s comments. There you will have the option to edit or delete them.');
+       if ( is_multisite() ) {
+               $first_comment_author = get_site_option( 'first_comment_author', $first_comment_author );
+               $first_comment_url = get_site_option( 'first_comment_url', network_home_url() );
+               $first_comment = get_site_option( 'first_comment', $first_comment );
+       }
+       $wpdb->insert( $wpdb->comments, array(
+               'comment_post_ID' => 1,
+               'comment_author' => $first_comment_author,
+               'comment_author_email' => '',
+               'comment_author_url' => $first_comment_url,
+               'comment_date' => $now,
+               'comment_date_gmt' => $now_gmt,
+               'comment_content' => $first_comment
+       ));
 
        // First Page
+       $first_page = sprintf( __( "This is an example page. It's different from a blog post because it will stay in one place and will show up in your site navigation (in most themes). Most people start with an About page that introduces them to potential site visitors. It might say something like this:
+
+<blockquote>Hi there! I'm a bike messenger by day, aspiring actor by night, and this is my website. I live in Los Angeles, have a great dog named Jack, and I like pi&#241;a coladas. (And gettin' caught in the rain.)</blockquote>
+
+...or something like this:
+
+<blockquote>The XYZ Doohickey Company was founded in 1971, and has been providing quality doohickeys to the public ever since. Located in Gotham City, XYZ employs over 2,000 people and does all kinds of awesome things for the Gotham community.</blockquote>
+
+As a new WordPress user, you should go to <a href=\"%s\">your dashboard</a> to delete this page and create new pages for your content. Have fun!" ), admin_url() );
+       if ( is_multisite() )
+               $first_page = get_site_option( 'first_page', $first_page );
        $first_post_guid = get_option('home') . '/?page_id=2';
-       $wpdb->query("INSERT INTO $wpdb->posts (post_author, post_date, post_date_gmt, post_content, post_excerpt, post_title, post_category, post_name, post_modified, post_modified_gmt, guid, post_status, post_type, to_ping, pinged, post_content_filtered) VALUES ($user_id, '$now', '$now_gmt', '".$wpdb->escape(__('This is an example of a WordPress page, you could edit this to put information about yourself or your site so readers know where you are coming from. You can create as many pages like this one or sub-pages as you like and manage all of your content inside of WordPress.'))."', '', '".$wpdb->escape(__('About'))."', '0', '".$wpdb->escape(_c('about|Default page slug'))."', '$now', '$now_gmt','$first_post_guid', 'publish', 'page', '', '', '')");
+       $wpdb->insert( $wpdb->posts, array(
+               'post_author' => $user_id,
+               'post_date' => $now,
+               'post_date_gmt' => $now_gmt,
+               'post_content' => $first_page,
+               'post_excerpt' => '',
+               'comment_status' => 'closed',
+               'post_title' => __( 'Sample Page' ),
+               /* translators: Default page slug */
+               'post_name' => __( 'sample-page' ),
+               'post_modified' => $now,
+               'post_modified_gmt' => $now_gmt,
+               'guid' => $first_post_guid,
+               'post_type' => 'page',
+               'to_ping' => '',
+               'pinged' => '',
+               'post_content_filtered' => ''
+       ));
+       $wpdb->insert( $wpdb->postmeta, array( 'post_id' => 2, 'meta_key' => '_wp_page_template', 'meta_value' => 'default' ) );
+
+       // Set up default widgets for default theme.
+       update_option( 'widget_search', array ( 2 => array ( 'title' => '' ), '_multiwidget' => 1 ) );
+       update_option( 'widget_recent-posts', array ( 2 => array ( 'title' => '', 'number' => 5 ), '_multiwidget' => 1 ) );
+       update_option( 'widget_recent-comments', array ( 2 => array ( 'title' => '', 'number' => 5 ), '_multiwidget' => 1 ) );
+       update_option( 'widget_archives', array ( 2 => array ( 'title' => '', 'count' => 0, 'dropdown' => 0 ), '_multiwidget' => 1 ) );
+       update_option( 'widget_categories', array ( 2 => array ( 'title' => '', 'count' => 0, 'hierarchical' => 0, 'dropdown' => 0 ), '_multiwidget' => 1 ) );
+       update_option( 'widget_meta', array ( 2 => array ( 'title' => '' ), '_multiwidget' => 1 ) );
+       update_option( 'sidebars_widgets', array ( 'wp_inactive_widgets' => array (), 'sidebar-1' => array ( 0 => 'search-2', 1 => 'recent-posts-2', 2 => 'recent-comments-2', 3 => 'archives-2', 4 => 'categories-2', 5 => 'meta-2', ), 'array_version' => 3 ) );
+
+       if ( ! is_multisite() )
+               update_user_meta( $user_id, 'show_welcome_panel', 1 );
+       elseif ( ! is_super_admin( $user_id ) && ! metadata_exists( 'user', $user_id, 'show_welcome_panel' ) )
+               update_user_meta( $user_id, 'show_welcome_panel', 2 );
+
+       if ( is_multisite() ) {
+               // Flush rules to pick up the new page.
+               $wp_rewrite->init();
+               $wp_rewrite->flush_rules();
+
+               $user = new WP_User($user_id);
+               $wpdb->update( $wpdb->options, array('option_value' => $user->user_email), array('option_name' => 'admin_email') );
+
+               // Remove all perms except for the login user.
+               $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id != %d AND meta_key = %s", $user_id, $table_prefix.'user_level') );
+               $wpdb->query( $wpdb->prepare("DELETE FROM $wpdb->usermeta WHERE user_id != %d AND meta_key = %s", $user_id, $table_prefix.'capabilities') );
+
+               // Delete any caps that snuck into the previously active blog. (Hardcoded to blog 1 for now.) TODO: Get previous_blog_id.
+               if ( !is_super_admin( $user_id ) && $user_id != 1 )
+                       $wpdb->delete( $wpdb->usermeta, array( 'user_id' => $user_id , 'meta_key' => $wpdb->base_prefix.'1_capabilities' ) );
+       }
 }
 endif;
 
+/**
+ * Maybe enable pretty permalinks on install.
+ *
+ * If after enabling pretty permalinks don't work, fallback to query-string permalinks.
+ *
+ * @since 4.2.0
+ *
+ * @global WP_Rewrite $wp_rewrite WordPress rewrite component.
+ *
+ * @return bool Whether pretty permalinks are enabled. False otherwise.
+ */
+function wp_install_maybe_enable_pretty_permalinks() {
+       global $wp_rewrite;
+
+       // Bail if a permalink structure is already enabled.
+       if ( get_option( 'permalink_structure' ) ) {
+               return true;
+       }
+
+       /*
+        * The Permalink structures to attempt.
+        *
+        * The first is designed for mod_rewrite or nginx rewriting.
+        *
+        * The second is PATHINFO-based permalinks for web server configurations
+        * without a true rewrite module enabled.
+        */
+       $permalink_structures = array(
+               '/%year%/%monthnum%/%day%/%postname%/',
+               '/index.php/%year%/%monthnum%/%day%/%postname%/'
+       );
+
+       foreach ( (array) $permalink_structures as $permalink_structure ) {
+               $wp_rewrite->set_permalink_structure( $permalink_structure );
+
+               /*
+                * Flush rules with the hard option to force refresh of the web-server's
+                * rewrite config file (e.g. .htaccess or web.config).
+                */
+               $wp_rewrite->flush_rules( true );
+
+               // Test against a real WordPress Post, or if none were created, a random 404 page.
+               $test_url = get_permalink( 1 );
+
+               if ( ! $test_url ) {
+                       $test_url = home_url( '/wordpress-check-for-rewrites/' );
+               }
+
+               /*
+                * Send a request to the site, and check whether
+                * the 'x-pingback' header is returned as expected.
+                *
+                * Uses wp_remote_get() instead of wp_remote_head() because web servers
+                * can block head requests.
+                */
+               $response          = wp_remote_get( $test_url, array( 'timeout' => 5 ) );
+               $x_pingback_header = wp_remote_retrieve_header( $response, 'x-pingback' );
+               $pretty_permalinks = $x_pingback_header && $x_pingback_header === get_bloginfo( 'pingback_url' );
+
+               if ( $pretty_permalinks ) {
+                       return true;
+               }
+       }
+
+       /*
+        * If it makes it this far, pretty permalinks failed.
+        * Fallback to query-string permalinks.
+        */
+       $wp_rewrite->set_permalink_structure( '' );
+       $wp_rewrite->flush_rules( true );
+
+       return false;
+}
+
 if ( !function_exists('wp_new_blog_notification') ) :
 /**
- * {@internal Missing Short Description}}
+ * Notifies the site admin that the setup is complete.
  *
- * {@internal Missing Long Description}}
+ * Sends an email with wp_mail to the new administrator that the site setup is complete,
+ * and provides them with a record of their login credentials.
  *
- * @since unknown
+ * @since 2.1.0
  *
  * @param string $blog_title Blog title.
- * @param string $blog_url Blog url.
- * @param int $user_id User ID.
- * @param string $password User's Password.
+ * @param string $blog_url   Blog url.
+ * @param int    $user_id    User ID.
+ * @param string $password   User's Password.
  */
 function wp_new_blog_notification($blog_title, $blog_url, $user_id, $password) {
-       $user = new WP_User($user_id);
+       $user = new WP_User( $user_id );
        $email = $user->user_email;
        $name = $user->user_login;
-       $message_headers = 'From: "' . $blog_title . '" <wordpress@' . $_SERVER['SERVER_NAME'] . '>';
-       $message = sprintf(__("Your new WordPress blog has been successfully set up at:
+       $login_url = wp_login_url();
+       $message = sprintf( __( "Your new WordPress site has been successfully set up at:
 
 %1\$s
 
@@ -168,59 +377,86 @@ You can log in to the administrator account with the following information:
 
 Username: %2\$s
 Password: %3\$s
+Log in here: %4\$s
 
-We hope you enjoy your new blog. Thanks!
+We hope you enjoy your new site. Thanks!
 
 --The WordPress Team
-http://wordpress.org/
-"), $blog_url, $name, $password);
+https://wordpress.org/
+"), $blog_url, $name, $password, $login_url );
 
-       @wp_mail($email, __('New WordPress Blog'), $message, $message_headers);
+       @wp_mail($email, __('New WordPress Site'), $message);
 }
 endif;
 
 if ( !function_exists('wp_upgrade') ) :
 /**
- * Run WordPress Upgrade functions.
+ * Runs WordPress Upgrade functions.
  *
- * {@internal Missing Long Description}}
+ * Upgrades the database if needed during a site update.
  *
- * @since unknown
+ * @since 2.1.0
  *
- * @return null
+ * @global int  $wp_current_db_version
+ * @global int  $wp_db_version
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function wp_upgrade() {
-       global $wp_current_db_version, $wp_db_version;
+       global $wp_current_db_version, $wp_db_version, $wpdb;
 
        $wp_current_db_version = __get_option('db_version');
 
-       // We are up-to-date.  Nothing to do.
+       // We are up-to-date. Nothing to do.
        if ( $wp_db_version == $wp_current_db_version )
                return;
 
-       if( ! is_blog_installed() )
+       if ( ! is_blog_installed() )
                return;
 
        wp_check_mysql_version();
        wp_cache_flush();
+       pre_schema_upgrade();
        make_db_current_silent();
        upgrade_all();
+       if ( is_multisite() && is_main_site() )
+               upgrade_network();
        wp_cache_flush();
+
+       if ( is_multisite() ) {
+               if ( $wpdb->get_row( "SELECT blog_id FROM {$wpdb->blog_versions} WHERE blog_id = '{$wpdb->blogid}'" ) )
+                       $wpdb->query( "UPDATE {$wpdb->blog_versions} SET db_version = '{$wp_db_version}' WHERE blog_id = '{$wpdb->blogid}'" );
+               else
+                       $wpdb->query( "INSERT INTO {$wpdb->blog_versions} ( `blog_id` , `db_version` , `last_updated` ) VALUES ( '{$wpdb->blogid}', '{$wp_db_version}', NOW());" );
+       }
+
+       /**
+        * Fires after a site is fully upgraded.
+        *
+        * @since 3.9.0
+        *
+        * @param int $wp_db_version         The new $wp_db_version.
+        * @param int $wp_current_db_version The old (current) $wp_db_version.
+        */
+       do_action( 'wp_upgrade', $wp_db_version, $wp_current_db_version );
 }
 endif;
 
 /**
  * Functions to be called in install and upgrade scripts.
  *
- * {@internal Missing Long Description}}
+ * Contains conditional checks to determine which upgrade scripts to run,
+ * based on database version and WP version being updated-to.
  *
- * @since unknown
+ * @since 1.0.1
+ *
+ * @global int $wp_current_db_version
+ * @global int $wp_db_version
  */
 function upgrade_all() {
-       global $wp_current_db_version, $wp_db_version, $wp_rewrite;
+       global $wp_current_db_version, $wp_db_version;
        $wp_current_db_version = __get_option('db_version');
 
-       // We are up-to-date.  Nothing to do.
+       // We are up-to-date. Nothing to do.
        if ( $wp_db_version == $wp_current_db_version )
                return;
 
@@ -264,9 +500,6 @@ function upgrade_all() {
        if ( $wp_current_db_version < 7499 )
                upgrade_250();
 
-       if ( $wp_current_db_version < 7796 )
-               upgrade_251();
-
        if ( $wp_current_db_version < 7935 )
                upgrade_252();
 
@@ -276,17 +509,59 @@ function upgrade_all() {
        if ( $wp_current_db_version < 8989 )
                upgrade_270();
 
-       maybe_disable_automattic_widgets();
+       if ( $wp_current_db_version < 10360 )
+               upgrade_280();
+
+       if ( $wp_current_db_version < 11958 )
+               upgrade_290();
+
+       if ( $wp_current_db_version < 15260 )
+               upgrade_300();
+
+       if ( $wp_current_db_version < 19389 )
+               upgrade_330();
+
+       if ( $wp_current_db_version < 20080 )
+               upgrade_340();
+
+       if ( $wp_current_db_version < 22422 )
+               upgrade_350();
+
+       if ( $wp_current_db_version < 25824 )
+               upgrade_370();
+
+       if ( $wp_current_db_version < 26148 )
+               upgrade_372();
 
-       $wp_rewrite->flush_rules();
+       if ( $wp_current_db_version < 26691 )
+               upgrade_380();
 
-       update_option('db_version', $wp_db_version);
+       if ( $wp_current_db_version < 29630 )
+               upgrade_400();
+
+       if ( $wp_current_db_version < 33055 )
+               upgrade_430();
+
+       if ( $wp_current_db_version < 33056 )
+               upgrade_431();
+
+       if ( $wp_current_db_version < 35700 )
+               upgrade_440();
+
+       maybe_disable_link_manager();
+
+       maybe_disable_automattic_widgets();
+
+       update_option( 'db_version', $wp_db_version );
+       update_option( 'db_upgraded', true );
 }
 
 /**
  * Execute changes made in WordPress 1.0.
  *
  * @since 1.0.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_100() {
        global $wpdb;
@@ -294,7 +569,7 @@ function upgrade_100() {
        // Get the title and ID of every post, post_name to check if it already has a value
        $posts = $wpdb->get_results("SELECT ID, post_title, post_name FROM $wpdb->posts WHERE post_name = ''");
        if ($posts) {
-               foreach($posts as $post) {
+               foreach ($posts as $post) {
                        if ('' == $post->post_name) {
                                $newtitle = sanitize_title($post->post_title);
                                $wpdb->query( $wpdb->prepare("UPDATE $wpdb->posts SET post_name = %s WHERE ID = %d", $newtitle, $post->ID) );
@@ -306,16 +581,19 @@ function upgrade_100() {
        foreach ($categories as $category) {
                if ('' == $category->category_nicename) {
                        $newtitle = sanitize_title($category->cat_name);
-                       $wpdb->query( $wpdb->prepare("UPDATE $wpdb->categories SET category_nicename = %s WHERE cat_ID = %d", $newtitle, $category->cat_ID) );
+                       $wpdb->update( $wpdb->categories, array('category_nicename' => $newtitle), array('cat_ID' => $category->cat_ID) );
                }
        }
 
-       $wpdb->query("UPDATE $wpdb->options SET option_value = REPLACE(option_value, 'wp-links/links-images/', 'wp-images/links/')
-       WHERE option_name LIKE 'links_rating_image%'
-       AND option_value LIKE 'wp-links/links-images/%'");
+       $sql = "UPDATE $wpdb->options
+               SET option_value = REPLACE(option_value, 'wp-links/links-images/', 'wp-images/links/')
+               WHERE option_name LIKE %s
+               AND option_value LIKE %s";
+       $wpdb->query( $wpdb->prepare( $sql, $wpdb->esc_like( 'links_rating_image' ) . '%', $wpdb->esc_like( 'wp-links/links-images/' ) . '%' ) );
 
        $done_ids = $wpdb->get_results("SELECT DISTINCT post_id FROM $wpdb->post2cat");
        if ($done_ids) :
+               $done_posts = array();
                foreach ($done_ids as $done_id) :
                        $done_posts[] = $done_id->post_id;
                endforeach;
@@ -330,10 +608,7 @@ function upgrade_100() {
                        // Check to see if it's already been imported
                        $cat = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->post2cat WHERE post_id = %d AND category_id = %d", $post->ID, $post->post_category) );
                        if (!$cat && 0 != $post->post_category) { // If there's no result
-                               $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->post2cat
-                                       (post_id, category_id)
-                                       VALUES (%s, %s)
-                                       ", $post->ID, $post->post_category) );
+                               $wpdb->insert( $wpdb->post2cat, array('post_id' => $post->ID, 'category_id' => $post->post_category) );
                        }
                }
        endif;
@@ -343,6 +618,8 @@ function upgrade_100() {
  * Execute changes made in WordPress 1.0.1.
  *
  * @since 1.0.1
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_101() {
        global $wpdb;
@@ -361,6 +638,8 @@ function upgrade_101() {
  * Execute changes made in WordPress 1.2.
  *
  * @since 1.2.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_110() {
        global $wpdb;
@@ -370,14 +649,14 @@ function upgrade_110() {
        foreach ($users as $user) {
                if ('' == $user->user_nicename) {
                        $newname = sanitize_title($user->user_nickname);
-                       $wpdb->query( $wpdb->prepare("UPDATE $wpdb->users SET user_nicename = %s WHERE ID = %d", $newname, $user->ID) );
+                       $wpdb->update( $wpdb->users, array('user_nicename' => $newname), array('ID' => $user->ID) );
                }
        }
 
        $users = $wpdb->get_results("SELECT ID, user_pass from $wpdb->users");
        foreach ($users as $row) {
                if (!preg_match('/^[A-Fa-f0-9]{32}$/', $row->user_pass)) {
-                       $wpdb->query('UPDATE '.$wpdb->users.' SET user_pass = MD5(\''.$row->user_pass.'\') WHERE ID = \''.$row->ID.'\'');
+                       $wpdb->update( $wpdb->users, array('user_pass' => md5($row->user_pass)), array('ID' => $row->ID) );
                }
        }
 
@@ -386,12 +665,12 @@ function upgrade_110() {
 
        $time_difference = $all_options->time_difference;
 
-       $server_time = time()+date('Z');
-       $weblogger_time = $server_time + $time_difference*3600;
+               $server_time = time()+date('Z');
+       $weblogger_time = $server_time + $time_difference * HOUR_IN_SECONDS;
        $gmt_time = time();
 
-       $diff_gmt_server = ($gmt_time - $server_time) / 3600;
-       $diff_weblogger_server = ($weblogger_time - $server_time) / 3600;
+       $diff_gmt_server = ($gmt_time - $server_time) / HOUR_IN_SECONDS;
+       $diff_weblogger_server = ($weblogger_time - $server_time) / HOUR_IN_SECONDS;
        $diff_gmt_weblogger = $diff_gmt_server - $diff_weblogger_server;
        $gmt_offset = -$diff_gmt_weblogger;
 
@@ -401,11 +680,11 @@ function upgrade_110() {
        // Check if we already set the GMT fields (if we did, then
        // MAX(post_date_gmt) can't be '0000-00-00 00:00:00'
        // <michel_v> I just slapped myself silly for not thinking about it earlier
-       $got_gmt_fields = ($wpdb->get_var("SELECT MAX(post_date_gmt) FROM $wpdb->posts") == '0000-00-00 00:00:00') ? false : true;
+       $got_gmt_fields = ! ($wpdb->get_var("SELECT MAX(post_date_gmt) FROM $wpdb->posts") == '0000-00-00 00:00:00');
 
        if (!$got_gmt_fields) {
 
-               // Add or substract time to all dates, to get GMT dates
+               // Add or subtract time to all dates, to get GMT dates
                $add_hours = intval($diff_gmt_weblogger);
                $add_minutes = intval(60 * ($diff_gmt_weblogger - $add_hours));
                $wpdb->query("UPDATE $wpdb->posts SET post_date_gmt = DATE_ADD(post_date, INTERVAL '$add_hours:$add_minutes' HOUR_MINUTE)");
@@ -421,6 +700,8 @@ function upgrade_110() {
  * Execute changes made in WordPress 1.5.
  *
  * @since 1.5.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_130() {
        global $wpdb;
@@ -428,7 +709,7 @@ function upgrade_130() {
        // Remove extraneous backslashes.
        $posts = $wpdb->get_results("SELECT ID, post_title, post_content, post_excerpt, guid, post_date, post_name, post_status, post_author FROM $wpdb->posts");
        if ($posts) {
-               foreach($posts as $post) {
+               foreach ($posts as $post) {
                        $post_content = addslashes(deslash($post->post_content));
                        $post_title = addslashes(deslash($post->post_title));
                        $post_excerpt = addslashes(deslash($post->post_excerpt));
@@ -437,39 +718,39 @@ function upgrade_130() {
                        else
                                $guid = $post->guid;
 
-                       $wpdb->query("UPDATE $wpdb->posts SET post_title = '$post_title', post_content = '$post_content', post_excerpt = '$post_excerpt', guid = '$guid' WHERE ID = '$post->ID'");
+                       $wpdb->update( $wpdb->posts, compact('post_title', 'post_content', 'post_excerpt', 'guid'), array('ID' => $post->ID) );
+
                }
        }
 
        // Remove extraneous backslashes.
        $comments = $wpdb->get_results("SELECT comment_ID, comment_author, comment_content FROM $wpdb->comments");
        if ($comments) {
-               foreach($comments as $comment) {
-                       $comment_content = addslashes(deslash($comment->comment_content));
-                       $comment_author = addslashes(deslash($comment->comment_author));
-                       $wpdb->query("UPDATE $wpdb->comments SET comment_content = '$comment_content', comment_author = '$comment_author' WHERE comment_ID = '$comment->comment_ID'");
+               foreach ($comments as $comment) {
+                       $comment_content = deslash($comment->comment_content);
+                       $comment_author = deslash($comment->comment_author);
+
+                       $wpdb->update($wpdb->comments, compact('comment_content', 'comment_author'), array('comment_ID' => $comment->comment_ID) );
                }
        }
 
        // Remove extraneous backslashes.
        $links = $wpdb->get_results("SELECT link_id, link_name, link_description FROM $wpdb->links");
        if ($links) {
-               foreach($links as $link) {
-                       $link_name = addslashes(deslash($link->link_name));
-                       $link_description = addslashes(deslash($link->link_description));
-                       $wpdb->query("UPDATE $wpdb->links SET link_name = '$link_name', link_description = '$link_description' WHERE link_id = '$link->link_id'");
-               }
-       }
+               foreach ($links as $link) {
+                       $link_name = deslash($link->link_name);
+                       $link_description = deslash($link->link_description);
 
-       // The "paged" option for what_to_show is no more.
-       if ($wpdb->get_var("SELECT option_value FROM $wpdb->options WHERE option_name = 'what_to_show'") == 'paged') {
-               $wpdb->query("UPDATE $wpdb->options SET option_value = 'posts' WHERE option_name = 'what_to_show'");
+                       $wpdb->update( $wpdb->links, compact('link_name', 'link_description'), array('link_id' => $link->link_id) );
+               }
        }
 
        $active_plugins = __get_option('active_plugins');
 
-       // If plugins are not stored in an array, they're stored in the old
-       // newline separated format.  Convert to new format.
+       /*
+        * If plugins are not stored in an array, they're stored in the old
+        * newline separated format. Convert to new format.
+        */
        if ( !is_array( $active_plugins ) ) {
                $active_plugins = explode("\n", trim($active_plugins));
                update_option('active_plugins', $active_plugins);
@@ -491,8 +772,10 @@ function upgrade_130() {
                if ( 1 != $option->dupes ) { // Could this be done in the query?
                        $limit = $option->dupes - 1;
                        $dupe_ids = $wpdb->get_col( $wpdb->prepare("SELECT option_id FROM $wpdb->options WHERE option_name = %s LIMIT %d", $option->option_name, $limit) );
-                       $dupe_ids = join($dupe_ids, ',');
-                       $wpdb->query("DELETE FROM $wpdb->options WHERE option_id IN ($dupe_ids)");
+                       if ( $dupe_ids ) {
+                               $dupe_ids = join($dupe_ids, ',');
+                               $wpdb->query("DELETE FROM $wpdb->options WHERE option_id IN ($dupe_ids)");
+                       }
                }
        }
 
@@ -503,6 +786,9 @@ function upgrade_130() {
  * Execute changes made in WordPress 2.0.
  *
  * @since 2.0.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ * @global int  $wp_current_db_version
  */
 function upgrade_160() {
        global $wpdb, $wp_current_db_version;
@@ -512,23 +798,23 @@ function upgrade_160() {
        $users = $wpdb->get_results("SELECT * FROM $wpdb->users");
        foreach ( $users as $user ) :
                if ( !empty( $user->user_firstname ) )
-                       update_usermeta( $user->ID, 'first_name', $wpdb->escape($user->user_firstname) );
+                       update_user_meta( $user->ID, 'first_name', wp_slash($user->user_firstname) );
                if ( !empty( $user->user_lastname ) )
-                       update_usermeta( $user->ID, 'last_name', $wpdb->escape($user->user_lastname) );
+                       update_user_meta( $user->ID, 'last_name', wp_slash($user->user_lastname) );
                if ( !empty( $user->user_nickname ) )
-                       update_usermeta( $user->ID, 'nickname', $wpdb->escape($user->user_nickname) );
+                       update_user_meta( $user->ID, 'nickname', wp_slash($user->user_nickname) );
                if ( !empty( $user->user_level ) )
-                       update_usermeta( $user->ID, $wpdb->prefix . 'user_level', $user->user_level );
+                       update_user_meta( $user->ID, $wpdb->prefix . 'user_level', $user->user_level );
                if ( !empty( $user->user_icq ) )
-                       update_usermeta( $user->ID, 'icq', $wpdb->escape($user->user_icq) );
+                       update_user_meta( $user->ID, 'icq', wp_slash($user->user_icq) );
                if ( !empty( $user->user_aim ) )
-                       update_usermeta( $user->ID, 'aim', $wpdb->escape($user->user_aim) );
+                       update_user_meta( $user->ID, 'aim', wp_slash($user->user_aim) );
                if ( !empty( $user->user_msn ) )
-                       update_usermeta( $user->ID, 'msn', $wpdb->escape($user->user_msn) );
+                       update_user_meta( $user->ID, 'msn', wp_slash($user->user_msn) );
                if ( !empty( $user->user_yim ) )
-                       update_usermeta( $user->ID, 'yim', $wpdb->escape($user->user_icq) );
+                       update_user_meta( $user->ID, 'yim', wp_slash($user->user_icq) );
                if ( !empty( $user->user_description ) )
-                       update_usermeta( $user->ID, 'description', $wpdb->escape($user->user_description) );
+                       update_user_meta( $user->ID, 'description', wp_slash($user->user_description) );
 
                if ( isset( $user->user_idmode ) ):
                        $idmode = $user->user_idmode;
@@ -539,15 +825,15 @@ function upgrade_160() {
                        if ($idmode == 'namefl') $id = $user->user_firstname.' '.$user->user_lastname;
                        if ($idmode == 'namelf') $id = $user->user_lastname.' '.$user->user_firstname;
                        if (!$idmode) $id = $user->user_nickname;
-                       $wpdb->query( $wpdb->prepare("UPDATE $wpdb->users SET display_name = %s WHERE ID = %d", $id, $user->ID) );
+                       $wpdb->update( $wpdb->users, array('display_name' => $id), array('ID' => $user->ID) );
                endif;
 
                // FIXME: RESET_CAPS is temporary code to reset roles and caps if flag is set.
-               $caps = get_usermeta( $user->ID, $wpdb->prefix . 'capabilities');
+               $caps = get_user_meta( $user->ID, $wpdb->prefix . 'capabilities');
                if ( empty($caps) || defined('RESET_CAPS') ) {
-                       $level = get_usermeta($user->ID, $wpdb->prefix . 'user_level');
+                       $level = get_user_meta($user->ID, $wpdb->prefix . 'user_level', true);
                        $role = translate_level_to_role($level);
-                       update_usermeta( $user->ID, $wpdb->prefix . 'capabilities', array($role => true) );
+                       update_user_meta( $user->ID, $wpdb->prefix . 'capabilities', array($role => true) );
                }
 
        endforeach;
@@ -557,23 +843,23 @@ function upgrade_160() {
                $wpdb->query("ALTER TABLE $wpdb->users DROP $old");
        $wpdb->show_errors();
 
-       // populate comment_count field of posts table
+       // Populate comment_count field of posts table.
        $comments = $wpdb->get_results( "SELECT comment_post_ID, COUNT(*) as c FROM $wpdb->comments WHERE comment_approved = '1' GROUP BY comment_post_ID" );
-       if( is_array( $comments ) ) {
-               foreach ($comments as $comment) {
-                       $wpdb->query( $wpdb->prepare("UPDATE $wpdb->posts SET comment_count = %d WHERE ID = %d", $comment->c, $comment->comment_post_ID) );
-               }
-       }
-
-       // Some alpha versions used a post status of object instead of attachment and put
-       // the mime type in post_type instead of post_mime_type.
+       if ( is_array( $comments ) )
+               foreach ($comments as $comment)
+                       $wpdb->update( $wpdb->posts, array('comment_count' => $comment->c), array('ID' => $comment->comment_post_ID) );
+
+       /*
+        * Some alpha versions used a post status of object instead of attachment
+        * and put the mime type in post_type instead of post_mime_type.
+        */
        if ( $wp_current_db_version > 2541 && $wp_current_db_version <= 3091 ) {
                $objects = $wpdb->get_results("SELECT ID, post_type FROM $wpdb->posts WHERE post_status = 'object'");
                foreach ($objects as $object) {
-                       $wpdb->query( $wpdb->prepare("UPDATE $wpdb->posts SET post_status = 'attachment',
-                       post_mime_type = %s,
-                       post_type = ''
-                       WHERE ID = %d", $object->post_type, $object->ID) );
+                       $wpdb->update( $wpdb->posts, array(     'post_status' => 'attachment',
+                                                                                               'post_mime_type' => $object->post_type,
+                                                                                               'post_type' => ''),
+                                                                                array( 'ID' => $object->ID ) );
 
                        $meta = get_post_meta($object->ID, 'imagedata', true);
                        if ( ! empty($meta['file']) )
@@ -586,6 +872,9 @@ function upgrade_160() {
  * Execute changes made in WordPress 2.1.
  *
  * @since 2.1.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ * @global int  $wp_current_db_version
  */
 function upgrade_210() {
        global $wpdb, $wp_current_db_version;
@@ -601,7 +890,7 @@ function upgrade_210() {
                        if ( 'static' == $status ) {
                                $status = 'publish';
                                $type = 'page';
-                       } else if ( 'attachment' == $status ) {
+                       } elseif ( 'attachment' == $status ) {
                                $status = 'inherit';
                                $type = 'attachment';
                        }
@@ -622,7 +911,7 @@ function upgrade_210() {
                $posts = $wpdb->get_results("SELECT ID, post_date FROM $wpdb->posts WHERE post_status ='future'");
                if ( !empty($posts) )
                        foreach ( $posts as $post )
-                               wp_schedule_single_event(mysql2date('U', $post->post_date), 'publish_future_post', array($post->ID));
+                               wp_schedule_single_event(mysql2date('U', $post->post_date, false), 'publish_future_post', array($post->ID));
        }
 }
 
@@ -630,6 +919,9 @@ function upgrade_210() {
  * Execute changes made in WordPress 2.3.
  *
  * @since 2.3.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ * @global int  $wp_current_db_version
  */
 function upgrade_230() {
        global $wp_current_db_version, $wpdb;
@@ -691,14 +983,14 @@ function upgrade_230() {
                        $have_tags = true;
                        $count = (int) $category->tag_count;
                        $taxonomy = 'post_tag';
-                       $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->term_taxonomy (term_id, taxonomy, description, parent, count) VALUES ( %d, %s, %s, %d, %d)", $term_id, $taxonomy, $description, $parent, $count) );
+                       $wpdb->insert( $wpdb->term_taxonomy, compact('term_id', 'taxonomy', 'description', 'parent', 'count') );
                        $tt_ids[$term_id][$taxonomy] = (int) $wpdb->insert_id;
                }
 
                if ( empty($count) ) {
                        $count = 0;
                        $taxonomy = 'category';
-                       $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->term_taxonomy (term_id, taxonomy, description, parent, count) VALUES ( %d, %s, %s, %d, %d)", $term_id, $taxonomy, $description, $parent, $count) );
+                       $wpdb->insert( $wpdb->term_taxonomy, compact('term_id', 'taxonomy', 'description', 'parent', 'count') );
                        $tt_ids[$term_id][$taxonomy] = (int) $wpdb->insert_id;
                }
        }
@@ -718,13 +1010,15 @@ function upgrade_230() {
                if ( empty($tt_id) )
                        continue;
 
-               $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->term_relationships (object_id, term_taxonomy_id) VALUES ( %d, %d)", $post_id, $tt_id) );
+               $wpdb->insert( $wpdb->term_relationships, array('object_id' => $post_id, 'term_taxonomy_id' => $tt_id) );
        }
 
-       // < 3570 we used linkcategories.  >= 3570 we used categories and link2cat.
+       // < 3570 we used linkcategories. >= 3570 we used categories and link2cat.
        if ( $wp_current_db_version < 3570 ) {
-               // Create link_category terms for link categories.  Create a map of link cat IDs
-               // to link_category terms.
+               /*
+                * Create link_category terms for link categories. Create a map of link
+                * cat IDs to link_category terms.
+                */
                $link_cat_id_map = array();
                $default_link_cat = 0;
                $tt_ids = array();
@@ -732,7 +1026,7 @@ function upgrade_230() {
                foreach ( $link_cats as $category) {
                        $cat_id = (int) $category->cat_id;
                        $term_id = 0;
-                       $name = $wpdb->escape($category->cat_name);
+                       $name = wp_slash($category->cat_name);
                        $slug = sanitize_title($name);
                        $term_group = 0;
 
@@ -743,14 +1037,14 @@ function upgrade_230() {
                        }
 
                        if ( empty($term_id) ) {
-                               $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->terms (name, slug, term_group) VALUES (%s, %s, %d)", $name, $slug, $term_group) );
+                               $wpdb->insert( $wpdb->terms, compact('name', 'slug', 'term_group') );
                                $term_id = (int) $wpdb->insert_id;
                        }
 
                        $link_cat_id_map[$cat_id] = $term_id;
                        $default_link_cat = $term_id;
 
-                       $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->term_taxonomy (term_id, taxonomy, description, parent, count) VALUES (%d, 'link_category', '', '0', '0')", $term_id) );
+                       $wpdb->insert( $wpdb->term_taxonomy, array('term_id' => $term_id, 'taxonomy' => 'link_category', 'description' => '', 'parent' => 0, 'count' => 0) );
                        $tt_ids[$term_id] = (int) $wpdb->insert_id;
                }
 
@@ -766,7 +1060,7 @@ function upgrade_230() {
                        if ( empty($tt_id) )
                                continue;
 
-                       $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->term_relationships (object_id, term_taxonomy_id) VALUES ( %d, %d)", $link->link_id, $tt_id) );
+                       $wpdb->insert( $wpdb->term_relationships, array('object_id' => $link->link_id, 'term_taxonomy_id' => $tt_id) );
                }
 
                // Set default to the last category we grabbed during the upgrade loop.
@@ -780,8 +1074,7 @@ function upgrade_230() {
                        $tt_id = $tt_ids[$term_id][$taxonomy];
                        if ( empty($tt_id) )
                                continue;
-
-                       $wpdb->query( $wpdb->prepare("INSERT INTO $wpdb->term_relationships (object_id, term_taxonomy_id) VALUES ( %d, %d)", $link_id, $tt_id) );
+                       $wpdb->insert( $wpdb->term_relationships, array('object_id' => $link_id, 'term_taxonomy_id' => $tt_id) );
                }
        }
 
@@ -797,7 +1090,7 @@ function upgrade_230() {
                        $count = $wpdb->get_var( $wpdb->prepare("SELECT COUNT(*) FROM $wpdb->term_relationships, $wpdb->posts WHERE $wpdb->posts.ID = $wpdb->term_relationships.object_id AND post_status = 'publish' AND post_type = 'post' AND term_taxonomy_id = %d", $term->term_taxonomy_id) );
                else
                        $count = $wpdb->get_var( $wpdb->prepare("SELECT COUNT(*) FROM $wpdb->term_relationships WHERE term_taxonomy_id = %d", $term->term_taxonomy_id) );
-               $wpdb->query( $wpdb->prepare("UPDATE $wpdb->term_taxonomy SET count = %d WHERE term_taxonomy_id = %d", $count, $term->term_taxonomy_id) );
+               $wpdb->update( $wpdb->term_taxonomy, array('count' => $count), array('term_taxonomy_id' => $term->term_taxonomy_id) );
        }
 }
 
@@ -805,6 +1098,8 @@ function upgrade_230() {
  * Remove old options from the database.
  *
  * @since 2.3.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_230_options_table() {
        global $wpdb;
@@ -819,6 +1114,8 @@ function upgrade_230_options_table() {
  * Remove old categories, link2cat, and post2cat database tables.
  *
  * @since 2.3.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_230_old_tables() {
        global $wpdb;
@@ -831,9 +1128,11 @@ function upgrade_230_old_tables() {
  * Upgrade old slugs made in version 2.2.
  *
  * @since 2.2.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_old_slugs() {
-       // upgrade people who were using the Redirect Old Slugs plugin
+       // Upgrade people who were using the Redirect Old Slugs plugin.
        global $wpdb;
        $wpdb->query("UPDATE $wpdb->postmeta SET meta_key = '_wp_old_slug' WHERE meta_key = 'old_slug'");
 }
@@ -842,6 +1141,8 @@ function upgrade_old_slugs() {
  * Execute changes made in WordPress 2.5.0.
  *
  * @since 2.5.0
+ *
+ * @global int $wp_current_db_version
  */
 function upgrade_250() {
        global $wp_current_db_version;
@@ -852,22 +1153,12 @@ function upgrade_250() {
 
 }
 
-/**
- * Execute changes made in WordPress 2.5.1.
- *
- * @since 2.5.1
- */
-function upgrade_251() {
-       global $wp_current_db_version;
-
-       // Make the secret longer
-       update_option('secret', wp_generate_password(64));
-}
-
 /**
  * Execute changes made in WordPress 2.5.2.
  *
  * @since 2.5.2
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
 function upgrade_252() {
        global $wpdb;
@@ -879,23 +1170,23 @@ function upgrade_252() {
  * Execute changes made in WordPress 2.6.
  *
  * @since 2.6.0
+ *
+ * @global int $wp_current_db_version
  */
 function upgrade_260() {
        global $wp_current_db_version;
 
        if ( $wp_current_db_version < 8000 )
                populate_roles_260();
-
-       if ( $wp_current_db_version < 8201 ) {
-               update_option('enable_app', 1);
-               update_option('enable_xmlrpc', 1);
-       }
 }
 
 /**
  * Execute changes made in WordPress 2.7.
  *
  * @since 2.7.0
+ *
+ * @global wpdb $wpdb WordPress database abstraction object.
+ * @global int  $wp_current_db_version
  */
 function upgrade_270() {
        global $wpdb, $wp_current_db_version;
@@ -908,394 +1199,1087 @@ function upgrade_270() {
                $wpdb->query( "UPDATE $wpdb->posts SET post_date = post_modified WHERE post_date = '0000-00-00 00:00:00'" );
 }
 
-
-// The functions we use to actually do stuff
-
-// General
-
 /**
- * {@internal Missing Short Description}}
- *
- * {@internal Missing Long Description}}
+ * Execute changes made in WordPress 2.8.
  *
- * @since unknown
+ * @since 2.8.0
  *
- * @param string $table_name Database table name to create.
- * @param string $create_ddl SQL statement to create table.
- * @return bool If table already exists or was created by function.
+ * @global int  $wp_current_db_version
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
-function maybe_create_table($table_name, $create_ddl) {
-       global $wpdb;
-       foreach ($wpdb->get_col("SHOW TABLES",0) as $table ) {
-               if ($table == $table_name) {
-                       return true;
-               }
-       }
-       //didn't find it try to create it.
-       $q = $wpdb->query($create_ddl);
-       // we cannot directly tell that whether this succeeded!
-       foreach ($wpdb->get_col("SHOW TABLES",0) as $table ) {
-               if ($table == $table_name) {
-                       return true;
+function upgrade_280() {
+       global $wp_current_db_version, $wpdb;
+
+       if ( $wp_current_db_version < 10360 )
+               populate_roles_280();
+       if ( is_multisite() ) {
+               $start = 0;
+               while( $rows = $wpdb->get_results( "SELECT option_name, option_value FROM $wpdb->options ORDER BY option_id LIMIT $start, 20" ) ) {
+                       foreach ( $rows as $row ) {
+                               $value = $row->option_value;
+                               if ( !@unserialize( $value ) )
+                                       $value = stripslashes( $value );
+                               if ( $value !== $row->option_value ) {
+                                       update_option( $row->option_name, $value );
+                               }
+                       }
+                       $start += 20;
                }
+               refresh_blog_details( $wpdb->blogid );
        }
-       return false;
 }
 
 /**
- * {@internal Missing Short Description}}
- *
- * {@internal Missing Long Description}}
+ * Execute changes made in WordPress 2.9.
  *
- * @since unknown
+ * @since 2.9.0
  *
- * @param string $table Database table name.
- * @param string $index Index name to drop.
- * @return bool True, when finished.
+ * @global int $wp_current_db_version
  */
-function drop_index($table, $index) {
-       global $wpdb;
-       $wpdb->hide_errors();
-       $wpdb->query("ALTER TABLE `$table` DROP INDEX `$index`");
-       // Now we need to take out all the extra ones we may have created
-       for ($i = 0; $i < 25; $i++) {
-               $wpdb->query("ALTER TABLE `$table` DROP INDEX `{$index}_$i`");
+function upgrade_290() {
+       global $wp_current_db_version;
+
+       if ( $wp_current_db_version < 11958 ) {
+               // Previously, setting depth to 1 would redundantly disable threading, but now 2 is the minimum depth to avoid confusion
+               if ( get_option( 'thread_comments_depth' ) == '1' ) {
+                       update_option( 'thread_comments_depth', 2 );
+                       update_option( 'thread_comments', 0 );
+               }
        }
-       $wpdb->show_errors();
-       return true;
 }
 
 /**
- * {@internal Missing Short Description}}
- *
- * {@internal Missing Long Description}}
+ * Execute changes made in WordPress 3.0.
  *
- * @since unknown
+ * @since 3.0.0
  *
- * @param string $table Database table name.
- * @param string $index Database table index column.
- * @return bool True, when done with execution.
+ * @global int  $wp_current_db_version
+ * @global wpdb $wpdb WordPress database abstraction object.
  */
-function add_clean_index($table, $index) {
-       global $wpdb;
-       drop_index($table, $index);
-       $wpdb->query("ALTER TABLE `$table` ADD INDEX ( `$index` )");
-       return true;
-}
+function upgrade_300() {
+       global $wp_current_db_version, $wpdb;
 
-/**
- ** maybe_add_column()
- ** Add column to db table if it doesn't exist.
- ** Returns:  true if already exists or on successful completion
- **           false on error
- */
-function maybe_add_column($table_name, $column_name, $create_ddl) {
-       global $wpdb, $debug;
-       foreach ($wpdb->get_col("DESC $table_name", 0) as $column ) {
-               if ($debug) echo("checking $column == $column_name<br />");
-               if ($column == $column_name) {
-                       return true;
-               }
-       }
-       //didn't find it try to create it.
-       $q = $wpdb->query($create_ddl);
-       // we cannot directly tell that whether this succeeded!
-       foreach ($wpdb->get_col("DESC $table_name", 0) as $column ) {
-               if ($column == $column_name) {
-                       return true;
-               }
+       if ( $wp_current_db_version < 15093 )
+               populate_roles_300();
+
+       if ( $wp_current_db_version < 14139 && is_multisite() && is_main_site() && ! defined( 'MULTISITE' ) && get_site_option( 'siteurl' ) === false )
+               add_site_option( 'siteurl', '' );
+
+       // 3.0 screen options key name changes.
+       if ( wp_should_upgrade_global_tables() ) {
+               $sql = "DELETE FROM $wpdb->usermeta
+                       WHERE meta_key LIKE %s
+                       OR meta_key LIKE %s
+                       OR meta_key LIKE %s
+                       OR meta_key LIKE %s
+                       OR meta_key LIKE %s
+                       OR meta_key LIKE %s
+                       OR meta_key = 'manageedittagscolumnshidden'
+                       OR meta_key = 'managecategoriescolumnshidden'
+                       OR meta_key = 'manageedit-tagscolumnshidden'
+                       OR meta_key = 'manageeditcolumnshidden'
+                       OR meta_key = 'categories_per_page'
+                       OR meta_key = 'edit_tags_per_page'";
+               $prefix = $wpdb->esc_like( $wpdb->base_prefix );
+               $wpdb->query( $wpdb->prepare( $sql,
+                       $prefix . '%' . $wpdb->esc_like( 'meta-box-hidden' ) . '%',
+                       $prefix . '%' . $wpdb->esc_like( 'closedpostboxes' ) . '%',
+                       $prefix . '%' . $wpdb->esc_like( 'manage-'         ) . '%' . $wpdb->esc_like( '-columns-hidden' ) . '%',
+                       $prefix . '%' . $wpdb->esc_like( 'meta-box-order'  ) . '%',
+                       $prefix . '%' . $wpdb->esc_like( 'metaboxorder'    ) . '%',
+                       $prefix . '%' . $wpdb->esc_like( 'screen_layout'   ) . '%'
+               ) );
        }
-       return false;
+
 }
 
 /**
- * Retrieve all options as it was for 1.2.
+ * Execute changes made in WordPress 3.3.
  *
- * @since 1.2.0
+ * @since 3.3.0
  *
- * @return array List of options.
+ * @global int   $wp_current_db_version
+ * @global wpdb  $wpdb
+ * @global array $wp_registered_widgets
+ * @global array $sidebars_widgets
  */
-function get_alloptions_110() {
-       global $wpdb;
-       if ($options = $wpdb->get_results("SELECT option_name, option_value FROM $wpdb->options")) {
-               foreach ($options as $option) {
-                       // "When trying to design a foolproof system,
-                       //  never underestimate the ingenuity of the fools :)" -- Dougal
-                       if ('siteurl' == $option->option_name) $option->option_value = preg_replace('|/+$|', '', $option->option_value);
-                       if ('home' == $option->option_name) $option->option_value = preg_replace('|/+$|', '', $option->option_value);
-                       if ('category_base' == $option->option_name) $option->option_value = preg_replace('|/+$|', '', $option->option_value);
-                       $all_options->{$option->option_name} = stripslashes($option->option_value);
-               }
+function upgrade_330() {
+       global $wp_current_db_version, $wpdb, $wp_registered_widgets, $sidebars_widgets;
+
+       if ( $wp_current_db_version < 19061 && wp_should_upgrade_global_tables() ) {
+               $wpdb->query( "DELETE FROM $wpdb->usermeta WHERE meta_key IN ('show_admin_bar_admin', 'plugins_last_view')" );
+       }
+
+       if ( $wp_current_db_version >= 11548 )
+               return;
+
+       $sidebars_widgets = get_option( 'sidebars_widgets', array() );
+       $_sidebars_widgets = array();
+
+       if ( isset($sidebars_widgets['wp_inactive_widgets']) || empty($sidebars_widgets) )
+               $sidebars_widgets['array_version'] = 3;
+       elseif ( !isset($sidebars_widgets['array_version']) )
+               $sidebars_widgets['array_version'] = 1;
+
+       switch ( $sidebars_widgets['array_version'] ) {
+               case 1 :
+                       foreach ( (array) $sidebars_widgets as $index => $sidebar )
+                       if ( is_array($sidebar) )
+                       foreach ( (array) $sidebar as $i => $name ) {
+                               $id = strtolower($name);
+                               if ( isset($wp_registered_widgets[$id]) ) {
+                                       $_sidebars_widgets[$index][$i] = $id;
+                                       continue;
+                               }
+                               $id = sanitize_title($name);
+                               if ( isset($wp_registered_widgets[$id]) ) {
+                                       $_sidebars_widgets[$index][$i] = $id;
+                                       continue;
+                               }
+
+                               $found = false;
+
+                               foreach ( $wp_registered_widgets as $widget_id => $widget ) {
+                                       if ( strtolower($widget['name']) == strtolower($name) ) {
+                                               $_sidebars_widgets[$index][$i] = $widget['id'];
+                                               $found = true;
+                                               break;
+                                       } elseif ( sanitize_title($widget['name']) == sanitize_title($name) ) {
+                                               $_sidebars_widgets[$index][$i] = $widget['id'];
+                                               $found = true;
+                                               break;
+                                       }
+                               }
+
+                               if ( $found )
+                                       continue;
+
+                               unset($_sidebars_widgets[$index][$i]);
+                       }
+                       $_sidebars_widgets['array_version'] = 2;
+                       $sidebars_widgets = $_sidebars_widgets;
+                       unset($_sidebars_widgets);
+
+               case 2 :
+                       $sidebars_widgets = retrieve_widgets();
+                       $sidebars_widgets['array_version'] = 3;
+                       update_option( 'sidebars_widgets', $sidebars_widgets );
        }
-       return $all_options;
 }
 
 /**
- * Version of get_option that is private to install/upgrade.
+ * Execute changes made in WordPress 3.4.
  *
- * @since unknown
- * @access private
+ * @since 3.4.0
  *
- * @param string $setting Option name.
- * @return mixed
+ * @global int   $wp_current_db_version
+ * @global wpdb  $wpdb
  */
-function __get_option($setting) {
-       global $wpdb;
+function upgrade_340() {
+       global $wp_current_db_version, $wpdb;
 
-       if ( $setting == 'home' && defined( 'WP_HOME' ) ) {
-               return preg_replace( '|/+$|', '', constant( 'WP_HOME' ) );
+       if ( $wp_current_db_version < 19798 ) {
+               $wpdb->hide_errors();
+               $wpdb->query( "ALTER TABLE $wpdb->options DROP COLUMN blog_id" );
+               $wpdb->show_errors();
        }
 
-       if ( $setting == 'siteurl' && defined( 'WP_SITEURL' ) ) {
-               return preg_replace( '|/+$|', '', constant( 'WP_SITEURL' ) );
+       if ( $wp_current_db_version < 19799 ) {
+               $wpdb->hide_errors();
+               $wpdb->query("ALTER TABLE $wpdb->comments DROP INDEX comment_approved");
+               $wpdb->show_errors();
        }
 
-       $option = $wpdb->get_var( $wpdb->prepare("SELECT option_value FROM $wpdb->options WHERE option_name = %s", $setting) );
-
-       if ( 'home' == $setting && '' == $option )
-               return __get_option('siteurl');
-
-       if ( 'siteurl' == $setting || 'home' == $setting || 'category_base' == $setting )
-               $option = preg_replace('|/+$|', '', $option);
+       if ( $wp_current_db_version < 20022 && wp_should_upgrade_global_tables() ) {
+               $wpdb->query( "DELETE FROM $wpdb->usermeta WHERE meta_key = 'themes_last_view'" );
+       }
 
-       @ $kellogs = unserialize($option);
-       if ($kellogs !== FALSE)
-               return $kellogs;
-       else
-               return $option;
+       if ( $wp_current_db_version < 20080 ) {
+               if ( 'yes' == $wpdb->get_var( "SELECT autoload FROM $wpdb->options WHERE option_name = 'uninstall_plugins'" ) ) {
+                       $uninstall_plugins = get_option( 'uninstall_plugins' );
+                       delete_option( 'uninstall_plugins' );
+                       add_option( 'uninstall_plugins', $uninstall_plugins, null, 'no' );
+               }
+       }
 }
 
 /**
- * {@internal Missing Short Description}}
- *
- * {@internal Missing Long Description}}
+ * Execute changes made in WordPress 3.5.
  *
- * @since unknown
+ * @since 3.5.0
  *
- * @param string $content
- * @return string
+ * @global int   $wp_current_db_version
+ * @global wpdb  $wpdb
  */
-function deslash($content) {
-       // Note: \\\ inside a regex denotes a single backslash.
-
-       // Replace one or more backslashes followed by a single quote with
-       // a single quote.
-       $content = preg_replace("/\\\+'/", "'", $content);
+function upgrade_350() {
+       global $wp_current_db_version, $wpdb;
 
-       // Replace one or more backslashes followed by a double quote with
-       // a double quote.
-       $content = preg_replace('/\\\+"/', '"', $content);
+       if ( $wp_current_db_version < 22006 && $wpdb->get_var( "SELECT link_id FROM $wpdb->links LIMIT 1" ) )
+               update_option( 'link_manager_enabled', 1 ); // Previously set to 0 by populate_options()
 
-       // Replace one or more backslashes with one backslash.
-       $content = preg_replace("/\\\+/", "\\", $content);
+       if ( $wp_current_db_version < 21811 && wp_should_upgrade_global_tables() ) {
+               $meta_keys = array();
+               foreach ( array_merge( get_post_types(), get_taxonomies() ) as $name ) {
+                       if ( false !== strpos( $name, '-' ) )
+                       $meta_keys[] = 'edit_' . str_replace( '-', '_', $name ) . '_per_page';
+               }
+               if ( $meta_keys ) {
+                       $meta_keys = implode( "', '", $meta_keys );
+                       $wpdb->query( "DELETE FROM $wpdb->usermeta WHERE meta_key IN ('$meta_keys')" );
+               }
+       }
 
-       return $content;
+       if ( $wp_current_db_version < 22422 && $term = get_term_by( 'slug', 'post-format-standard', 'post_format' ) )
+               wp_delete_term( $term->term_id, 'post_format' );
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Execute changes made in WordPress 3.7.
  *
- * {@internal Missing Long Description}}
+ * @since 3.7.0
+ *
+ * @global int $wp_current_db_version
+ */
+function upgrade_370() {
+       global $wp_current_db_version;
+       if ( $wp_current_db_version < 25824 )
+               wp_clear_scheduled_hook( 'wp_auto_updates_maybe_update' );
+}
+
+/**
+ * Execute changes made in WordPress 3.7.2.
  *
- * @since unknown
+ * @since 3.7.2
+ * @since 3.8.0
  *
- * @param unknown_type $queries
- * @param unknown_type $execute
- * @return unknown
+ * @global int $wp_current_db_version
  */
-function dbDelta($queries, $execute = true) {
-       global $wpdb;
+function upgrade_372() {
+       global $wp_current_db_version;
+       if ( $wp_current_db_version < 26148 )
+               wp_clear_scheduled_hook( 'wp_maybe_auto_update' );
+}
 
-       // Separate individual queries into an array
-       if( !is_array($queries) ) {
-               $queries = explode( ';', $queries );
-               if('' == $queries[count($queries) - 1]) array_pop($queries);
+/**
+ * Execute changes made in WordPress 3.8.0.
+ *
+ * @since 3.8.0
+ *
+ * @global int $wp_current_db_version
+ */
+function upgrade_380() {
+       global $wp_current_db_version;
+       if ( $wp_current_db_version < 26691 ) {
+               deactivate_plugins( array( 'mp6/mp6.php' ), true );
        }
+}
 
-       $cqueries = array(); // Creation Queries
-       $iqueries = array(); // Insertion Queries
-       $for_update = array();
-
-       // Create a tablename index for an array ($cqueries) of queries
-       foreach($queries as $qry) {
-               if(preg_match("|CREATE TABLE ([^ ]*)|", $qry, $matches)) {
-                       $cqueries[strtolower($matches[1])] = $qry;
-                       $for_update[$matches[1]] = 'Created table '.$matches[1];
-               }
-               else if(preg_match("|CREATE DATABASE ([^ ]*)|", $qry, $matches)) {
-                       array_unshift($cqueries, $qry);
+/**
+ * Execute changes made in WordPress 4.0.0.
+ *
+ * @since 4.0.0
+ *
+ * @global int $wp_current_db_version
+ */
+function upgrade_400() {
+       global $wp_current_db_version;
+       if ( $wp_current_db_version < 29630 ) {
+               if ( ! is_multisite() && false === get_option( 'WPLANG' ) ) {
+                       if ( defined( 'WPLANG' ) && ( '' !== WPLANG ) && in_array( WPLANG, get_available_languages() ) ) {
+                               update_option( 'WPLANG', WPLANG );
+                       } else {
+                               update_option( 'WPLANG', '' );
+                       }
                }
-               else if(preg_match("|INSERT INTO ([^ ]*)|", $qry, $matches)) {
-                       $iqueries[] = $qry;
+       }
+}
+
+/**
+ * Execute changes made in WordPress 4.2.0.
+ *
+ * @since 4.2.0
+ *
+ * @global int   $wp_current_db_version
+ * @global wpdb  $wpdb
+ */
+function upgrade_420() {}
+
+/**
+ * Executes changes made in WordPress 4.3.0.
+ *
+ * @since 4.3.0
+ *
+ * @global int  $wp_current_db_version Current version.
+ * @global wpdb $wpdb                  WordPress database abstraction object.
+ */
+function upgrade_430() {
+       global $wp_current_db_version, $wpdb;
+
+       if ( $wp_current_db_version < 32364 ) {
+               upgrade_430_fix_comments();
+       }
+
+       // Shared terms are split in a separate process.
+       if ( $wp_current_db_version < 32814 ) {
+               update_option( 'finished_splitting_shared_terms', 0 );
+               wp_schedule_single_event( time() + ( 1 * MINUTE_IN_SECONDS ), 'wp_split_shared_term_batch' );
+       }
+
+       if ( $wp_current_db_version < 33055 && 'utf8mb4' === $wpdb->charset ) {
+               if ( is_multisite() ) {
+                       $tables = $wpdb->tables( 'blog' );
+               } else {
+                       $tables = $wpdb->tables( 'all' );
+                       if ( ! wp_should_upgrade_global_tables() ) {
+                               $global_tables = $wpdb->tables( 'global' );
+                               $tables = array_diff_assoc( $tables, $global_tables );
+                       }
                }
-               else if(preg_match("|UPDATE ([^ ]*)|", $qry, $matches)) {
-                       $iqueries[] = $qry;
+
+               foreach ( $tables as $table ) {
+                       maybe_convert_table_to_utf8mb4( $table );
+               }
+       }
+}
+
+/**
+ * Executes comments changes made in WordPress 4.3.0.
+ *
+ * @since 4.3.0
+ *
+ * @global int  $wp_current_db_version Current version.
+ * @global wpdb $wpdb                  WordPress database abstraction object.
+ */
+function upgrade_430_fix_comments() {
+       global $wp_current_db_version, $wpdb;
+
+       $content_length = $wpdb->get_col_length( $wpdb->comments, 'comment_content' );
+
+       if ( is_wp_error( $content_length ) ) {
+               return;
+       }
+
+       if ( false === $content_length ) {
+               $content_length = array(
+                       'type'   => 'byte',
+                       'length' => 65535,
+               );
+       } elseif ( ! is_array( $content_length ) ) {
+               $length = (int) $content_length > 0 ? (int) $content_length : 65535;
+               $content_length = array(
+                       'type'   => 'byte',
+                       'length' => $length
+               );
+       }
+
+       if ( 'byte' !== $content_length['type'] || 0 === $content_length['length'] ) {
+               // Sites with malformed DB schemas are on their own.
+               return;
+       }
+
+       $allowed_length = intval( $content_length['length'] ) - 10;
+
+       $comments = $wpdb->get_results(
+               "SELECT `comment_ID` FROM `{$wpdb->comments}`
+                       WHERE `comment_date_gmt` > '2015-04-26'
+                       AND LENGTH( `comment_content` ) >= {$allowed_length}
+                       AND ( `comment_content` LIKE '%<%' OR `comment_content` LIKE '%>%' )"
+       );
+
+       foreach ( $comments as $comment ) {
+               wp_delete_comment( $comment->comment_ID, true );
+       }
+}
+
+/**
+ * Executes changes made in WordPress 4.3.1.
+ *
+ * @since 4.3.1
+ */
+function upgrade_431() {
+       // Fix incorrect cron entries for term splitting
+       $cron_array = _get_cron_array();
+       if ( isset( $cron_array['wp_batch_split_terms'] ) ) {
+               unset( $cron_array['wp_batch_split_terms'] );
+               _set_cron_array( $cron_array );
+       }
+}
+
+/**
+ * Executes changes made in WordPress 4.4.0.
+ *
+ * @since 4.4.0
+ *
+ * @global int  $wp_current_db_version Current version.
+ * @global wpdb $wpdb                  WordPress database abstraction object.
+ */
+function upgrade_440() {
+       global $wp_current_db_version, $wpdb;
+
+       if ( $wp_current_db_version < 34030 ) {
+               $wpdb->query( "ALTER TABLE {$wpdb->options} MODIFY option_name VARCHAR(191)" );
+       }
+
+       // Remove the unused 'add_users' role.
+       $roles = wp_roles();
+       foreach ( $roles->role_objects as $role ) {
+               if ( $role->has_cap( 'add_users' ) ) {
+                       $role->remove_cap( 'add_users' );
+               }
+       }
+}
+
+/**
+ * Executes network-level upgrade routines.
+ *
+ * @since 3.0.0
+ *
+ * @global int   $wp_current_db_version
+ * @global wpdb  $wpdb
+ */
+function upgrade_network() {
+       global $wp_current_db_version, $wpdb;
+
+       // Always.
+       if ( is_main_network() ) {
+               /*
+                * Deletes all expired transients. The multi-table delete syntax is used
+                * to delete the transient record from table a, and the corresponding
+                * transient_timeout record from table b.
+                */
+               $time = time();
+               $sql = "DELETE a, b FROM $wpdb->sitemeta a, $wpdb->sitemeta b
+                       WHERE a.meta_key LIKE %s
+                       AND a.meta_key NOT LIKE %s
+                       AND b.meta_key = CONCAT( '_site_transient_timeout_', SUBSTRING( a.meta_key, 17 ) )
+                       AND b.meta_value < %d";
+               $wpdb->query( $wpdb->prepare( $sql, $wpdb->esc_like( '_site_transient_' ) . '%', $wpdb->esc_like ( '_site_transient_timeout_' ) . '%', $time ) );
+       }
+
+       // 2.8.
+       if ( $wp_current_db_version < 11549 ) {
+               $wpmu_sitewide_plugins = get_site_option( 'wpmu_sitewide_plugins' );
+               $active_sitewide_plugins = get_site_option( 'active_sitewide_plugins' );
+               if ( $wpmu_sitewide_plugins ) {
+                       if ( !$active_sitewide_plugins )
+                               $sitewide_plugins = (array) $wpmu_sitewide_plugins;
+                       else
+                               $sitewide_plugins = array_merge( (array) $active_sitewide_plugins, (array) $wpmu_sitewide_plugins );
+
+                       update_site_option( 'active_sitewide_plugins', $sitewide_plugins );
+               }
+               delete_site_option( 'wpmu_sitewide_plugins' );
+               delete_site_option( 'deactivated_sitewide_plugins' );
+
+               $start = 0;
+               while( $rows = $wpdb->get_results( "SELECT meta_key, meta_value FROM {$wpdb->sitemeta} ORDER BY meta_id LIMIT $start, 20" ) ) {
+                       foreach ( $rows as $row ) {
+                               $value = $row->meta_value;
+                               if ( !@unserialize( $value ) )
+                                       $value = stripslashes( $value );
+                               if ( $value !== $row->meta_value ) {
+                                       update_site_option( $row->meta_key, $value );
+                               }
+                       }
+                       $start += 20;
+               }
+       }
+
+       // 3.0
+       if ( $wp_current_db_version < 13576 )
+               update_site_option( 'global_terms_enabled', '1' );
+
+       // 3.3
+       if ( $wp_current_db_version < 19390 )
+               update_site_option( 'initial_db_version', $wp_current_db_version );
+
+       if ( $wp_current_db_version < 19470 ) {
+               if ( false === get_site_option( 'active_sitewide_plugins' ) )
+                       update_site_option( 'active_sitewide_plugins', array() );
+       }
+
+       // 3.4
+       if ( $wp_current_db_version < 20148 ) {
+               // 'allowedthemes' keys things by stylesheet. 'allowed_themes' keyed things by name.
+               $allowedthemes  = get_site_option( 'allowedthemes'  );
+               $allowed_themes = get_site_option( 'allowed_themes' );
+               if ( false === $allowedthemes && is_array( $allowed_themes ) && $allowed_themes ) {
+                       $converted = array();
+                       $themes = wp_get_themes();
+                       foreach ( $themes as $stylesheet => $theme_data ) {
+                               if ( isset( $allowed_themes[ $theme_data->get('Name') ] ) )
+                                       $converted[ $stylesheet ] = true;
+                       }
+                       update_site_option( 'allowedthemes', $converted );
+                       delete_site_option( 'allowed_themes' );
+               }
+       }
+
+       // 3.5
+       if ( $wp_current_db_version < 21823 )
+               update_site_option( 'ms_files_rewriting', '1' );
+
+       // 3.5.2
+       if ( $wp_current_db_version < 24448 ) {
+               $illegal_names = get_site_option( 'illegal_names' );
+               if ( is_array( $illegal_names ) && count( $illegal_names ) === 1 ) {
+                       $illegal_name = reset( $illegal_names );
+                       $illegal_names = explode( ' ', $illegal_name );
+                       update_site_option( 'illegal_names', $illegal_names );
+               }
+       }
+
+       // 4.2
+       if ( $wp_current_db_version < 31351 && $wpdb->charset === 'utf8mb4' ) {
+               if ( wp_should_upgrade_global_tables() ) {
+                       $wpdb->query( "ALTER TABLE $wpdb->usermeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
+                       $wpdb->query( "ALTER TABLE $wpdb->site DROP INDEX domain, ADD INDEX domain(domain(140),path(51))" );
+                       $wpdb->query( "ALTER TABLE $wpdb->sitemeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
+                       $wpdb->query( "ALTER TABLE $wpdb->signups DROP INDEX domain_path, ADD INDEX domain_path(domain(140),path(51))" );
+
+                       $tables = $wpdb->tables( 'global' );
+
+                       // sitecategories may not exist.
+                       if ( ! $wpdb->get_var( "SHOW TABLES LIKE '{$tables['sitecategories']}'" ) ) {
+                               unset( $tables['sitecategories'] );
+                       }
+
+                       foreach ( $tables as $table ) {
+                               maybe_convert_table_to_utf8mb4( $table );
+                       }
+               }
+       }
+
+       // 4.3
+       if ( $wp_current_db_version < 33055 && 'utf8mb4' === $wpdb->charset ) {
+               if ( wp_should_upgrade_global_tables() ) {
+                       $upgrade = false;
+                       $indexes = $wpdb->get_results( "SHOW INDEXES FROM $wpdb->signups" );
+                       foreach ( $indexes as $index ) {
+                               if ( 'domain_path' == $index->Key_name && 'domain' == $index->Column_name && 140 != $index->Sub_part ) {
+                                       $upgrade = true;
+                                       break;
+                               }
+                       }
+
+                       if ( $upgrade ) {
+                               $wpdb->query( "ALTER TABLE $wpdb->signups DROP INDEX domain_path, ADD INDEX domain_path(domain(140),path(51))" );
+                       }
+
+                       $tables = $wpdb->tables( 'global' );
+
+                       // sitecategories may not exist.
+                       if ( ! $wpdb->get_var( "SHOW TABLES LIKE '{$tables['sitecategories']}'" ) ) {
+                               unset( $tables['sitecategories'] );
+                       }
+
+                       foreach ( $tables as $table ) {
+                               maybe_convert_table_to_utf8mb4( $table );
+                       }
+               }
+       }
+}
+
+//
+// General functions we use to actually do stuff
+//
+
+/**
+ * Creates a table in the database if it doesn't already exist.
+ *
+ * This method checks for an existing database and creates a new one if it's not
+ * already present. It doesn't rely on MySQL's "IF NOT EXISTS" statement, but chooses
+ * to query all tables first and then run the SQL statement creating the table.
+ *
+ * @since 1.0.0
+ *
+ * @global wpdb  $wpdb
+ *
+ * @param string $table_name Database table name to create.
+ * @param string $create_ddl SQL statement to create table.
+ * @return bool If table already exists or was created by function.
+ */
+function maybe_create_table($table_name, $create_ddl) {
+       global $wpdb;
+
+       $query = $wpdb->prepare( "SHOW TABLES LIKE %s", $wpdb->esc_like( $table_name ) );
+
+       if ( $wpdb->get_var( $query ) == $table_name ) {
+               return true;
+       }
+
+       // Didn't find it try to create it..
+       $wpdb->query($create_ddl);
+
+       // We cannot directly tell that whether this succeeded!
+       if ( $wpdb->get_var( $query ) == $table_name ) {
+               return true;
+       }
+       return false;
+}
+
+/**
+ * Drops a specified index from a table.
+ *
+ * @since 1.0.1
+ *
+ * @global wpdb  $wpdb
+ *
+ * @param string $table Database table name.
+ * @param string $index Index name to drop.
+ * @return true True, when finished.
+ */
+function drop_index($table, $index) {
+       global $wpdb;
+       $wpdb->hide_errors();
+       $wpdb->query("ALTER TABLE `$table` DROP INDEX `$index`");
+       // Now we need to take out all the extra ones we may have created
+       for ($i = 0; $i < 25; $i++) {
+               $wpdb->query("ALTER TABLE `$table` DROP INDEX `{$index}_$i`");
+       }
+       $wpdb->show_errors();
+       return true;
+}
+
+/**
+ * Adds an index to a specified table.
+ *
+ * @since 1.0.1
+ *
+ * @global wpdb  $wpdb
+ *
+ * @param string $table Database table name.
+ * @param string $index Database table index column.
+ * @return true True, when done with execution.
+ */
+function add_clean_index($table, $index) {
+       global $wpdb;
+       drop_index($table, $index);
+       $wpdb->query("ALTER TABLE `$table` ADD INDEX ( `$index` )");
+       return true;
+}
+
+/**
+ * Adds column to a database table if it doesn't already exist.
+ *
+ * @since 1.3.0
+ *
+ * @global wpdb  $wpdb
+ *
+ * @param string $table_name  The table name to modify.
+ * @param string $column_name The column name to add to the table.
+ * @param string $create_ddl  The SQL statement used to add the column.
+ * @return bool True if already exists or on successful completion, false on error.
+ */
+function maybe_add_column($table_name, $column_name, $create_ddl) {
+       global $wpdb;
+       foreach ($wpdb->get_col("DESC $table_name", 0) as $column ) {
+               if ($column == $column_name) {
+                       return true;
+               }
+       }
+
+       // Didn't find it try to create it.
+       $wpdb->query($create_ddl);
+
+       // We cannot directly tell that whether this succeeded!
+       foreach ($wpdb->get_col("DESC $table_name", 0) as $column ) {
+               if ($column == $column_name) {
+                       return true;
+               }
+       }
+       return false;
+}
+
+/**
+ * If a table only contains utf8 or utf8mb4 columns, convert it to utf8mb4.
+ *
+ * @since 4.2.0
+ *
+ * @global wpdb  $wpdb
+ *
+ * @param string $table The table to convert.
+ * @return bool true if the table was converted, false if it wasn't.
+ */
+function maybe_convert_table_to_utf8mb4( $table ) {
+       global $wpdb;
+
+       $results = $wpdb->get_results( "SHOW FULL COLUMNS FROM `$table`" );
+       if ( ! $results ) {
+               return false;
+       }
+
+       foreach ( $results as $column ) {
+               if ( $column->Collation ) {
+                       list( $charset ) = explode( '_', $column->Collation );
+                       $charset = strtolower( $charset );
+                       if ( 'utf8' !== $charset && 'utf8mb4' !== $charset ) {
+                               // Don't upgrade tables that have non-utf8 columns.
+                               return false;
+                       }
                }
-               else {
+       }
+
+       $table_details = $wpdb->get_row( "SHOW TABLE STATUS LIKE '$table'" );
+       if ( ! $table_details ) {
+               return false;
+       }
+
+       list( $table_charset ) = explode( '_', $table_details->Collation );
+       $table_charset = strtolower( $table_charset );
+       if ( 'utf8mb4' === $table_charset ) {
+               return true;
+       }
+
+       return $wpdb->query( "ALTER TABLE $table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci" );
+}
+
+/**
+ * Retrieve all options as it was for 1.2.
+ *
+ * @since 1.2.0
+ *
+ * @global wpdb  $wpdb
+ *
+ * @return stdClass List of options.
+ */
+function get_alloptions_110() {
+       global $wpdb;
+       $all_options = new stdClass;
+       if ( $options = $wpdb->get_results( "SELECT option_name, option_value FROM $wpdb->options" ) ) {
+               foreach ( $options as $option ) {
+                       if ( 'siteurl' == $option->option_name || 'home' == $option->option_name || 'category_base' == $option->option_name )
+                               $option->option_value = untrailingslashit( $option->option_value );
+                       $all_options->{$option->option_name} = stripslashes( $option->option_value );
+               }
+       }
+       return $all_options;
+}
+
+/**
+ * Utility version of get_option that is private to install/upgrade.
+ *
+ * @ignore
+ * @since 1.5.1
+ * @access private
+ *
+ * @global wpdb  $wpdb
+ *
+ * @param string $setting Option name.
+ * @return mixed
+ */
+function __get_option($setting) {
+       global $wpdb;
+
+       if ( $setting == 'home' && defined( 'WP_HOME' ) )
+               return untrailingslashit( WP_HOME );
+
+       if ( $setting == 'siteurl' && defined( 'WP_SITEURL' ) )
+               return untrailingslashit( WP_SITEURL );
+
+       $option = $wpdb->get_var( $wpdb->prepare("SELECT option_value FROM $wpdb->options WHERE option_name = %s", $setting ) );
+
+       if ( 'home' == $setting && '' == $option )
+               return __get_option( 'siteurl' );
+
+       if ( 'siteurl' == $setting || 'home' == $setting || 'category_base' == $setting || 'tag_base' == $setting )
+               $option = untrailingslashit( $option );
+
+       return maybe_unserialize( $option );
+}
+
+/**
+ * Filters for content to remove unnecessary slashes.
+ *
+ * @since 1.5.0
+ *
+ * @param string $content The content to modify.
+ * @return string The de-slashed content.
+ */
+function deslash($content) {
+       // Note: \\\ inside a regex denotes a single backslash.
+
+       /*
+        * Replace one or more backslashes followed by a single quote with
+        * a single quote.
+        */
+       $content = preg_replace("/\\\+'/", "'", $content);
+
+       /*
+        * Replace one or more backslashes followed by a double quote with
+        * a double quote.
+        */
+       $content = preg_replace('/\\\+"/', '"', $content);
+
+       // Replace one or more backslashes with one backslash.
+       $content = preg_replace("/\\\+/", "\\", $content);
+
+       return $content;
+}
+
+/**
+ * Modifies the database based on specified SQL statements.
+ *
+ * Useful for creating new tables and updating existing tables to a new structure.
+ *
+ * @since 1.5.0
+ *
+ * @global wpdb  $wpdb
+ *
+ * @param string|array $queries Optional. The query to run. Can be multiple queries
+ *                              in an array, or a string of queries separated by
+ *                              semicolons. Default empty.
+ * @param bool         $execute Optional. Whether or not to execute the query right away.
+ *                              Default true.
+ * @return array Strings containing the results of the various update queries.
+ */
+function dbDelta( $queries = '', $execute = true ) {
+       global $wpdb;
+
+       if ( in_array( $queries, array( '', 'all', 'blog', 'global', 'ms_global' ), true ) )
+           $queries = wp_get_db_schema( $queries );
+
+       // Separate individual queries into an array
+       if ( !is_array($queries) ) {
+               $queries = explode( ';', $queries );
+               $queries = array_filter( $queries );
+       }
+
+       /**
+        * Filter the dbDelta SQL queries.
+        *
+        * @since 3.3.0
+        *
+        * @param array $queries An array of dbDelta SQL queries.
+        */
+       $queries = apply_filters( 'dbdelta_queries', $queries );
+
+       $cqueries = array(); // Creation Queries
+       $iqueries = array(); // Insertion Queries
+       $for_update = array();
+
+       // Create a tablename index for an array ($cqueries) of queries
+       foreach ($queries as $qry) {
+               if ( preg_match( "|CREATE TABLE ([^ ]*)|", $qry, $matches ) ) {
+                       $cqueries[ trim( $matches[1], '`' ) ] = $qry;
+                       $for_update[$matches[1]] = 'Created table '.$matches[1];
+               } elseif ( preg_match( "|CREATE DATABASE ([^ ]*)|", $qry, $matches ) ) {
+                       array_unshift( $cqueries, $qry );
+               } elseif ( preg_match( "|INSERT INTO ([^ ]*)|", $qry, $matches ) ) {
+                       $iqueries[] = $qry;
+               } elseif ( preg_match( "|UPDATE ([^ ]*)|", $qry, $matches ) ) {
+                       $iqueries[] = $qry;
+               } else {
                        // Unrecognized query type
                }
        }
 
-       // Check to see which tables and fields exist
-       if($tables = $wpdb->get_col('SHOW TABLES;')) {
-               // For every table in the database
-               foreach($tables as $table) {
-                       // If a table query exists for the database table...
-                       if( array_key_exists(strtolower($table), $cqueries) ) {
-                               // Clear the field and index arrays
-                               unset($cfields);
-                               unset($indices);
-                               // Get all of the field names in the query from between the parens
-                               preg_match("|\((.*)\)|ms", $cqueries[strtolower($table)], $match2);
-                               $qryline = trim($match2[1]);
-
-                               // Separate field lines into an array
-                               $flds = explode("\n", $qryline);
-
-                               //echo "<hr/><pre>\n".print_r(strtolower($table), true).":\n".print_r($cqueries, true)."</pre><hr/>";
-
-                               // For every field line specified in the query
-                               foreach($flds as $fld) {
-                                       // Extract the field name
-                                       preg_match("|^([^ ]*)|", trim($fld), $fvals);
-                                       $fieldname = $fvals[1];
-
-                                       // Verify the found field name
-                                       $validfield = true;
-                                       switch(strtolower($fieldname))
-                                       {
-                                       case '':
-                                       case 'primary':
-                                       case 'index':
-                                       case 'fulltext':
-                                       case 'unique':
-                                       case 'key':
-                                               $validfield = false;
-                                               $indices[] = trim(trim($fld), ", \n");
-                                               break;
-                                       }
-                                       $fld = trim($fld);
+       /**
+        * Filter the dbDelta SQL queries for creating tables and/or databases.
+        *
+        * Queries filterable via this hook contain "CREATE TABLE" or "CREATE DATABASE".
+        *
+        * @since 3.3.0
+        *
+        * @param array $cqueries An array of dbDelta create SQL queries.
+        */
+       $cqueries = apply_filters( 'dbdelta_create_queries', $cqueries );
+
+       /**
+        * Filter the dbDelta SQL queries for inserting or updating.
+        *
+        * Queries filterable via this hook contain "INSERT INTO" or "UPDATE".
+        *
+        * @since 3.3.0
+        *
+        * @param array $iqueries An array of dbDelta insert or update SQL queries.
+        */
+       $iqueries = apply_filters( 'dbdelta_insert_queries', $iqueries );
+
+       $global_tables = $wpdb->tables( 'global' );
+       foreach ( $cqueries as $table => $qry ) {
+               // Upgrade global tables only for the main site. Don't upgrade at all if conditions are not optimal.
+               if ( in_array( $table, $global_tables ) && ! wp_should_upgrade_global_tables() ) {
+                       unset( $cqueries[ $table ], $for_update[ $table ] );
+                       continue;
+               }
 
-                                       // If it's a valid field, add it to the field array
-                                       if($validfield) {
-                                               $cfields[strtolower($fieldname)] = trim($fld, ", \n");
-                                       }
+               // Fetch the table column structure from the database
+               $suppress = $wpdb->suppress_errors();
+               $tablefields = $wpdb->get_results("DESCRIBE {$table};");
+               $wpdb->suppress_errors( $suppress );
+
+               if ( ! $tablefields )
+                       continue;
+
+               // Clear the field and index arrays.
+               $cfields = $indices = array();
+
+               // Get all of the field names in the query from between the parentheses.
+               preg_match("|\((.*)\)|ms", $qry, $match2);
+               $qryline = trim($match2[1]);
+
+               // Separate field lines into an array.
+               $flds = explode("\n", $qryline);
+
+               // todo: Remove this?
+               //echo "<hr/><pre>\n".print_r(strtolower($table), true).":\n".print_r($cqueries, true)."</pre><hr/>";
+
+               // For every field line specified in the query.
+               foreach ($flds as $fld) {
+
+                       // Extract the field name.
+                       preg_match("|^([^ ]*)|", trim($fld), $fvals);
+                       $fieldname = trim( $fvals[1], '`' );
+
+                       // Verify the found field name.
+                       $validfield = true;
+                       switch (strtolower($fieldname)) {
+                       case '':
+                       case 'primary':
+                       case 'index':
+                       case 'fulltext':
+                       case 'unique':
+                       case 'key':
+                               $validfield = false;
+                               $indices[] = trim(trim($fld), ", \n");
+                               break;
+                       }
+                       $fld = trim($fld);
+
+                       // If it's a valid field, add it to the field array.
+                       if ($validfield) {
+                               $cfields[strtolower($fieldname)] = trim($fld, ", \n");
+                       }
+               }
+
+               // For every field in the table.
+               foreach ($tablefields as $tablefield) {
+
+                       // If the table field exists in the field array ...
+                       if (array_key_exists(strtolower($tablefield->Field), $cfields)) {
+
+                               // Get the field type from the query.
+                               preg_match("|".$tablefield->Field." ([^ ]*( unsigned)?)|i", $cfields[strtolower($tablefield->Field)], $matches);
+                               $fieldtype = $matches[1];
+
+                               // Is actual field type different from the field type in query?
+                               if ($tablefield->Type != $fieldtype) {
+                                       // Add a query to change the column type
+                                       $cqueries[] = "ALTER TABLE {$table} CHANGE COLUMN {$tablefield->Field} " . $cfields[strtolower($tablefield->Field)];
+                                       $for_update[$table.'.'.$tablefield->Field] = "Changed type of {$table}.{$tablefield->Field} from {$tablefield->Type} to {$fieldtype}";
                                }
 
-                               // Fetch the table column structure from the database
-                               $tablefields = $wpdb->get_results("DESCRIBE {$table};");
-
-                               // For every field in the table
-                               foreach($tablefields as $tablefield) {
-                                       // If the table field exists in the field array...
-                                       if(array_key_exists(strtolower($tablefield->Field), $cfields)) {
-                                               // Get the field type from the query
-                                               preg_match("|".$tablefield->Field." ([^ ]*( unsigned)?)|i", $cfields[strtolower($tablefield->Field)], $matches);
-                                               $fieldtype = $matches[1];
-
-                                               // Is actual field type different from the field type in query?
-                                               if($tablefield->Type != $fieldtype) {
-                                                       // Add a query to change the column type
-                                                       $cqueries[] = "ALTER TABLE {$table} CHANGE COLUMN {$tablefield->Field} " . $cfields[strtolower($tablefield->Field)];
-                                                       $for_update[$table.'.'.$tablefield->Field] = "Changed type of {$table}.{$tablefield->Field} from {$tablefield->Type} to {$fieldtype}";
-                                               }
-
-                                               // Get the default value from the array
-                                                       //echo "{$cfields[strtolower($tablefield->Field)]}<br>";
-                                               if(preg_match("| DEFAULT '(.*)'|i", $cfields[strtolower($tablefield->Field)], $matches)) {
-                                                       $default_value = $matches[1];
-                                                       if($tablefield->Default != $default_value)
-                                                       {
-                                                               // Add a query to change the column's default value
-                                                               $cqueries[] = "ALTER TABLE {$table} ALTER COLUMN {$tablefield->Field} SET DEFAULT '{$default_value}'";
-                                                               $for_update[$table.'.'.$tablefield->Field] = "Changed default value of {$table}.{$tablefield->Field} from {$tablefield->Default} to {$default_value}";
-                                                       }
-                                               }
-
-                                               // Remove the field from the array (so it's not added)
-                                               unset($cfields[strtolower($tablefield->Field)]);
-                                       }
-                                       else {
-                                               // This field exists in the table, but not in the creation queries?
+                               // Get the default value from the array
+                                       // todo: Remove this?
+                                       //echo "{$cfields[strtolower($tablefield->Field)]}<br>";
+                               if (preg_match("| DEFAULT '(.*?)'|i", $cfields[strtolower($tablefield->Field)], $matches)) {
+                                       $default_value = $matches[1];
+                                       if ($tablefield->Default != $default_value) {
+                                               // Add a query to change the column's default value
+                                               $cqueries[] = "ALTER TABLE {$table} ALTER COLUMN {$tablefield->Field} SET DEFAULT '{$default_value}'";
+                                               $for_update[$table.'.'.$tablefield->Field] = "Changed default value of {$table}.{$tablefield->Field} from {$tablefield->Default} to {$default_value}";
                                        }
                                }
 
-                               // For every remaining field specified for the table
-                               foreach($cfields as $fieldname => $fielddef) {
-                                       // Push a query line into $cqueries that adds the field to that table
-                                       $cqueries[] = "ALTER TABLE {$table} ADD COLUMN $fielddef";
-                                       $for_update[$table.'.'.$fieldname] = 'Added column '.$table.'.'.$fieldname;
-                               }
+                               // Remove the field from the array (so it's not added).
+                               unset($cfields[strtolower($tablefield->Field)]);
+                       } else {
+                               // This field exists in the table, but not in the creation queries?
+                       }
+               }
 
-                               // Index stuff goes here
-                               // Fetch the table index structure from the database
-                               $tableindices = $wpdb->get_results("SHOW INDEX FROM {$table};");
+               // For every remaining field specified for the table.
+               foreach ($cfields as $fieldname => $fielddef) {
+                       // Push a query line into $cqueries that adds the field to that table.
+                       $cqueries[] = "ALTER TABLE {$table} ADD COLUMN $fielddef";
+                       $for_update[$table.'.'.$fieldname] = 'Added column '.$table.'.'.$fieldname;
+               }
 
-                               if($tableindices) {
-                                       // Clear the index array
-                                       unset($index_ary);
+               // Index stuff goes here. Fetch the table index structure from the database.
+               $tableindices = $wpdb->get_results("SHOW INDEX FROM {$table};");
 
-                                       // For every index in the table
-                                       foreach($tableindices as $tableindex) {
-                                               // Add the index to the index data array
-                                               $keyname = $tableindex->Key_name;
-                                               $index_ary[$keyname]['columns'][] = array('fieldname' => $tableindex->Column_name, 'subpart' => $tableindex->Sub_part);
-                                               $index_ary[$keyname]['unique'] = ($tableindex->Non_unique == 0)?true:false;
-                                       }
+               if ($tableindices) {
+                       // Clear the index array.
+                       $index_ary = array();
 
-                                       // For each actual index in the index array
-                                       foreach($index_ary as $index_name => $index_data) {
-                                               // Build a create string to compare to the query
-                                               $index_string = '';
-                                               if($index_name == 'PRIMARY') {
-                                                       $index_string .= 'PRIMARY ';
-                                               }
-                                               else if($index_data['unique']) {
-                                                       $index_string .= 'UNIQUE ';
-                                               }
-                                               $index_string .= 'KEY ';
-                                               if($index_name != 'PRIMARY') {
-                                                       $index_string .= $index_name;
-                                               }
-                                               $index_columns = '';
-                                               // For each column in the index
-                                               foreach($index_data['columns'] as $column_data) {
-                                                       if($index_columns != '') $index_columns .= ',';
-                                                       // Add the field to the column list string
-                                                       $index_columns .= $column_data['fieldname'];
-                                                       if($column_data['subpart'] != '') {
-                                                               $index_columns .= '('.$column_data['subpart'].')';
-                                                       }
-                                               }
-                                               // Add the column list to the index create string
-                                               $index_string .= ' ('.$index_columns.')';
-                                               if(!(($aindex = array_search($index_string, $indices)) === false)) {
-                                                       unset($indices[$aindex]);
-                                                       //echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">{$table}:<br />Found index:".$index_string."</pre>\n";
-                                               }
-                                               //else echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">{$table}:<br /><b>Did not find index:</b>".$index_string."<br />".print_r($indices, true)."</pre>\n";
-                                       }
+                       // For every index in the table.
+                       foreach ($tableindices as $tableindex) {
+
+                               // Add the index to the index data array.
+                               $keyname = $tableindex->Key_name;
+                               $index_ary[$keyname]['columns'][] = array('fieldname' => $tableindex->Column_name, 'subpart' => $tableindex->Sub_part);
+                               $index_ary[$keyname]['unique'] = ($tableindex->Non_unique == 0)?true:false;
+                               $index_ary[$keyname]['index_type'] = $tableindex->Index_type;
+                       }
+
+                       // For each actual index in the index array.
+                       foreach ($index_ary as $index_name => $index_data) {
+
+                               // Build a create string to compare to the query.
+                               $index_string = '';
+                               if ($index_name == 'PRIMARY') {
+                                       $index_string .= 'PRIMARY ';
+                               } elseif ( $index_data['unique'] ) {
+                                       $index_string .= 'UNIQUE ';
                                }
+                               if ( 'FULLTEXT' === strtoupper( $index_data['index_type'] ) ) {
+                                       $index_string .= 'FULLTEXT ';
+                               }
+                               $index_string .= 'KEY ';
+                               if ($index_name != 'PRIMARY') {
+                                       $index_string .= $index_name;
+                               }
+                               $index_columns = '';
+
+                               // For each column in the index.
+                               foreach ($index_data['columns'] as $column_data) {
+                                       if ($index_columns != '') $index_columns .= ',';
 
-                               // For every remaining index specified for the table
-                               foreach ( (array) $indices as $index ) {
-                                       // Push a query line into $cqueries that adds the index to that table
-                                       $cqueries[] = "ALTER TABLE {$table} ADD $index";
-                                       $for_update[$table.'.'.$fieldname] = 'Added index '.$table.' '.$index;
+                                       // Add the field to the column list string.
+                                       $index_columns .= $column_data['fieldname'];
+                                       if ($column_data['subpart'] != '') {
+                                               $index_columns .= '('.$column_data['subpart'].')';
+                                       }
                                }
 
-                               // Remove the original table creation query from processing
-                               unset($cqueries[strtolower($table)]);
-                               unset($for_update[strtolower($table)]);
-                       } else {
-                               // This table exists in the database, but not in the creation queries?
+                               // The alternative index string doesn't care about subparts
+                               $alt_index_columns = preg_replace( '/\([^)]*\)/', '', $index_columns );
+
+                               // Add the column list to the index create string.
+                               $index_strings = array(
+                                       "$index_string ($index_columns)",
+                                       "$index_string ($alt_index_columns)",
+                               );
+
+                               foreach ( $index_strings as $index_string ) {
+                                       if ( ! ( ( $aindex = array_search( $index_string, $indices ) ) === false ) ) {
+                                               unset( $indices[ $aindex ] );
+                                               break;
+                                               // todo: Remove this?
+                                               //echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">{$table}:<br />Found index:".$index_string."</pre>\n";
+                                       }
+                               }
+                               // todo: Remove this?
+                               //else echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">{$table}:<br /><b>Did not find index:</b>".$index_string."<br />".print_r($indices, true)."</pre>\n";
                        }
                }
+
+               // For every remaining index specified for the table.
+               foreach ( (array) $indices as $index ) {
+                       // Push a query line into $cqueries that adds the index to that table.
+                       $cqueries[] = "ALTER TABLE {$table} ADD $index";
+                       $for_update[] = 'Added index ' . $table . ' ' . $index;
+               }
+
+               // Remove the original table creation query from processing.
+               unset( $cqueries[ $table ], $for_update[ $table ] );
        }
 
        $allqueries = array_merge($cqueries, $iqueries);
-       if($execute) {
-               foreach($allqueries as $query) {
+       if ($execute) {
+               foreach ($allqueries as $query) {
+                       // todo: Remove this?
                        //echo "<pre style=\"border:1px solid #ccc;margin-top:5px;\">".print_r($query, true)."</pre>\n";
                        $wpdb->query($query);
                }
@@ -1305,44 +2289,50 @@ function dbDelta($queries, $execute = true) {
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Updates the database tables to a new schema.
  *
- * {@internal Missing Long Description}}
+ * By default, updates all the tables to use the latest defined schema, but can also
+ * be used to update a specific set of tables in wp_get_db_schema().
+ *
+ * @since 1.5.0
+ *
+ * @uses dbDelta
  *
- * @since unknown
+ * @param string $tables Optional. Which set of tables to update. Default is 'all'.
  */
-function make_db_current() {
-       global $wp_queries;
-
-       $alterations = dbDelta($wp_queries);
+function make_db_current( $tables = 'all' ) {
+       $alterations = dbDelta( $tables );
        echo "<ol>\n";
-       foreach($alterations as $alteration) echo "<li>$alteration</li>\n";
+       foreach ($alterations as $alteration) echo "<li>$alteration</li>\n";
        echo "</ol>\n";
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Updates the database tables to a new schema, but without displaying results.
  *
- * {@internal Missing Long Description}}
+ * By default, updates all the tables to use the latest defined schema, but can
+ * also be used to update a specific set of tables in wp_get_db_schema().
+ *
+ * @since 1.5.0
+ *
+ * @see make_db_current()
  *
- * @since unknown
+ * @param string $tables Optional. Which set of tables to update. Default is 'all'.
  */
-function make_db_current_silent() {
-       global $wp_queries;
-
-       $alterations = dbDelta($wp_queries);
+function make_db_current_silent( $tables = 'all' ) {
+       dbDelta( $tables );
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Creates a site theme from an existing theme.
  *
  * {@internal Missing Long Description}}
  *
- * @since unknown
+ * @since 1.5.0
  *
- * @param unknown_type $theme_name
- * @param unknown_type $template
- * @return unknown
+ * @param string $theme_name The name of the theme.
+ * @param string $template   The directory name of the theme.
+ * @return bool
  */
 function make_site_theme_from_oldschool($theme_name, $template) {
        $home_path = get_home_path();
@@ -1351,9 +2341,10 @@ function make_site_theme_from_oldschool($theme_name, $template) {
        if (! file_exists("$home_path/index.php"))
                return false;
 
-       // Copy files from the old locations to the site theme.
-       // TODO: This does not copy arbitarary include dependencies.  Only the
-       // standard WP files are copied.
+       /*
+        * Copy files from the old locations to the site theme.
+        * TODO: This does not copy arbitrary include dependencies. Only the standard WP files are copied.
+        */
        $files = array('index.php' => 'index.php', 'wp-layout.css' => 'style.css', 'wp-comments.php' => 'comments.php', 'wp-comments-popup.php' => 'comments-popup.php');
 
        foreach ($files as $oldfile => $newfile) {
@@ -1362,13 +2353,16 @@ function make_site_theme_from_oldschool($theme_name, $template) {
                else
                        $oldpath = ABSPATH;
 
-               if ($oldfile == 'index.php') { // Check to make sure it's not a new index
+               // Check to make sure it's not a new index.
+               if ($oldfile == 'index.php') {
                        $index = implode('', file("$oldpath/$oldfile"));
                        if (strpos($index, 'WP_USE_THEMES') !== false) {
-                               if (! @copy(WP_CONTENT_DIR . '/themes/default/index.php', "$site_dir/$newfile"))
+                               if (! @copy(WP_CONTENT_DIR . '/themes/' . WP_DEFAULT_THEME . '/index.php', "$site_dir/$newfile"))
                                        return false;
-                               continue; // Don't copy anything
-                               }
+
+                               // Don't copy anything.
+                               continue;
+                       }
                }
 
                if (! @copy("$oldpath/$oldfile", "$site_dir/$newfile"))
@@ -1398,7 +2392,7 @@ function make_site_theme_from_oldschool($theme_name, $template) {
        }
 
        // Add a theme header.
-       $header = "/*\nTheme Name: $theme_name\nTheme URI: " . __get_option('siteurl') . "\nDescription: A theme automatically created by the upgrade.\nVersion: 1.0\nAuthor: Moi\n*/\n";
+       $header = "/*\nTheme Name: $theme_name\nTheme URI: " . __get_option('siteurl') . "\nDescription: A theme automatically created by the update.\nVersion: 1.0\nAuthor: Moi\n*/\n";
 
        $stylelines = file_get_contents("$site_dir/style.css");
        if ($stylelines) {
@@ -1413,24 +2407,24 @@ function make_site_theme_from_oldschool($theme_name, $template) {
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Creates a site theme from the default theme.
  *
  * {@internal Missing Long Description}}
  *
- * @since unknown
+ * @since 1.5.0
  *
- * @param unknown_type $theme_name
- * @param unknown_type $template
- * @return unknown
+ * @param string $theme_name The name of the theme.
+ * @param string $template   The directory name of the theme.
+ * @return false|void
  */
 function make_site_theme_from_default($theme_name, $template) {
        $site_dir = WP_CONTENT_DIR . "/themes/$template";
-       $default_dir = WP_CONTENT_DIR . '/themes/default';
+       $default_dir = WP_CONTENT_DIR . '/themes/' . WP_DEFAULT_THEME;
 
        // Copy files from the default theme to the site theme.
        //$files = array('index.php', 'comments.php', 'comments-popup.php', 'footer.php', 'header.php', 'sidebar.php', 'style.css');
 
-       $theme_dir = @ opendir("$default_dir");
+       $theme_dir = @ opendir($default_dir);
        if ($theme_dir) {
                while(($theme_file = readdir( $theme_dir )) !== false) {
                        if (is_dir("$default_dir/$theme_file"))
@@ -1477,15 +2471,14 @@ function make_site_theme_from_default($theme_name, $template) {
        @closedir($images_dir);
 }
 
-// Create a site theme from the default theme.
 /**
- * {@internal Missing Short Description}}
+ * Creates a site theme.
  *
  * {@internal Missing Long Description}}
  *
- * @since unknown
+ * @since 1.5.0
  *
- * @return unknown
+ * @return false|string
  */
 function make_site_theme() {
        // Name the theme after the blog.
@@ -1510,18 +2503,18 @@ function make_site_theme() {
 
        if (file_exists(ABSPATH . 'wp-layout.css')) {
                if (! make_site_theme_from_oldschool($theme_name, $template)) {
-                       // TODO:  rm -rf the site theme directory.
+                       // TODO: rm -rf the site theme directory.
                        return false;
                }
        } else {
                if (! make_site_theme_from_default($theme_name, $template))
-                       // TODO:  rm -rf the site theme directory.
+                       // TODO: rm -rf the site theme directory.
                        return false;
        }
 
        // Make the new site theme active.
        $current_template = __get_option('template');
-       if ($current_template == 'default') {
+       if ($current_template == WP_DEFAULT_THEME) {
                update_option('template', $template);
                update_option('stylesheet', $template);
        }
@@ -1531,7 +2524,7 @@ function make_site_theme() {
 /**
  * Translate user level to user role name.
  *
- * @since unknown
+ * @since 2.0.0
  *
  * @param int $level User level.
  * @return string User role name.
@@ -1558,11 +2551,11 @@ function translate_level_to_role($level) {
 }
 
 /**
- * {@internal Missing Short Description}}
+ * Checks the version of the installed MySQL binary.
  *
- * {@internal Missing Long Description}}
+ * @since 2.1.0
  *
- * @since unknown
+ * @global wpdb  $wpdb
  */
 function wp_check_mysql_version() {
        global $wpdb;
@@ -1572,11 +2565,9 @@ function wp_check_mysql_version() {
 }
 
 /**
- * {@internal Missing Short Description}}
- *
- * {@internal Missing Long Description}}
+ * Disables the Automattic widgets plugin, which was merged into core.
  *
- * @since unknown
+ * @since 2.2.0
  */
 function maybe_disable_automattic_widgets() {
        $plugins = __get_option( 'active_plugins' );
@@ -1590,4 +2581,152 @@ function maybe_disable_automattic_widgets() {
        }
 }
 
-?>
+/**
+ * Disables the Link Manager on upgrade if, at the time of upgrade, no links exist in the DB.
+ *
+ * @since 3.5.0
+ *
+ * @global int  $wp_current_db_version
+ * @global wpdb $wpdb WordPress database abstraction object.
+ */
+function maybe_disable_link_manager() {
+       global $wp_current_db_version, $wpdb;
+
+       if ( $wp_current_db_version >= 22006 && get_option( 'link_manager_enabled' ) && ! $wpdb->get_var( "SELECT link_id FROM $wpdb->links LIMIT 1" ) )
+               update_option( 'link_manager_enabled', 0 );
+}
+
+/**
+ * Runs before the schema is upgraded.
+ *
+ * @since 2.9.0
+ *
+ * @global int  $wp_current_db_version
+ * @global wpdb $wpdb WordPress database abstraction object.
+ */
+function pre_schema_upgrade() {
+       global $wp_current_db_version, $wpdb;
+
+       // Upgrade versions prior to 2.9
+       if ( $wp_current_db_version < 11557 ) {
+               // Delete duplicate options. Keep the option with the highest option_id.
+               $wpdb->query("DELETE o1 FROM $wpdb->options AS o1 JOIN $wpdb->options AS o2 USING (`option_name`) WHERE o2.option_id > o1.option_id");
+
+               // Drop the old primary key and add the new.
+               $wpdb->query("ALTER TABLE $wpdb->options DROP PRIMARY KEY, ADD PRIMARY KEY(option_id)");
+
+               // Drop the old option_name index. dbDelta() doesn't do the drop.
+               $wpdb->query("ALTER TABLE $wpdb->options DROP INDEX option_name");
+       }
+
+       // Multisite schema upgrades.
+       if ( $wp_current_db_version < 25448 && is_multisite() && wp_should_upgrade_global_tables() ) {
+
+               // Upgrade verions prior to 3.7
+               if ( $wp_current_db_version < 25179 ) {
+                       // New primary key for signups.
+                       $wpdb->query( "ALTER TABLE $wpdb->signups ADD signup_id BIGINT(20) NOT NULL AUTO_INCREMENT PRIMARY KEY FIRST" );
+                       $wpdb->query( "ALTER TABLE $wpdb->signups DROP INDEX domain" );
+               }
+
+               if ( $wp_current_db_version < 25448 ) {
+                       // Convert archived from enum to tinyint.
+                       $wpdb->query( "ALTER TABLE $wpdb->blogs CHANGE COLUMN archived archived varchar(1) NOT NULL default '0'" );
+                       $wpdb->query( "ALTER TABLE $wpdb->blogs CHANGE COLUMN archived archived tinyint(2) NOT NULL default 0" );
+               }
+       }
+
+       // Upgrade versions prior to 4.2.
+       if ( $wp_current_db_version < 31351 ) {
+               if ( ! is_multisite() && wp_should_upgrade_global_tables() ) {
+                       $wpdb->query( "ALTER TABLE $wpdb->usermeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
+               }
+               $wpdb->query( "ALTER TABLE $wpdb->terms DROP INDEX slug, ADD INDEX slug(slug(191))" );
+               $wpdb->query( "ALTER TABLE $wpdb->terms DROP INDEX name, ADD INDEX name(name(191))" );
+               $wpdb->query( "ALTER TABLE $wpdb->commentmeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
+               $wpdb->query( "ALTER TABLE $wpdb->postmeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
+               $wpdb->query( "ALTER TABLE $wpdb->posts DROP INDEX post_name, ADD INDEX post_name(post_name(191))" );
+       }
+
+       // Upgrade versions prior to 4.4.
+       if ( $wp_current_db_version < 34978 ) {
+               // If compatible termmeta table is found, use it, but enforce a proper index and update collation.
+               if ( $wpdb->get_var( "SHOW TABLES LIKE '{$wpdb->termmeta}'" ) && $wpdb->get_results( "SHOW INDEX FROM {$wpdb->termmeta} WHERE Column_name = 'meta_key'" ) ) {
+                       $wpdb->query( "ALTER TABLE $wpdb->termmeta DROP INDEX meta_key, ADD INDEX meta_key(meta_key(191))" );
+                       maybe_convert_table_to_utf8mb4( $wpdb->termmeta );
+               }
+       }
+}
+
+/**
+ * Install global terms.
+ *
+ * @since 3.0.0
+ *
+ * @global wpdb   $wpdb
+ * @global string $charset_collate
+ */
+if ( !function_exists( 'install_global_terms' ) ) :
+function install_global_terms() {
+       global $wpdb, $charset_collate;
+       $ms_queries = "
+CREATE TABLE $wpdb->sitecategories (
+  cat_ID bigint(20) NOT NULL auto_increment,
+  cat_name varchar(55) NOT NULL default '',
+  category_nicename varchar(200) NOT NULL default '',
+  last_updated timestamp NOT NULL,
+  PRIMARY KEY  (cat_ID),
+  KEY category_nicename (category_nicename),
+  KEY last_updated (last_updated)
+) $charset_collate;
+";
+// now create tables
+       dbDelta( $ms_queries );
+}
+endif;
+
+/**
+ * Determine if global tables should be upgraded.
+ *
+ * This function performs a series of checks to ensure the environment allows
+ * for the safe upgrading of global WordPress database tables. It is necessary
+ * because global tables will commonly grow to millions of rows on large
+ * installations, and the ability to control their upgrade routines can be
+ * critical to the operation of large networks.
+ *
+ * In a future iteration, this function may use `wp_is_large_network()` to more-
+ * intelligently prevent global table upgrades. Until then, we make sure
+ * WordPress is on the main site of the main network, to avoid running queries
+ * more than once in multi-site or multi-network environments.
+ *
+ * @since 4.3.0
+ *
+ * @return bool Whether to run the upgrade routines on global tables.
+ */
+function wp_should_upgrade_global_tables() {
+
+       // Return false early if explicitly not upgrading
+       if ( defined( 'DO_NOT_UPGRADE_GLOBAL_TABLES' ) ) {
+               return false;
+       }
+
+       // Assume global tables should be upgraded
+       $should_upgrade = true;
+
+       // Set to false if not on main network (does not matter if not multi-network)
+       if ( ! is_main_network() ) {
+               $should_upgrade = false;
+       }
+
+       // Set to false if not on main site of current network (does not matter if not multi-site)
+       if ( ! is_main_site() ) {
+               $should_upgrade = false;
+       }
+
+       /**
+        * Filter if upgrade routines should be run on global tables.
+        *
+        * @param bool $should_upgrade Whether to run the upgrade routines on global tables.
+        */
+       return apply_filters( 'wp_should_upgrade_global_tables', $should_upgrade );
+}