[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-admin/includes/ -> schema.php (source)

   1  <?php
   2  /**
   3   * WordPress Administration Scheme API
   4   *
   5   * Here we keep the DB structure and option values.
   6   *
   7   * @package WordPress
   8   * @subpackage Administration
   9   */
  10  
  11  /**
  12   * Declare these as global in case schema.php is included from a function.
  13   *
  14   * @global wpdb   $wpdb            WordPress database abstraction object.
  15   * @global array  $wp_queries
  16   * @global string $charset_collate
  17   */
  18  global $wpdb, $wp_queries, $charset_collate;
  19  
  20  /**
  21   * The database character collate.
  22   */
  23  $charset_collate = $wpdb->get_charset_collate();
  24  
  25  /**
  26   * Retrieve the SQL for creating database tables.
  27   *
  28   * @since 3.3.0
  29   *
  30   * @global wpdb $wpdb WordPress database abstraction object.
  31   *
  32   * @param string $scope Optional. The tables for which to retrieve SQL. Can be all, global, ms_global, or blog tables. Defaults to all.
  33   * @param int $blog_id Optional. The site ID for which to retrieve SQL. Default is the current site ID.
  34   * @return string The SQL needed to create the requested tables.
  35   */
  36  function wp_get_db_schema( $scope = 'all', $blog_id = null ) {
  37      global $wpdb;
  38  
  39      $charset_collate = $wpdb->get_charset_collate();
  40  
  41      if ( $blog_id && $blog_id != $wpdb->blogid ) {
  42          $old_blog_id = $wpdb->set_blog_id( $blog_id );
  43      }
  44  
  45      // Engage multisite if in the middle of turning it on from network.php.
  46      $is_multisite = is_multisite() || ( defined( 'WP_INSTALLING_NETWORK' ) && WP_INSTALLING_NETWORK );
  47  
  48      /*
  49       * Indexes have a maximum size of 767 bytes. Historically, we haven't need to be concerned about that.
  50       * As of 4.2, however, we moved to utf8mb4, which uses 4 bytes per character. This means that an index which
  51       * used to have room for floor(767/3) = 255 characters, now only has room for floor(767/4) = 191 characters.
  52       */
  53      $max_index_length = 191;
  54  
  55      // Blog-specific tables.
  56      $blog_tables = "CREATE TABLE $wpdb->termmeta (
  57      meta_id bigint(20) unsigned NOT NULL auto_increment,
  58      term_id bigint(20) unsigned NOT NULL default '0',
  59      meta_key varchar(255) default NULL,
  60      meta_value longtext,
  61      PRIMARY KEY  (meta_id),
  62      KEY term_id (term_id),
  63      KEY meta_key (meta_key($max_index_length))
  64  ) $charset_collate;
  65  CREATE TABLE $wpdb->terms (
  66   term_id bigint(20) unsigned NOT NULL auto_increment,
  67   name varchar(200) NOT NULL default '',
  68   slug varchar(200) NOT NULL default '',
  69   term_group bigint(10) NOT NULL default 0,
  70   PRIMARY KEY  (term_id),
  71   KEY slug (slug($max_index_length)),
  72   KEY name (name($max_index_length))
  73  ) $charset_collate;
  74  CREATE TABLE $wpdb->term_taxonomy (
  75   term_taxonomy_id bigint(20) unsigned NOT NULL auto_increment,
  76   term_id bigint(20) unsigned NOT NULL default 0,
  77   taxonomy varchar(32) NOT NULL default '',
  78   description longtext NOT NULL,
  79   parent bigint(20) unsigned NOT NULL default 0,
  80   count bigint(20) NOT NULL default 0,
  81   PRIMARY KEY  (term_taxonomy_id),
  82   UNIQUE KEY term_id_taxonomy (term_id,taxonomy),
  83   KEY taxonomy (taxonomy)
  84  ) $charset_collate;
  85  CREATE TABLE $wpdb->term_relationships (
  86   object_id bigint(20) unsigned NOT NULL default 0,
  87   term_taxonomy_id bigint(20) unsigned NOT NULL default 0,
  88   term_order int(11) NOT NULL default 0,
  89   PRIMARY KEY  (object_id,term_taxonomy_id),
  90   KEY term_taxonomy_id (term_taxonomy_id)
  91  ) $charset_collate;
  92  CREATE TABLE $wpdb->commentmeta (
  93      meta_id bigint(20) unsigned NOT NULL auto_increment,
  94      comment_id bigint(20) unsigned NOT NULL default '0',
  95      meta_key varchar(255) default NULL,
  96      meta_value longtext,
  97      PRIMARY KEY  (meta_id),
  98      KEY comment_id (comment_id),
  99      KEY meta_key (meta_key($max_index_length))
 100  ) $charset_collate;
 101  CREATE TABLE $wpdb->comments (
 102      comment_ID bigint(20) unsigned NOT NULL auto_increment,
 103      comment_post_ID bigint(20) unsigned NOT NULL default '0',
 104      comment_author tinytext NOT NULL,
 105      comment_author_email varchar(100) NOT NULL default '',
 106      comment_author_url varchar(200) NOT NULL default '',
 107      comment_author_IP varchar(100) NOT NULL default '',
 108      comment_date datetime NOT NULL default '0000-00-00 00:00:00',
 109      comment_date_gmt datetime NOT NULL default '0000-00-00 00:00:00',
 110      comment_content text NOT NULL,
 111      comment_karma int(11) NOT NULL default '0',
 112      comment_approved varchar(20) NOT NULL default '1',
 113      comment_agent varchar(255) NOT NULL default '',
 114      comment_type varchar(20) NOT NULL default '',
 115      comment_parent bigint(20) unsigned NOT NULL default '0',
 116      user_id bigint(20) unsigned NOT NULL default '0',
 117      PRIMARY KEY  (comment_ID),
 118      KEY comment_post_ID (comment_post_ID),
 119      KEY comment_approved_date_gmt (comment_approved,comment_date_gmt),
 120      KEY comment_date_gmt (comment_date_gmt),
 121      KEY comment_parent (comment_parent),
 122      KEY comment_author_email (comment_author_email(10))
 123  ) $charset_collate;
 124  CREATE TABLE $wpdb->links (
 125      link_id bigint(20) unsigned NOT NULL auto_increment,
 126      link_url varchar(255) NOT NULL default '',
 127      link_name varchar(255) NOT NULL default '',
 128      link_image varchar(255) NOT NULL default '',
 129      link_target varchar(25) NOT NULL default '',
 130      link_description varchar(255) NOT NULL default '',
 131      link_visible varchar(20) NOT NULL default 'Y',
 132      link_owner bigint(20) unsigned NOT NULL default '1',
 133      link_rating int(11) NOT NULL default '0',
 134      link_updated datetime NOT NULL default '0000-00-00 00:00:00',
 135      link_rel varchar(255) NOT NULL default '',
 136      link_notes mediumtext NOT NULL,
 137      link_rss varchar(255) NOT NULL default '',
 138      PRIMARY KEY  (link_id),
 139      KEY link_visible (link_visible)
 140  ) $charset_collate;
 141  CREATE TABLE $wpdb->options (
 142      option_id bigint(20) unsigned NOT NULL auto_increment,
 143      option_name varchar(191) NOT NULL default '',
 144      option_value longtext NOT NULL,
 145      autoload varchar(20) NOT NULL default 'yes',
 146      PRIMARY KEY  (option_id),
 147      UNIQUE KEY option_name (option_name),
 148      KEY autoload (autoload)
 149  ) $charset_collate;
 150  CREATE TABLE $wpdb->postmeta (
 151      meta_id bigint(20) unsigned NOT NULL auto_increment,
 152      post_id bigint(20) unsigned NOT NULL default '0',
 153      meta_key varchar(255) default NULL,
 154      meta_value longtext,
 155      PRIMARY KEY  (meta_id),
 156      KEY post_id (post_id),
 157      KEY meta_key (meta_key($max_index_length))
 158  ) $charset_collate;
 159  CREATE TABLE $wpdb->posts (
 160      ID bigint(20) unsigned NOT NULL auto_increment,
 161      post_author bigint(20) unsigned NOT NULL default '0',
 162      post_date datetime NOT NULL default '0000-00-00 00:00:00',
 163      post_date_gmt datetime NOT NULL default '0000-00-00 00:00:00',
 164      post_content longtext NOT NULL,
 165      post_title text NOT NULL,
 166      post_excerpt text NOT NULL,
 167      post_status varchar(20) NOT NULL default 'publish',
 168      comment_status varchar(20) NOT NULL default 'open',
 169      ping_status varchar(20) NOT NULL default 'open',
 170      post_password varchar(255) NOT NULL default '',
 171      post_name varchar(200) NOT NULL default '',
 172      to_ping text NOT NULL,
 173      pinged text NOT NULL,
 174      post_modified datetime NOT NULL default '0000-00-00 00:00:00',
 175      post_modified_gmt datetime NOT NULL default '0000-00-00 00:00:00',
 176      post_content_filtered longtext NOT NULL,
 177      post_parent bigint(20) unsigned NOT NULL default '0',
 178      guid varchar(255) NOT NULL default '',
 179      menu_order int(11) NOT NULL default '0',
 180      post_type varchar(20) NOT NULL default 'post',
 181      post_mime_type varchar(100) NOT NULL default '',
 182      comment_count bigint(20) NOT NULL default '0',
 183      PRIMARY KEY  (ID),
 184      KEY post_name (post_name($max_index_length)),
 185      KEY type_status_date (post_type,post_status,post_date,ID),
 186      KEY post_parent (post_parent),
 187      KEY post_author (post_author)
 188  ) $charset_collate;\n";
 189  
 190      // Single site users table. The multisite flavor of the users table is handled below.
 191      $users_single_table = "CREATE TABLE $wpdb->users (
 192      ID bigint(20) unsigned NOT NULL auto_increment,
 193      user_login varchar(60) NOT NULL default '',
 194      user_pass varchar(255) NOT NULL default '',
 195      user_nicename varchar(50) NOT NULL default '',
 196      user_email varchar(100) NOT NULL default '',
 197      user_url varchar(100) NOT NULL default '',
 198      user_registered datetime NOT NULL default '0000-00-00 00:00:00',
 199      user_activation_key varchar(255) NOT NULL default '',
 200      user_status int(11) NOT NULL default '0',
 201      display_name varchar(250) NOT NULL default '',
 202      PRIMARY KEY  (ID),
 203      KEY user_login_key (user_login),
 204      KEY user_nicename (user_nicename),
 205      KEY user_email (user_email)
 206  ) $charset_collate;\n";
 207  
 208      // Multisite users table.
 209      $users_multi_table = "CREATE TABLE $wpdb->users (
 210      ID bigint(20) unsigned NOT NULL auto_increment,
 211      user_login varchar(60) NOT NULL default '',
 212      user_pass varchar(255) NOT NULL default '',
 213      user_nicename varchar(50) NOT NULL default '',
 214      user_email varchar(100) NOT NULL default '',
 215      user_url varchar(100) NOT NULL default '',
 216      user_registered datetime NOT NULL default '0000-00-00 00:00:00',
 217      user_activation_key varchar(255) NOT NULL default '',
 218      user_status int(11) NOT NULL default '0',
 219      display_name varchar(250) NOT NULL default '',
 220      spam tinyint(2) NOT NULL default '0',
 221      deleted tinyint(2) NOT NULL default '0',
 222      PRIMARY KEY  (ID),
 223      KEY user_login_key (user_login),
 224      KEY user_nicename (user_nicename),
 225      KEY user_email (user_email)
 226  ) $charset_collate;\n";
 227  
 228      // Usermeta.
 229      $usermeta_table = "CREATE TABLE $wpdb->usermeta (
 230      umeta_id bigint(20) unsigned NOT NULL auto_increment,
 231      user_id bigint(20) unsigned NOT NULL default '0',
 232      meta_key varchar(255) default NULL,
 233      meta_value longtext,
 234      PRIMARY KEY  (umeta_id),
 235      KEY user_id (user_id),
 236      KEY meta_key (meta_key($max_index_length))
 237  ) $charset_collate;\n";
 238  
 239      // Global tables.
 240      if ( $is_multisite ) {
 241          $global_tables = $users_multi_table . $usermeta_table;
 242      } else {
 243          $global_tables = $users_single_table . $usermeta_table;
 244      }
 245  
 246      // Multisite global tables.
 247      $ms_global_tables = "CREATE TABLE $wpdb->blogs (
 248      blog_id bigint(20) NOT NULL auto_increment,
 249      site_id bigint(20) NOT NULL default '0',
 250      domain varchar(200) NOT NULL default '',
 251      path varchar(100) NOT NULL default '',
 252      registered datetime NOT NULL default '0000-00-00 00:00:00',
 253      last_updated datetime NOT NULL default '0000-00-00 00:00:00',
 254      public tinyint(2) NOT NULL default '1',
 255      archived tinyint(2) NOT NULL default '0',
 256      mature tinyint(2) NOT NULL default '0',
 257      spam tinyint(2) NOT NULL default '0',
 258      deleted tinyint(2) NOT NULL default '0',
 259      lang_id int(11) NOT NULL default '0',
 260      PRIMARY KEY  (blog_id),
 261      KEY domain (domain(50),path(5)),
 262      KEY lang_id (lang_id)
 263  ) $charset_collate;
 264  CREATE TABLE $wpdb->blogmeta (
 265      meta_id bigint(20) unsigned NOT NULL auto_increment,
 266      blog_id bigint(20) NOT NULL default '0',
 267      meta_key varchar(255) default NULL,
 268      meta_value longtext,
 269      PRIMARY KEY  (meta_id),
 270      KEY meta_key (meta_key($max_index_length)),
 271      KEY blog_id (blog_id)
 272  ) $charset_collate;
 273  CREATE TABLE $wpdb->registration_log (
 274      ID bigint(20) NOT NULL auto_increment,
 275      email varchar(255) NOT NULL default '',
 276      IP varchar(30) NOT NULL default '',
 277      blog_id bigint(20) NOT NULL default '0',
 278      date_registered datetime NOT NULL default '0000-00-00 00:00:00',
 279      PRIMARY KEY  (ID),
 280      KEY IP (IP)
 281  ) $charset_collate;
 282  CREATE TABLE $wpdb->site (
 283      id bigint(20) NOT NULL auto_increment,
 284      domain varchar(200) NOT NULL default '',
 285      path varchar(100) NOT NULL default '',
 286      PRIMARY KEY  (id),
 287      KEY domain (domain(140),path(51))
 288  ) $charset_collate;
 289  CREATE TABLE $wpdb->sitemeta (
 290      meta_id bigint(20) NOT NULL auto_increment,
 291      site_id bigint(20) NOT NULL default '0',
 292      meta_key varchar(255) default NULL,
 293      meta_value longtext,
 294      PRIMARY KEY  (meta_id),
 295      KEY meta_key (meta_key($max_index_length)),
 296      KEY site_id (site_id)
 297  ) $charset_collate;
 298  CREATE TABLE $wpdb->signups (
 299      signup_id bigint(20) NOT NULL auto_increment,
 300      domain varchar(200) NOT NULL default '',
 301      path varchar(100) NOT NULL default '',
 302      title longtext NOT NULL,
 303      user_login varchar(60) NOT NULL default '',
 304      user_email varchar(100) NOT NULL default '',
 305      registered datetime NOT NULL default '0000-00-00 00:00:00',
 306      activated datetime NOT NULL default '0000-00-00 00:00:00',
 307      active tinyint(1) NOT NULL default '0',
 308      activation_key varchar(50) NOT NULL default '',
 309      meta longtext,
 310      PRIMARY KEY  (signup_id),
 311      KEY activation_key (activation_key),
 312      KEY user_email (user_email),
 313      KEY user_login_email (user_login,user_email),
 314      KEY domain_path (domain(140),path(51))
 315  ) $charset_collate;";
 316  
 317      switch ( $scope ) {
 318          case 'blog':
 319              $queries = $blog_tables;
 320              break;
 321          case 'global':
 322              $queries = $global_tables;
 323              if ( $is_multisite ) {
 324                  $queries .= $ms_global_tables;
 325              }
 326              break;
 327          case 'ms_global':
 328              $queries = $ms_global_tables;
 329              break;
 330          case 'all':
 331          default:
 332              $queries = $global_tables . $blog_tables;
 333              if ( $is_multisite ) {
 334                  $queries .= $ms_global_tables;
 335              }
 336              break;
 337      }
 338  
 339      if ( isset( $old_blog_id ) ) {
 340          $wpdb->set_blog_id( $old_blog_id );
 341      }
 342  
 343      return $queries;
 344  }
 345  
 346  // Populate for back compat.
 347  $wp_queries = wp_get_db_schema( 'all' );
 348  
 349  /**
 350   * Create WordPress options and set the default values.
 351   *
 352   * @since 1.5.0
 353   * @since 5.1.0 The $options parameter has been added.
 354   *
 355   * @global wpdb $wpdb                  WordPress database abstraction object.
 356   * @global int  $wp_db_version         WordPress database version.
 357   * @global int  $wp_current_db_version The old (current) database version.
 358   *
 359   * @param array $options Optional. Custom option $key => $value pairs to use. Default empty array.
 360   */
 361  function populate_options( array $options = array() ) {
 362      global $wpdb, $wp_db_version, $wp_current_db_version;
 363  
 364      $guessurl = wp_guess_url();
 365      /**
 366       * Fires before creating WordPress options and populating their default values.
 367       *
 368       * @since 2.6.0
 369       */
 370      do_action( 'populate_options' );
 371  
 372      if ( ini_get( 'safe_mode' ) ) {
 373          // Safe mode can break mkdir() so use a flat structure by default.
 374          $uploads_use_yearmonth_folders = 0;
 375      } else {
 376          $uploads_use_yearmonth_folders = 1;
 377      }
 378  
 379      // If WP_DEFAULT_THEME doesn't exist, fall back to the latest core default theme.
 380      $stylesheet = WP_DEFAULT_THEME;
 381      $template   = WP_DEFAULT_THEME;
 382      $theme      = wp_get_theme( WP_DEFAULT_THEME );
 383      if ( ! $theme->exists() ) {
 384          $theme = WP_Theme::get_core_default_theme();
 385      }
 386  
 387      // If we can't find a core default theme, WP_DEFAULT_THEME is the best we can do.
 388      if ( $theme ) {
 389          $stylesheet = $theme->get_stylesheet();
 390          $template   = $theme->get_template();
 391      }
 392  
 393      $timezone_string = '';
 394      $gmt_offset      = 0;
 395      /*
 396       * translators: default GMT offset or timezone string. Must be either a valid offset (-12 to 14)
 397       * or a valid timezone string (America/New_York). See https://www.php.net/manual/en/timezones.php
 398       * for all timezone strings supported by PHP.
 399       */
 400      $offset_or_tz = _x( '0', 'default GMT offset or timezone string' ); // phpcs:ignore WordPress.WP.I18n.NoEmptyStrings
 401      if ( is_numeric( $offset_or_tz ) ) {
 402          $gmt_offset = $offset_or_tz;
 403      } elseif ( $offset_or_tz && in_array( $offset_or_tz, timezone_identifiers_list(), true ) ) {
 404              $timezone_string = $offset_or_tz;
 405      }
 406  
 407      $defaults = array(
 408          'siteurl'                         => $guessurl,
 409          'home'                            => $guessurl,
 410          'blogname'                        => __( 'My Site' ),
 411          /* translators: Site tagline. */
 412          'blogdescription'                 => __( 'Just another WordPress site' ),
 413          'users_can_register'              => 0,
 414          'admin_email'                     => 'you@example.com',
 415          /* translators: Default start of the week. 0 = Sunday, 1 = Monday. */
 416          'start_of_week'                   => _x( '1', 'start of week' ),
 417          'use_balanceTags'                 => 0,
 418          'use_smilies'                     => 1,
 419          'require_name_email'              => 1,
 420          'comments_notify'                 => 1,
 421          'posts_per_rss'                   => 10,
 422          'rss_use_excerpt'                 => 0,
 423          'mailserver_url'                  => 'mail.example.com',
 424          'mailserver_login'                => 'login@example.com',
 425          'mailserver_pass'                 => 'password',
 426          'mailserver_port'                 => 110,
 427          'default_category'                => 1,
 428          'default_comment_status'          => 'open',
 429          'default_ping_status'             => 'open',
 430          'default_pingback_flag'           => 1,
 431          'posts_per_page'                  => 10,
 432          /* translators: Default date format, see https://www.php.net/date */
 433          'date_format'                     => __( 'F j, Y' ),
 434          /* translators: Default time format, see https://www.php.net/date */
 435          'time_format'                     => __( 'g:i a' ),
 436          /* translators: Links last updated date format, see https://www.php.net/date */
 437          'links_updated_date_format'       => __( 'F j, Y g:i a' ),
 438          'comment_moderation'              => 0,
 439          'moderation_notify'               => 1,
 440          'permalink_structure'             => '',
 441          'rewrite_rules'                   => '',
 442          'hack_file'                       => 0,
 443          'blog_charset'                    => 'UTF-8',
 444          'moderation_keys'                 => '',
 445          'active_plugins'                  => array(),
 446          'category_base'                   => '',
 447          'ping_sites'                      => 'http://rpc.pingomatic.com/',
 448          'comment_max_links'               => 2,
 449          'gmt_offset'                      => $gmt_offset,
 450  
 451          // 1.5
 452          'default_email_category'          => 1,
 453          'recently_edited'                 => '',
 454          'template'                        => $template,
 455          'stylesheet'                      => $stylesheet,
 456          'comment_whitelist'               => 1,
 457          'blacklist_keys'                  => '',
 458          'comment_registration'            => 0,
 459          'html_type'                       => 'text/html',
 460  
 461          // 1.5.1
 462          'use_trackback'                   => 0,
 463  
 464          // 2.0
 465          'default_role'                    => 'subscriber',
 466          'db_version'                      => $wp_db_version,
 467  
 468          // 2.0.1
 469          'uploads_use_yearmonth_folders'   => $uploads_use_yearmonth_folders,
 470          'upload_path'                     => '',
 471  
 472          // 2.1
 473          'blog_public'                     => '1',
 474          'default_link_category'           => 2,
 475          'show_on_front'                   => 'posts',
 476  
 477          // 2.2
 478          'tag_base'                        => '',
 479  
 480          // 2.5
 481          'show_avatars'                    => '1',
 482          'avatar_rating'                   => 'G',
 483          'upload_url_path'                 => '',
 484          'thumbnail_size_w'                => 150,
 485          'thumbnail_size_h'                => 150,
 486          'thumbnail_crop'                  => 1,
 487          'medium_size_w'                   => 300,
 488          'medium_size_h'                   => 300,
 489  
 490          // 2.6
 491          'avatar_default'                  => 'mystery',
 492  
 493          // 2.7
 494          'large_size_w'                    => 1024,
 495          'large_size_h'                    => 1024,
 496          'image_default_link_type'         => 'none',
 497          'image_default_size'              => '',
 498          'image_default_align'             => '',
 499          'close_comments_for_old_posts'    => 0,
 500          'close_comments_days_old'         => 14,
 501          'thread_comments'                 => 1,
 502          'thread_comments_depth'           => 5,
 503          'page_comments'                   => 0,
 504          'comments_per_page'               => 50,
 505          'default_comments_page'           => 'newest',
 506          'comment_order'                   => 'asc',
 507          'sticky_posts'                    => array(),
 508          'widget_categories'               => array(),
 509          'widget_text'                     => array(),
 510          'widget_rss'                      => array(),
 511          'uninstall_plugins'               => array(),
 512  
 513          // 2.8
 514          'timezone_string'                 => $timezone_string,
 515  
 516          // 3.0
 517          'page_for_posts'                  => 0,
 518          'page_on_front'                   => 0,
 519  
 520          // 3.1
 521          'default_post_format'             => 0,
 522  
 523          // 3.5
 524          'link_manager_enabled'            => 0,
 525  
 526          // 4.3.0
 527          'finished_splitting_shared_terms' => 1,
 528          'site_icon'                       => 0,
 529  
 530          // 4.4.0
 531          'medium_large_size_w'             => 768,
 532          'medium_large_size_h'             => 0,
 533  
 534          // 4.9.6
 535          'wp_page_for_privacy_policy'      => 0,
 536  
 537          // 4.9.8
 538          'show_comments_cookies_opt_in'    => 1,
 539  
 540          // 5.3.0
 541          'admin_email_lifespan'            => ( time() + 6 * MONTH_IN_SECONDS ),
 542      );
 543  
 544      // 3.3
 545      if ( ! is_multisite() ) {
 546          $defaults['initial_db_version'] = ! empty( $wp_current_db_version ) && $wp_current_db_version < $wp_db_version
 547              ? $wp_current_db_version : $wp_db_version;
 548      }
 549  
 550      // 3.0 multisite.
 551      if ( is_multisite() ) {
 552          /* translators: %s: Network title. */
 553          $defaults['blogdescription']     = sprintf( __( 'Just another %s site' ), get_network()->site_name );
 554          $defaults['permalink_structure'] = '/%year%/%monthnum%/%day%/%postname%/';
 555      }
 556  
 557      $options = wp_parse_args( $options, $defaults );
 558  
 559      // Set autoload to no for these options.
 560      $fat_options = array( 'moderation_keys', 'recently_edited', 'blacklist_keys', 'uninstall_plugins' );
 561  
 562      $keys             = "'" . implode( "', '", array_keys( $options ) ) . "'";
 563      $existing_options = $wpdb->get_col( "SELECT option_name FROM $wpdb->options WHERE option_name in ( $keys )" ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
 564  
 565      $insert = '';
 566  
 567      foreach ( $options as $option => $value ) {
 568          if ( in_array( $option, $existing_options, true ) ) {
 569              continue;
 570          }
 571  
 572          if ( in_array( $option, $fat_options, true ) ) {
 573              $autoload = 'no';
 574          } else {
 575              $autoload = 'yes';
 576          }
 577  
 578          if ( is_array( $value ) ) {
 579              $value = serialize( $value );
 580          }
 581  
 582          if ( ! empty( $insert ) ) {
 583              $insert .= ', ';
 584          }
 585  
 586          $insert .= $wpdb->prepare( '(%s, %s, %s)', $option, $value, $autoload );
 587      }
 588  
 589      if ( ! empty( $insert ) ) {
 590          $wpdb->query( "INSERT INTO $wpdb->options (option_name, option_value, autoload) VALUES " . $insert ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
 591      }
 592  
 593      // In case it is set, but blank, update "home".
 594      if ( ! __get_option( 'home' ) ) {
 595          update_option( 'home', $guessurl );
 596      }
 597  
 598      // Delete unused options.
 599      $unusedoptions = array(
 600          'blodotgsping_url',
 601          'bodyterminator',
 602          'emailtestonly',
 603          'phoneemail_separator',
 604          'smilies_directory',
 605          'subjectprefix',
 606          'use_bbcode',
 607          'use_blodotgsping',
 608          'use_phoneemail',
 609          'use_quicktags',
 610          'use_weblogsping',
 611          'weblogs_cache_file',
 612          'use_preview',
 613          'use_htmltrans',
 614          'smilies_directory',
 615          'fileupload_allowedusers',
 616          'use_phoneemail',
 617          'default_post_status',
 618          'default_post_category',
 619          'archive_mode',
 620          'time_difference',
 621          'links_minadminlevel',
 622          'links_use_adminlevels',
 623          'links_rating_type',
 624          'links_rating_char',
 625          'links_rating_ignore_zero',
 626          'links_rating_single_image',
 627          'links_rating_image0',
 628          'links_rating_image1',
 629          'links_rating_image2',
 630          'links_rating_image3',
 631          'links_rating_image4',
 632          'links_rating_image5',
 633          'links_rating_image6',
 634          'links_rating_image7',
 635          'links_rating_image8',
 636          'links_rating_image9',
 637          'links_recently_updated_time',
 638          'links_recently_updated_prepend',
 639          'links_recently_updated_append',
 640          'weblogs_cacheminutes',
 641          'comment_allowed_tags',
 642          'search_engine_friendly_urls',
 643          'default_geourl_lat',
 644          'default_geourl_lon',
 645          'use_default_geourl',
 646          'weblogs_xml_url',
 647          'new_users_can_blog',
 648          '_wpnonce',
 649          '_wp_http_referer',
 650          'Update',
 651          'action',
 652          'rich_editing',
 653          'autosave_interval',
 654          'deactivated_plugins',
 655          'can_compress_scripts',
 656          'page_uris',
 657          'update_core',
 658          'update_plugins',
 659          'update_themes',
 660          'doing_cron',
 661          'random_seed',
 662          'rss_excerpt_length',
 663          'secret',
 664          'use_linksupdate',
 665          'default_comment_status_page',
 666          'wporg_popular_tags',
 667          'what_to_show',
 668          'rss_language',
 669          'language',
 670          'enable_xmlrpc',
 671          'enable_app',
 672          'embed_autourls',
 673          'default_post_edit_rows',
 674          'gzipcompression',
 675          'advanced_edit',
 676      );
 677      foreach ( $unusedoptions as $option ) {
 678          delete_option( $option );
 679      }
 680  
 681      // Delete obsolete magpie stuff.
 682      $wpdb->query( "DELETE FROM $wpdb->options WHERE option_name REGEXP '^rss_[0-9a-f]{32}(_ts)?$'" );
 683  
 684      // Clear expired transients.
 685      delete_expired_transients( true );
 686  }
 687  
 688  /**
 689   * Execute WordPress role creation for the various WordPress versions.
 690   *
 691   * @since 2.0.0
 692   */
 693  function populate_roles() {
 694      populate_roles_160();
 695      populate_roles_210();
 696      populate_roles_230();
 697      populate_roles_250();
 698      populate_roles_260();
 699      populate_roles_270();
 700      populate_roles_280();
 701      populate_roles_300();
 702  }
 703  
 704  /**
 705   * Create the roles for WordPress 2.0
 706   *
 707   * @since 2.0.0
 708   */
 709  function populate_roles_160() {
 710      // Add roles.
 711      add_role( 'administrator', 'Administrator' );
 712      add_role( 'editor', 'Editor' );
 713      add_role( 'author', 'Author' );
 714      add_role( 'contributor', 'Contributor' );
 715      add_role( 'subscriber', 'Subscriber' );
 716  
 717      // Add caps for Administrator role.
 718      $role = get_role( 'administrator' );
 719      $role->add_cap( 'switch_themes' );
 720      $role->add_cap( 'edit_themes' );
 721      $role->add_cap( 'activate_plugins' );
 722      $role->add_cap( 'edit_plugins' );
 723      $role->add_cap( 'edit_users' );
 724      $role->add_cap( 'edit_files' );
 725      $role->add_cap( 'manage_options' );
 726      $role->add_cap( 'moderate_comments' );
 727      $role->add_cap( 'manage_categories' );
 728      $role->add_cap( 'manage_links' );
 729      $role->add_cap( 'upload_files' );
 730      $role->add_cap( 'import' );
 731      $role->add_cap( 'unfiltered_html' );
 732      $role->add_cap( 'edit_posts' );
 733      $role->add_cap( 'edit_others_posts' );
 734      $role->add_cap( 'edit_published_posts' );
 735      $role->add_cap( 'publish_posts' );
 736      $role->add_cap( 'edit_pages' );
 737      $role->add_cap( 'read' );
 738      $role->add_cap( 'level_10' );
 739      $role->add_cap( 'level_9' );
 740      $role->add_cap( 'level_8' );
 741      $role->add_cap( 'level_7' );
 742      $role->add_cap( 'level_6' );
 743      $role->add_cap( 'level_5' );
 744      $role->add_cap( 'level_4' );
 745      $role->add_cap( 'level_3' );
 746      $role->add_cap( 'level_2' );
 747      $role->add_cap( 'level_1' );
 748      $role->add_cap( 'level_0' );
 749  
 750      // Add caps for Editor role.
 751      $role = get_role( 'editor' );
 752      $role->add_cap( 'moderate_comments' );
 753      $role->add_cap( 'manage_categories' );
 754      $role->add_cap( 'manage_links' );
 755      $role->add_cap( 'upload_files' );
 756      $role->add_cap( 'unfiltered_html' );
 757      $role->add_cap( 'edit_posts' );
 758      $role->add_cap( 'edit_others_posts' );
 759      $role->add_cap( 'edit_published_posts' );
 760      $role->add_cap( 'publish_posts' );
 761      $role->add_cap( 'edit_pages' );
 762      $role->add_cap( 'read' );
 763      $role->add_cap( 'level_7' );
 764      $role->add_cap( 'level_6' );
 765      $role->add_cap( 'level_5' );
 766      $role->add_cap( 'level_4' );
 767      $role->add_cap( 'level_3' );
 768      $role->add_cap( 'level_2' );
 769      $role->add_cap( 'level_1' );
 770      $role->add_cap( 'level_0' );
 771  
 772      // Add caps for Author role.
 773      $role = get_role( 'author' );
 774      $role->add_cap( 'upload_files' );
 775      $role->add_cap( 'edit_posts' );
 776      $role->add_cap( 'edit_published_posts' );
 777      $role->add_cap( 'publish_posts' );
 778      $role->add_cap( 'read' );
 779      $role->add_cap( 'level_2' );
 780      $role->add_cap( 'level_1' );
 781      $role->add_cap( 'level_0' );
 782  
 783      // Add caps for Contributor role.
 784      $role = get_role( 'contributor' );
 785      $role->add_cap( 'edit_posts' );
 786      $role->add_cap( 'read' );
 787      $role->add_cap( 'level_1' );
 788      $role->add_cap( 'level_0' );
 789  
 790      // Add caps for Subscriber role.
 791      $role = get_role( 'subscriber' );
 792      $role->add_cap( 'read' );
 793      $role->add_cap( 'level_0' );
 794  }
 795  
 796  /**
 797   * Create and modify WordPress roles for WordPress 2.1.
 798   *
 799   * @since 2.1.0
 800   */
 801  function populate_roles_210() {
 802      $roles = array( 'administrator', 'editor' );
 803      foreach ( $roles as $role ) {
 804          $role = get_role( $role );
 805          if ( empty( $role ) ) {
 806              continue;
 807          }
 808  
 809          $role->add_cap( 'edit_others_pages' );
 810          $role->add_cap( 'edit_published_pages' );
 811          $role->add_cap( 'publish_pages' );
 812          $role->add_cap( 'delete_pages' );
 813          $role->add_cap( 'delete_others_pages' );
 814          $role->add_cap( 'delete_published_pages' );
 815          $role->add_cap( 'delete_posts' );
 816          $role->add_cap( 'delete_others_posts' );
 817          $role->add_cap( 'delete_published_posts' );
 818          $role->add_cap( 'delete_private_posts' );
 819          $role->add_cap( 'edit_private_posts' );
 820          $role->add_cap( 'read_private_posts' );
 821          $role->add_cap( 'delete_private_pages' );
 822          $role->add_cap( 'edit_private_pages' );
 823          $role->add_cap( 'read_private_pages' );
 824      }
 825  
 826      $role = get_role( 'administrator' );
 827      if ( ! empty( $role ) ) {
 828          $role->add_cap( 'delete_users' );
 829          $role->add_cap( 'create_users' );
 830      }
 831  
 832      $role = get_role( 'author' );
 833      if ( ! empty( $role ) ) {
 834          $role->add_cap( 'delete_posts' );
 835          $role->add_cap( 'delete_published_posts' );
 836      }
 837  
 838      $role = get_role( 'contributor' );
 839      if ( ! empty( $role ) ) {
 840          $role->add_cap( 'delete_posts' );
 841      }
 842  }
 843  
 844  /**
 845   * Create and modify WordPress roles for WordPress 2.3.
 846   *
 847   * @since 2.3.0
 848   */
 849  function populate_roles_230() {
 850      $role = get_role( 'administrator' );
 851  
 852      if ( ! empty( $role ) ) {
 853          $role->add_cap( 'unfiltered_upload' );
 854      }
 855  }
 856  
 857  /**
 858   * Create and modify WordPress roles for WordPress 2.5.
 859   *
 860   * @since 2.5.0
 861   */
 862  function populate_roles_250() {
 863      $role = get_role( 'administrator' );
 864  
 865      if ( ! empty( $role ) ) {
 866          $role->add_cap( 'edit_dashboard' );
 867      }
 868  }
 869  
 870  /**
 871   * Create and modify WordPress roles for WordPress 2.6.
 872   *
 873   * @since 2.6.0
 874   */
 875  function populate_roles_260() {
 876      $role = get_role( 'administrator' );
 877  
 878      if ( ! empty( $role ) ) {
 879          $role->add_cap( 'update_plugins' );
 880          $role->add_cap( 'delete_plugins' );
 881      }
 882  }
 883  
 884  /**
 885   * Create and modify WordPress roles for WordPress 2.7.
 886   *
 887   * @since 2.7.0
 888   */
 889  function populate_roles_270() {
 890      $role = get_role( 'administrator' );
 891  
 892      if ( ! empty( $role ) ) {
 893          $role->add_cap( 'install_plugins' );
 894          $role->add_cap( 'update_themes' );
 895      }
 896  }
 897  
 898  /**
 899   * Create and modify WordPress roles for WordPress 2.8.
 900   *
 901   * @since 2.8.0
 902   */
 903  function populate_roles_280() {
 904      $role = get_role( 'administrator' );
 905  
 906      if ( ! empty( $role ) ) {
 907          $role->add_cap( 'install_themes' );
 908      }
 909  }
 910  
 911  /**
 912   * Create and modify WordPress roles for WordPress 3.0.
 913   *
 914   * @since 3.0.0
 915   */
 916  function populate_roles_300() {
 917      $role = get_role( 'administrator' );
 918  
 919      if ( ! empty( $role ) ) {
 920          $role->add_cap( 'update_core' );
 921          $role->add_cap( 'list_users' );
 922          $role->add_cap( 'remove_users' );
 923          $role->add_cap( 'promote_users' );
 924          $role->add_cap( 'edit_theme_options' );
 925          $role->add_cap( 'delete_themes' );
 926          $role->add_cap( 'export' );
 927      }
 928  }
 929  
 930  if ( ! function_exists( 'install_network' ) ) :
 931      /**
 932       * Install Network.
 933       *
 934       * @since 3.0.0
 935       */
 936  	function install_network() {
 937          if ( ! defined( 'WP_INSTALLING_NETWORK' ) ) {
 938              define( 'WP_INSTALLING_NETWORK', true );
 939          }
 940  
 941          dbDelta( wp_get_db_schema( 'global' ) );
 942      }
 943  endif;
 944  
 945  /**
 946   * Populate network settings.
 947   *
 948   * @since 3.0.0
 949   *
 950   * @global wpdb       $wpdb         WordPress database abstraction object.
 951   * @global object     $current_site
 952   * @global WP_Rewrite $wp_rewrite   WordPress rewrite component.
 953   *
 954   * @param int    $network_id        ID of network to populate.
 955   * @param string $domain            The domain name for the network (eg. "example.com").
 956   * @param string $email             Email address for the network administrator.
 957   * @param string $site_name         The name of the network.
 958   * @param string $path              Optional. The path to append to the network's domain name. Default '/'.
 959   * @param bool   $subdomain_install Optional. Whether the network is a subdomain installation or a subdirectory installation.
 960   *                                  Default false, meaning the network is a subdirectory installation.
 961   * @return bool|WP_Error True on success, or WP_Error on warning (with the installation otherwise successful,
 962   *                       so the error code must be checked) or failure.
 963   */
 964  function populate_network( $network_id = 1, $domain = '', $email = '', $site_name = '', $path = '/', $subdomain_install = false ) {
 965      global $wpdb, $current_site, $wp_rewrite;
 966  
 967      $errors = new WP_Error();
 968      if ( '' == $domain ) {
 969          $errors->add( 'empty_domain', __( 'You must provide a domain name.' ) );
 970      }
 971      if ( '' == $site_name ) {
 972          $errors->add( 'empty_sitename', __( 'You must provide a name for your network of sites.' ) );
 973      }
 974  
 975      // Check for network collision.
 976      $network_exists = false;
 977      if ( is_multisite() ) {
 978          if ( get_network( (int) $network_id ) ) {
 979              $errors->add( 'siteid_exists', __( 'The network already exists.' ) );
 980          }
 981      } else {
 982          if ( $network_id == $wpdb->get_var( $wpdb->prepare( "SELECT id FROM $wpdb->site WHERE id = %d", $network_id ) ) ) {
 983              $errors->add( 'siteid_exists', __( 'The network already exists.' ) );
 984          }
 985      }
 986  
 987      if ( ! is_email( $email ) ) {
 988          $errors->add( 'invalid_email', __( 'You must provide a valid email address.' ) );
 989      }
 990  
 991      if ( $errors->has_errors() ) {
 992          return $errors;
 993      }
 994  
 995      if ( 1 == $network_id ) {
 996          $wpdb->insert(
 997              $wpdb->site,
 998              array(
 999                  'domain' => $domain,
1000                  'path'   => $path,
1001              )
1002          );
1003          $network_id = $wpdb->insert_id;
1004      } else {
1005          $wpdb->insert(
1006              $wpdb->site,
1007              array(
1008                  'domain' => $domain,
1009                  'path'   => $path,
1010                  'id'     => $network_id,
1011              )
1012          );
1013      }
1014  
1015      populate_network_meta(
1016          $network_id,
1017          array(
1018              'admin_email'       => $email,
1019              'site_name'         => $site_name,
1020              'subdomain_install' => $subdomain_install,
1021          )
1022      );
1023  
1024      $site_user = get_userdata( (int) $wpdb->get_var( $wpdb->prepare( "SELECT meta_value FROM $wpdb->sitemeta WHERE meta_key = %s AND site_id = %d", 'admin_user_id', $network_id ) ) );
1025  
1026      /*
1027       * When upgrading from single to multisite, assume the current site will
1028       * become the main site of the network. When using populate_network()
1029       * to create another network in an existing multisite environment, skip
1030       * these steps since the main site of the new network has not yet been
1031       * created.
1032       */
1033      if ( ! is_multisite() ) {
1034          $current_site            = new stdClass;
1035          $current_site->domain    = $domain;
1036          $current_site->path      = $path;
1037          $current_site->site_name = ucfirst( $domain );
1038          $wpdb->insert(
1039              $wpdb->blogs,
1040              array(
1041                  'site_id'    => $network_id,
1042                  'blog_id'    => 1,
1043                  'domain'     => $domain,
1044                  'path'       => $path,
1045                  'registered' => current_time( 'mysql' ),
1046              )
1047          );
1048          $current_site->blog_id = $wpdb->insert_id;
1049          update_user_meta( $site_user->ID, 'source_domain', $domain );
1050          update_user_meta( $site_user->ID, 'primary_blog', $current_site->blog_id );
1051  
1052          if ( $subdomain_install ) {
1053              $wp_rewrite->set_permalink_structure( '/%year%/%monthnum%/%day%/%postname%/' );
1054          } else {
1055              $wp_rewrite->set_permalink_structure( '/blog/%year%/%monthnum%/%day%/%postname%/' );
1056          }
1057  
1058          flush_rewrite_rules();
1059  
1060          if ( ! $subdomain_install ) {
1061              return true;
1062          }
1063  
1064          $vhost_ok = false;
1065          $errstr   = '';
1066          $hostname = substr( md5( time() ), 0, 6 ) . '.' . $domain; // Very random hostname!
1067          $page     = wp_remote_get(
1068              'http://' . $hostname,
1069              array(
1070                  'timeout'     => 5,
1071                  'httpversion' => '1.1',
1072              )
1073          );
1074          if ( is_wp_error( $page ) ) {
1075              $errstr = $page->get_error_message();
1076          } elseif ( 200 == wp_remote_retrieve_response_code( $page ) ) {
1077                  $vhost_ok = true;
1078          }
1079  
1080          if ( ! $vhost_ok ) {
1081              $msg = '<p><strong>' . __( 'Warning! Wildcard DNS may not be configured correctly!' ) . '</strong></p>';
1082  
1083              $msg .= '<p>' . sprintf(
1084                  /* translators: %s: Host name. */
1085                  __( 'The installer attempted to contact a random hostname (%s) on your domain.' ),
1086                  '<code>' . $hostname . '</code>'
1087              );
1088              if ( ! empty( $errstr ) ) {
1089                  /* translators: %s: Error message. */
1090                  $msg .= ' ' . sprintf( __( 'This resulted in an error message: %s' ), '<code>' . $errstr . '</code>' );
1091              }
1092              $msg .= '</p>';
1093  
1094              $msg .= '<p>' . sprintf(
1095                  /* translators: %s: Asterisk symbol (*). */
1096                  __( 'To use a subdomain configuration, you must have a wildcard entry in your DNS. This usually means adding a %s hostname record pointing at your web server in your DNS configuration tool.' ),
1097                  '<code>*</code>'
1098              ) . '</p>';
1099  
1100              $msg .= '<p>' . __( 'You can still use your site but any subdomain you create may not be accessible. If you know your DNS is correct, ignore this message.' ) . '</p>';
1101  
1102              return new WP_Error( 'no_wildcard_dns', $msg );
1103          }
1104      }
1105  
1106      return true;
1107  }
1108  
1109  /**
1110   * Creates WordPress network meta and sets the default values.
1111   *
1112   * @since 5.1.0
1113   *
1114   * @global wpdb $wpdb          WordPress database abstraction object.
1115   * @global int  $wp_db_version WordPress database version.
1116   *
1117   * @param int   $network_id Network ID to populate meta for.
1118   * @param array $meta       Optional. Custom meta $key => $value pairs to use. Default empty array.
1119   */
1120  function populate_network_meta( $network_id, array $meta = array() ) {
1121      global $wpdb, $wp_db_version;
1122  
1123      $network_id = (int) $network_id;
1124  
1125      $email             = ! empty( $meta['admin_email'] ) ? $meta['admin_email'] : '';
1126      $subdomain_install = isset( $meta['subdomain_install'] ) ? (int) $meta['subdomain_install'] : 0;
1127  
1128      // If a user with the provided email does not exist, default to the current user as the new network admin.
1129      $site_user = ! empty( $email ) ? get_user_by( 'email', $email ) : false;
1130      if ( false === $site_user ) {
1131          $site_user = wp_get_current_user();
1132      }
1133  
1134      if ( empty( $email ) ) {
1135          $email = $site_user->user_email;
1136      }
1137  
1138      $template       = get_option( 'template' );
1139      $stylesheet     = get_option( 'stylesheet' );
1140      $allowed_themes = array( $stylesheet => true );
1141  
1142      if ( $template != $stylesheet ) {
1143          $allowed_themes[ $template ] = true;
1144      }
1145  
1146      if ( WP_DEFAULT_THEME != $stylesheet && WP_DEFAULT_THEME != $template ) {
1147          $allowed_themes[ WP_DEFAULT_THEME ] = true;
1148      }
1149  
1150      // If WP_DEFAULT_THEME doesn't exist, also whitelist the latest core default theme.
1151      if ( ! wp_get_theme( WP_DEFAULT_THEME )->exists() ) {
1152          $core_default = WP_Theme::get_core_default_theme();
1153          if ( $core_default ) {
1154              $allowed_themes[ $core_default->get_stylesheet() ] = true;
1155          }
1156      }
1157  
1158      if ( function_exists( 'clean_network_cache' ) ) {
1159          clean_network_cache( $network_id );
1160      } else {
1161          wp_cache_delete( $network_id, 'networks' );
1162      }
1163  
1164      wp_cache_delete( 'networks_have_paths', 'site-options' );
1165  
1166      if ( ! is_multisite() ) {
1167          $site_admins = array( $site_user->user_login );
1168          $users       = get_users(
1169              array(
1170                  'fields' => array( 'user_login' ),
1171                  'role'   => 'administrator',
1172              )
1173          );
1174          if ( $users ) {
1175              foreach ( $users as $user ) {
1176                  $site_admins[] = $user->user_login;
1177              }
1178  
1179              $site_admins = array_unique( $site_admins );
1180          }
1181      } else {
1182          $site_admins = get_site_option( 'site_admins' );
1183      }
1184  
1185      /* translators: Do not translate USERNAME, SITE_NAME, BLOG_URL, PASSWORD: those are placeholders. */
1186      $welcome_email = __(
1187          'Howdy USERNAME,
1188  
1189  Your new SITE_NAME site has been successfully set up at:
1190  BLOG_URL
1191  
1192  You can log in to the administrator account with the following information:
1193  
1194  Username: USERNAME
1195  Password: PASSWORD
1196  Log in here: BLOG_URLwp-login.php
1197  
1198  We hope you enjoy your new site. Thanks!
1199  
1200  --The Team @ SITE_NAME'
1201      );
1202  
1203      $misc_exts        = array(
1204          // Images.
1205          'jpg',
1206          'jpeg',
1207          'png',
1208          'gif',
1209          // Video.
1210          'mov',
1211          'avi',
1212          'mpg',
1213          '3gp',
1214          '3g2',
1215          // "audio".
1216          'midi',
1217          'mid',
1218          // Miscellaneous.
1219          'pdf',
1220          'doc',
1221          'ppt',
1222          'odt',
1223          'pptx',
1224          'docx',
1225          'pps',
1226          'ppsx',
1227          'xls',
1228          'xlsx',
1229          'key',
1230      );
1231      $audio_exts       = wp_get_audio_extensions();
1232      $video_exts       = wp_get_video_extensions();
1233      $upload_filetypes = array_unique( array_merge( $misc_exts, $audio_exts, $video_exts ) );
1234  
1235      $sitemeta = array(
1236          'site_name'                   => __( 'My Network' ),
1237          'admin_email'                 => $email,
1238          'admin_user_id'               => $site_user->ID,
1239          'registration'                => 'none',
1240          'upload_filetypes'            => implode( ' ', $upload_filetypes ),
1241          'blog_upload_space'           => 100,
1242          'fileupload_maxk'             => 1500,
1243          'site_admins'                 => $site_admins,
1244          'allowedthemes'               => $allowed_themes,
1245          'illegal_names'               => array( 'www', 'web', 'root', 'admin', 'main', 'invite', 'administrator', 'files' ),
1246          'wpmu_upgrade_site'           => $wp_db_version,
1247          'welcome_email'               => $welcome_email,
1248          /* translators: %s: Site link. */
1249          'first_post'                  => __( 'Welcome to %s. This is your first post. Edit or delete it, then start writing!' ),
1250          // @todo - Network admins should have a method of editing the network siteurl (used for cookie hash).
1251          'siteurl'                     => get_option( 'siteurl' ) . '/',
1252          'add_new_users'               => '0',
1253          'upload_space_check_disabled' => is_multisite() ? get_site_option( 'upload_space_check_disabled' ) : '1',
1254          'subdomain_install'           => $subdomain_install,
1255          'global_terms_enabled'        => global_terms_enabled() ? '1' : '0',
1256          'ms_files_rewriting'          => is_multisite() ? get_site_option( 'ms_files_rewriting' ) : '0',
1257          'initial_db_version'          => get_option( 'initial_db_version' ),
1258          'active_sitewide_plugins'     => array(),
1259          'WPLANG'                      => get_locale(),
1260      );
1261      if ( ! $subdomain_install ) {
1262          $sitemeta['illegal_names'][] = 'blog';
1263      }
1264  
1265      $sitemeta = wp_parse_args( $meta, $sitemeta );
1266  
1267      /**
1268       * Filters meta for a network on creation.
1269       *
1270       * @since 3.7.0
1271       *
1272       * @param array $sitemeta   Associative array of network meta keys and values to be inserted.
1273       * @param int   $network_id ID of network to populate.
1274       */
1275      $sitemeta = apply_filters( 'populate_network_meta', $sitemeta, $network_id );
1276  
1277      $insert = '';
1278      foreach ( $sitemeta as $meta_key => $meta_value ) {
1279          if ( is_array( $meta_value ) ) {
1280              $meta_value = serialize( $meta_value );
1281          }
1282          if ( ! empty( $insert ) ) {
1283              $insert .= ', ';
1284          }
1285          $insert .= $wpdb->prepare( '( %d, %s, %s)', $network_id, $meta_key, $meta_value );
1286      }
1287      $wpdb->query( "INSERT INTO $wpdb->sitemeta ( site_id, meta_key, meta_value ) VALUES " . $insert ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
1288  }
1289  
1290  /**
1291   * Creates WordPress site meta and sets the default values.
1292   *
1293   * @since 5.1.0
1294   *
1295   * @global wpdb $wpdb WordPress database abstraction object.
1296   *
1297   * @param int   $site_id Site ID to populate meta for.
1298   * @param array $meta    Optional. Custom meta $key => $value pairs to use. Default empty array.
1299   */
1300  function populate_site_meta( $site_id, array $meta = array() ) {
1301      global $wpdb;
1302  
1303      $site_id = (int) $site_id;
1304  
1305      if ( ! is_site_meta_supported() ) {
1306          return;
1307      }
1308  
1309      if ( empty( $meta ) ) {
1310          return;
1311      }
1312  
1313      /**
1314       * Filters meta for a site on creation.
1315       *
1316       * @since 5.2.0
1317       *
1318       * @param array $meta    Associative array of site meta keys and values to be inserted.
1319       * @param int   $site_id ID of site to populate.
1320       */
1321      $site_meta = apply_filters( 'populate_site_meta', $meta, $site_id );
1322  
1323      $insert = '';
1324      foreach ( $site_meta as $meta_key => $meta_value ) {
1325          if ( is_array( $meta_value ) ) {
1326              $meta_value = serialize( $meta_value );
1327          }
1328          if ( ! empty( $insert ) ) {
1329              $insert .= ', ';
1330          }
1331          $insert .= $wpdb->prepare( '( %d, %s, %s)', $site_id, $meta_key, $meta_value );
1332      }
1333  
1334      $wpdb->query( "INSERT INTO $wpdb->blogmeta ( blog_id, meta_key, meta_value ) VALUES " . $insert ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
1335  
1336      wp_cache_delete( $site_id, 'blog_meta' );
1337      wp_cache_set_sites_last_changed();
1338  }


Generated: Tue Apr 7 01:00:07 2020 Cross-referenced by PHPXref 0.7.1