[ Index ]

PHP Cross Reference of WordPress Trunk (Updated Daily)

Search

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 'comment',
 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 WP_DEFAULT_THEME doesn't exist, fall back to the latest core default theme.
 373      $stylesheet = WP_DEFAULT_THEME;
 374      $template   = WP_DEFAULT_THEME;
 375      $theme      = wp_get_theme( WP_DEFAULT_THEME );
 376      if ( ! $theme->exists() ) {
 377          $theme = WP_Theme::get_core_default_theme();
 378      }
 379  
 380      // If we can't find a core default theme, WP_DEFAULT_THEME is the best we can do.
 381      if ( $theme ) {
 382          $stylesheet = $theme->get_stylesheet();
 383          $template   = $theme->get_template();
 384      }
 385  
 386      $timezone_string = '';
 387      $gmt_offset      = 0;
 388      /*
 389       * translators: default GMT offset or timezone string. Must be either a valid offset (-12 to 14)
 390       * or a valid timezone string (America/New_York). See https://www.php.net/manual/en/timezones.php
 391       * for all timezone strings supported by PHP.
 392       */
 393      $offset_or_tz = _x( '0', 'default GMT offset or timezone string' ); // phpcs:ignore WordPress.WP.I18n.NoEmptyStrings
 394      if ( is_numeric( $offset_or_tz ) ) {
 395          $gmt_offset = $offset_or_tz;
 396      } elseif ( $offset_or_tz && in_array( $offset_or_tz, timezone_identifiers_list(), true ) ) {
 397              $timezone_string = $offset_or_tz;
 398      }
 399  
 400      $defaults = array(
 401          'siteurl'                         => $guessurl,
 402          'home'                            => $guessurl,
 403          'blogname'                        => __( 'My Site' ),
 404          /* translators: Site tagline. */
 405          'blogdescription'                 => __( 'Just another WordPress site' ),
 406          'users_can_register'              => 0,
 407          'admin_email'                     => 'you@example.com',
 408          /* translators: Default start of the week. 0 = Sunday, 1 = Monday. */
 409          'start_of_week'                   => _x( '1', 'start of week' ),
 410          'use_balanceTags'                 => 0,
 411          'use_smilies'                     => 1,
 412          'require_name_email'              => 1,
 413          'comments_notify'                 => 1,
 414          'posts_per_rss'                   => 10,
 415          'rss_use_excerpt'                 => 0,
 416          'mailserver_url'                  => 'mail.example.com',
 417          'mailserver_login'                => 'login@example.com',
 418          'mailserver_pass'                 => 'password',
 419          'mailserver_port'                 => 110,
 420          'default_category'                => 1,
 421          'default_comment_status'          => 'open',
 422          'default_ping_status'             => 'open',
 423          'default_pingback_flag'           => 1,
 424          'posts_per_page'                  => 10,
 425          /* translators: Default date format, see https://www.php.net/date */
 426          'date_format'                     => __( 'F j, Y' ),
 427          /* translators: Default time format, see https://www.php.net/date */
 428          'time_format'                     => __( 'g:i a' ),
 429          /* translators: Links last updated date format, see https://www.php.net/date */
 430          'links_updated_date_format'       => __( 'F j, Y g:i a' ),
 431          'comment_moderation'              => 0,
 432          'moderation_notify'               => 1,
 433          'permalink_structure'             => '',
 434          'rewrite_rules'                   => '',
 435          'hack_file'                       => 0,
 436          'blog_charset'                    => 'UTF-8',
 437          'moderation_keys'                 => '',
 438          'active_plugins'                  => array(),
 439          'category_base'                   => '',
 440          'ping_sites'                      => 'http://rpc.pingomatic.com/',
 441          'comment_max_links'               => 2,
 442          'gmt_offset'                      => $gmt_offset,
 443  
 444          // 1.5.0
 445          'default_email_category'          => 1,
 446          'recently_edited'                 => '',
 447          'template'                        => $template,
 448          'stylesheet'                      => $stylesheet,
 449          'comment_whitelist'               => 1,
 450          'blacklist_keys'                  => '',
 451          'comment_registration'            => 0,
 452          'html_type'                       => 'text/html',
 453  
 454          // 1.5.1
 455          'use_trackback'                   => 0,
 456  
 457          // 2.0.0
 458          'default_role'                    => 'subscriber',
 459          'db_version'                      => $wp_db_version,
 460  
 461          // 2.0.1
 462          'uploads_use_yearmonth_folders'   => 1,
 463          'upload_path'                     => '',
 464  
 465          // 2.1.0
 466          'blog_public'                     => '1',
 467          'default_link_category'           => 2,
 468          'show_on_front'                   => 'posts',
 469  
 470          // 2.2.0
 471          'tag_base'                        => '',
 472  
 473          // 2.5.0
 474          'show_avatars'                    => '1',
 475          'avatar_rating'                   => 'G',
 476          'upload_url_path'                 => '',
 477          'thumbnail_size_w'                => 150,
 478          'thumbnail_size_h'                => 150,
 479          'thumbnail_crop'                  => 1,
 480          'medium_size_w'                   => 300,
 481          'medium_size_h'                   => 300,
 482  
 483          // 2.6.0
 484          'avatar_default'                  => 'mystery',
 485  
 486          // 2.7.0
 487          'large_size_w'                    => 1024,
 488          'large_size_h'                    => 1024,
 489          'image_default_link_type'         => 'none',
 490          'image_default_size'              => '',
 491          'image_default_align'             => '',
 492          'close_comments_for_old_posts'    => 0,
 493          'close_comments_days_old'         => 14,
 494          'thread_comments'                 => 1,
 495          'thread_comments_depth'           => 5,
 496          'page_comments'                   => 0,
 497          'comments_per_page'               => 50,
 498          'default_comments_page'           => 'newest',
 499          'comment_order'                   => 'asc',
 500          'sticky_posts'                    => array(),
 501          'widget_categories'               => array(),
 502          'widget_text'                     => array(),
 503          'widget_rss'                      => array(),
 504          'uninstall_plugins'               => array(),
 505  
 506          // 2.8.0
 507          'timezone_string'                 => $timezone_string,
 508  
 509          // 3.0.0
 510          'page_for_posts'                  => 0,
 511          'page_on_front'                   => 0,
 512  
 513          // 3.1.0
 514          'default_post_format'             => 0,
 515  
 516          // 3.5.0
 517          'link_manager_enabled'            => 0,
 518  
 519          // 4.3.0
 520          'finished_splitting_shared_terms' => 1,
 521          'site_icon'                       => 0,
 522  
 523          // 4.4.0
 524          'medium_large_size_w'             => 768,
 525          'medium_large_size_h'             => 0,
 526  
 527          // 4.9.6
 528          'wp_page_for_privacy_policy'      => 0,
 529  
 530          // 4.9.8
 531          'show_comments_cookies_opt_in'    => 1,
 532  
 533          // 5.3.0
 534          'admin_email_lifespan'            => ( time() + 6 * MONTH_IN_SECONDS ),
 535      );
 536  
 537      // 3.3.0
 538      if ( ! is_multisite() ) {
 539          $defaults['initial_db_version'] = ! empty( $wp_current_db_version ) && $wp_current_db_version < $wp_db_version
 540              ? $wp_current_db_version : $wp_db_version;
 541      }
 542  
 543      // 3.0.0 multisite.
 544      if ( is_multisite() ) {
 545          /* translators: %s: Network title. */
 546          $defaults['blogdescription']     = sprintf( __( 'Just another %s site' ), get_network()->site_name );
 547          $defaults['permalink_structure'] = '/%year%/%monthnum%/%day%/%postname%/';
 548      }
 549  
 550      $options = wp_parse_args( $options, $defaults );
 551  
 552      // Set autoload to no for these options.
 553      $fat_options = array( 'moderation_keys', 'recently_edited', 'blacklist_keys', 'uninstall_plugins' );
 554  
 555      $keys             = "'" . implode( "', '", array_keys( $options ) ) . "'";
 556      $existing_options = $wpdb->get_col( "SELECT option_name FROM $wpdb->options WHERE option_name in ( $keys )" ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
 557  
 558      $insert = '';
 559  
 560      foreach ( $options as $option => $value ) {
 561          if ( in_array( $option, $existing_options, true ) ) {
 562              continue;
 563          }
 564  
 565          if ( in_array( $option, $fat_options, true ) ) {
 566              $autoload = 'no';
 567          } else {
 568              $autoload = 'yes';
 569          }
 570  
 571          if ( is_array( $value ) ) {
 572              $value = serialize( $value );
 573          }
 574  
 575          if ( ! empty( $insert ) ) {
 576              $insert .= ', ';
 577          }
 578  
 579          $insert .= $wpdb->prepare( '(%s, %s, %s)', $option, $value, $autoload );
 580      }
 581  
 582      if ( ! empty( $insert ) ) {
 583          $wpdb->query( "INSERT INTO $wpdb->options (option_name, option_value, autoload) VALUES " . $insert ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
 584      }
 585  
 586      // In case it is set, but blank, update "home".
 587      if ( ! __get_option( 'home' ) ) {
 588          update_option( 'home', $guessurl );
 589      }
 590  
 591      // Delete unused options.
 592      $unusedoptions = array(
 593          'blodotgsping_url',
 594          'bodyterminator',
 595          'emailtestonly',
 596          'phoneemail_separator',
 597          'smilies_directory',
 598          'subjectprefix',
 599          'use_bbcode',
 600          'use_blodotgsping',
 601          'use_phoneemail',
 602          'use_quicktags',
 603          'use_weblogsping',
 604          'weblogs_cache_file',
 605          'use_preview',
 606          'use_htmltrans',
 607          'smilies_directory',
 608          'fileupload_allowedusers',
 609          'use_phoneemail',
 610          'default_post_status',
 611          'default_post_category',
 612          'archive_mode',
 613          'time_difference',
 614          'links_minadminlevel',
 615          'links_use_adminlevels',
 616          'links_rating_type',
 617          'links_rating_char',
 618          'links_rating_ignore_zero',
 619          'links_rating_single_image',
 620          'links_rating_image0',
 621          'links_rating_image1',
 622          'links_rating_image2',
 623          'links_rating_image3',
 624          'links_rating_image4',
 625          'links_rating_image5',
 626          'links_rating_image6',
 627          'links_rating_image7',
 628          'links_rating_image8',
 629          'links_rating_image9',
 630          'links_recently_updated_time',
 631          'links_recently_updated_prepend',
 632          'links_recently_updated_append',
 633          'weblogs_cacheminutes',
 634          'comment_allowed_tags',
 635          'search_engine_friendly_urls',
 636          'default_geourl_lat',
 637          'default_geourl_lon',
 638          'use_default_geourl',
 639          'weblogs_xml_url',
 640          'new_users_can_blog',
 641          '_wpnonce',
 642          '_wp_http_referer',
 643          'Update',
 644          'action',
 645          'rich_editing',
 646          'autosave_interval',
 647          'deactivated_plugins',
 648          'can_compress_scripts',
 649          'page_uris',
 650          'update_core',
 651          'update_plugins',
 652          'update_themes',
 653          'doing_cron',
 654          'random_seed',
 655          'rss_excerpt_length',
 656          'secret',
 657          'use_linksupdate',
 658          'default_comment_status_page',
 659          'wporg_popular_tags',
 660          'what_to_show',
 661          'rss_language',
 662          'language',
 663          'enable_xmlrpc',
 664          'enable_app',
 665          'embed_autourls',
 666          'default_post_edit_rows',
 667          'gzipcompression',
 668          'advanced_edit',
 669      );
 670      foreach ( $unusedoptions as $option ) {
 671          delete_option( $option );
 672      }
 673  
 674      // Delete obsolete magpie stuff.
 675      $wpdb->query( "DELETE FROM $wpdb->options WHERE option_name REGEXP '^rss_[0-9a-f]{32}(_ts)?$'" );
 676  
 677      // Clear expired transients.
 678      delete_expired_transients( true );
 679  }
 680  
 681  /**
 682   * Execute WordPress role creation for the various WordPress versions.
 683   *
 684   * @since 2.0.0
 685   */
 686  function populate_roles() {
 687      populate_roles_160();
 688      populate_roles_210();
 689      populate_roles_230();
 690      populate_roles_250();
 691      populate_roles_260();
 692      populate_roles_270();
 693      populate_roles_280();
 694      populate_roles_300();
 695  }
 696  
 697  /**
 698   * Create the roles for WordPress 2.0
 699   *
 700   * @since 2.0.0
 701   */
 702  function populate_roles_160() {
 703      // Add roles.
 704      add_role( 'administrator', 'Administrator' );
 705      add_role( 'editor', 'Editor' );
 706      add_role( 'author', 'Author' );
 707      add_role( 'contributor', 'Contributor' );
 708      add_role( 'subscriber', 'Subscriber' );
 709  
 710      // Add caps for Administrator role.
 711      $role = get_role( 'administrator' );
 712      $role->add_cap( 'switch_themes' );
 713      $role->add_cap( 'edit_themes' );
 714      $role->add_cap( 'activate_plugins' );
 715      $role->add_cap( 'edit_plugins' );
 716      $role->add_cap( 'edit_users' );
 717      $role->add_cap( 'edit_files' );
 718      $role->add_cap( 'manage_options' );
 719      $role->add_cap( 'moderate_comments' );
 720      $role->add_cap( 'manage_categories' );
 721      $role->add_cap( 'manage_links' );
 722      $role->add_cap( 'upload_files' );
 723      $role->add_cap( 'import' );
 724      $role->add_cap( 'unfiltered_html' );
 725      $role->add_cap( 'edit_posts' );
 726      $role->add_cap( 'edit_others_posts' );
 727      $role->add_cap( 'edit_published_posts' );
 728      $role->add_cap( 'publish_posts' );
 729      $role->add_cap( 'edit_pages' );
 730      $role->add_cap( 'read' );
 731      $role->add_cap( 'level_10' );
 732      $role->add_cap( 'level_9' );
 733      $role->add_cap( 'level_8' );
 734      $role->add_cap( 'level_7' );
 735      $role->add_cap( 'level_6' );
 736      $role->add_cap( 'level_5' );
 737      $role->add_cap( 'level_4' );
 738      $role->add_cap( 'level_3' );
 739      $role->add_cap( 'level_2' );
 740      $role->add_cap( 'level_1' );
 741      $role->add_cap( 'level_0' );
 742  
 743      // Add caps for Editor role.
 744      $role = get_role( 'editor' );
 745      $role->add_cap( 'moderate_comments' );
 746      $role->add_cap( 'manage_categories' );
 747      $role->add_cap( 'manage_links' );
 748      $role->add_cap( 'upload_files' );
 749      $role->add_cap( 'unfiltered_html' );
 750      $role->add_cap( 'edit_posts' );
 751      $role->add_cap( 'edit_others_posts' );
 752      $role->add_cap( 'edit_published_posts' );
 753      $role->add_cap( 'publish_posts' );
 754      $role->add_cap( 'edit_pages' );
 755      $role->add_cap( 'read' );
 756      $role->add_cap( 'level_7' );
 757      $role->add_cap( 'level_6' );
 758      $role->add_cap( 'level_5' );
 759      $role->add_cap( 'level_4' );
 760      $role->add_cap( 'level_3' );
 761      $role->add_cap( 'level_2' );
 762      $role->add_cap( 'level_1' );
 763      $role->add_cap( 'level_0' );
 764  
 765      // Add caps for Author role.
 766      $role = get_role( 'author' );
 767      $role->add_cap( 'upload_files' );
 768      $role->add_cap( 'edit_posts' );
 769      $role->add_cap( 'edit_published_posts' );
 770      $role->add_cap( 'publish_posts' );
 771      $role->add_cap( 'read' );
 772      $role->add_cap( 'level_2' );
 773      $role->add_cap( 'level_1' );
 774      $role->add_cap( 'level_0' );
 775  
 776      // Add caps for Contributor role.
 777      $role = get_role( 'contributor' );
 778      $role->add_cap( 'edit_posts' );
 779      $role->add_cap( 'read' );
 780      $role->add_cap( 'level_1' );
 781      $role->add_cap( 'level_0' );
 782  
 783      // Add caps for Subscriber role.
 784      $role = get_role( 'subscriber' );
 785      $role->add_cap( 'read' );
 786      $role->add_cap( 'level_0' );
 787  }
 788  
 789  /**
 790   * Create and modify WordPress roles for WordPress 2.1.
 791   *
 792   * @since 2.1.0
 793   */
 794  function populate_roles_210() {
 795      $roles = array( 'administrator', 'editor' );
 796      foreach ( $roles as $role ) {
 797          $role = get_role( $role );
 798          if ( empty( $role ) ) {
 799              continue;
 800          }
 801  
 802          $role->add_cap( 'edit_others_pages' );
 803          $role->add_cap( 'edit_published_pages' );
 804          $role->add_cap( 'publish_pages' );
 805          $role->add_cap( 'delete_pages' );
 806          $role->add_cap( 'delete_others_pages' );
 807          $role->add_cap( 'delete_published_pages' );
 808          $role->add_cap( 'delete_posts' );
 809          $role->add_cap( 'delete_others_posts' );
 810          $role->add_cap( 'delete_published_posts' );
 811          $role->add_cap( 'delete_private_posts' );
 812          $role->add_cap( 'edit_private_posts' );
 813          $role->add_cap( 'read_private_posts' );
 814          $role->add_cap( 'delete_private_pages' );
 815          $role->add_cap( 'edit_private_pages' );
 816          $role->add_cap( 'read_private_pages' );
 817      }
 818  
 819      $role = get_role( 'administrator' );
 820      if ( ! empty( $role ) ) {
 821          $role->add_cap( 'delete_users' );
 822          $role->add_cap( 'create_users' );
 823      }
 824  
 825      $role = get_role( 'author' );
 826      if ( ! empty( $role ) ) {
 827          $role->add_cap( 'delete_posts' );
 828          $role->add_cap( 'delete_published_posts' );
 829      }
 830  
 831      $role = get_role( 'contributor' );
 832      if ( ! empty( $role ) ) {
 833          $role->add_cap( 'delete_posts' );
 834      }
 835  }
 836  
 837  /**
 838   * Create and modify WordPress roles for WordPress 2.3.
 839   *
 840   * @since 2.3.0
 841   */
 842  function populate_roles_230() {
 843      $role = get_role( 'administrator' );
 844  
 845      if ( ! empty( $role ) ) {
 846          $role->add_cap( 'unfiltered_upload' );
 847      }
 848  }
 849  
 850  /**
 851   * Create and modify WordPress roles for WordPress 2.5.
 852   *
 853   * @since 2.5.0
 854   */
 855  function populate_roles_250() {
 856      $role = get_role( 'administrator' );
 857  
 858      if ( ! empty( $role ) ) {
 859          $role->add_cap( 'edit_dashboard' );
 860      }
 861  }
 862  
 863  /**
 864   * Create and modify WordPress roles for WordPress 2.6.
 865   *
 866   * @since 2.6.0
 867   */
 868  function populate_roles_260() {
 869      $role = get_role( 'administrator' );
 870  
 871      if ( ! empty( $role ) ) {
 872          $role->add_cap( 'update_plugins' );
 873          $role->add_cap( 'delete_plugins' );
 874      }
 875  }
 876  
 877  /**
 878   * Create and modify WordPress roles for WordPress 2.7.
 879   *
 880   * @since 2.7.0
 881   */
 882  function populate_roles_270() {
 883      $role = get_role( 'administrator' );
 884  
 885      if ( ! empty( $role ) ) {
 886          $role->add_cap( 'install_plugins' );
 887          $role->add_cap( 'update_themes' );
 888      }
 889  }
 890  
 891  /**
 892   * Create and modify WordPress roles for WordPress 2.8.
 893   *
 894   * @since 2.8.0
 895   */
 896  function populate_roles_280() {
 897      $role = get_role( 'administrator' );
 898  
 899      if ( ! empty( $role ) ) {
 900          $role->add_cap( 'install_themes' );
 901      }
 902  }
 903  
 904  /**
 905   * Create and modify WordPress roles for WordPress 3.0.
 906   *
 907   * @since 3.0.0
 908   */
 909  function populate_roles_300() {
 910      $role = get_role( 'administrator' );
 911  
 912      if ( ! empty( $role ) ) {
 913          $role->add_cap( 'update_core' );
 914          $role->add_cap( 'list_users' );
 915          $role->add_cap( 'remove_users' );
 916          $role->add_cap( 'promote_users' );
 917          $role->add_cap( 'edit_theme_options' );
 918          $role->add_cap( 'delete_themes' );
 919          $role->add_cap( 'export' );
 920      }
 921  }
 922  
 923  if ( ! function_exists( 'install_network' ) ) :
 924      /**
 925       * Install Network.
 926       *
 927       * @since 3.0.0
 928       */
 929  	function install_network() {
 930          if ( ! defined( 'WP_INSTALLING_NETWORK' ) ) {
 931              define( 'WP_INSTALLING_NETWORK', true );
 932          }
 933  
 934          dbDelta( wp_get_db_schema( 'global' ) );
 935      }
 936  endif;
 937  
 938  /**
 939   * Populate network settings.
 940   *
 941   * @since 3.0.0
 942   *
 943   * @global wpdb       $wpdb         WordPress database abstraction object.
 944   * @global object     $current_site
 945   * @global WP_Rewrite $wp_rewrite   WordPress rewrite component.
 946   *
 947   * @param int    $network_id        ID of network to populate.
 948   * @param string $domain            The domain name for the network (eg. "example.com").
 949   * @param string $email             Email address for the network administrator.
 950   * @param string $site_name         The name of the network.
 951   * @param string $path              Optional. The path to append to the network's domain name. Default '/'.
 952   * @param bool   $subdomain_install Optional. Whether the network is a subdomain installation or a subdirectory installation.
 953   *                                  Default false, meaning the network is a subdirectory installation.
 954   * @return bool|WP_Error True on success, or WP_Error on warning (with the installation otherwise successful,
 955   *                       so the error code must be checked) or failure.
 956   */
 957  function populate_network( $network_id = 1, $domain = '', $email = '', $site_name = '', $path = '/', $subdomain_install = false ) {
 958      global $wpdb, $current_site, $wp_rewrite;
 959  
 960      $errors = new WP_Error();
 961      if ( '' === $domain ) {
 962          $errors->add( 'empty_domain', __( 'You must provide a domain name.' ) );
 963      }
 964      if ( '' === $site_name ) {
 965          $errors->add( 'empty_sitename', __( 'You must provide a name for your network of sites.' ) );
 966      }
 967  
 968      // Check for network collision.
 969      $network_exists = false;
 970      if ( is_multisite() ) {
 971          if ( get_network( (int) $network_id ) ) {
 972              $errors->add( 'siteid_exists', __( 'The network already exists.' ) );
 973          }
 974      } else {
 975          if ( $network_id == $wpdb->get_var( $wpdb->prepare( "SELECT id FROM $wpdb->site WHERE id = %d", $network_id ) ) ) {
 976              $errors->add( 'siteid_exists', __( 'The network already exists.' ) );
 977          }
 978      }
 979  
 980      if ( ! is_email( $email ) ) {
 981          $errors->add( 'invalid_email', __( 'You must provide a valid email address.' ) );
 982      }
 983  
 984      if ( $errors->has_errors() ) {
 985          return $errors;
 986      }
 987  
 988      if ( 1 == $network_id ) {
 989          $wpdb->insert(
 990              $wpdb->site,
 991              array(
 992                  'domain' => $domain,
 993                  'path'   => $path,
 994              )
 995          );
 996          $network_id = $wpdb->insert_id;
 997      } else {
 998          $wpdb->insert(
 999              $wpdb->site,
1000              array(
1001                  'domain' => $domain,
1002                  'path'   => $path,
1003                  'id'     => $network_id,
1004              )
1005          );
1006      }
1007  
1008      populate_network_meta(
1009          $network_id,
1010          array(
1011              'admin_email'       => $email,
1012              'site_name'         => $site_name,
1013              'subdomain_install' => $subdomain_install,
1014          )
1015      );
1016  
1017      $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 ) ) );
1018  
1019      /*
1020       * When upgrading from single to multisite, assume the current site will
1021       * become the main site of the network. When using populate_network()
1022       * to create another network in an existing multisite environment, skip
1023       * these steps since the main site of the new network has not yet been
1024       * created.
1025       */
1026      if ( ! is_multisite() ) {
1027          $current_site            = new stdClass;
1028          $current_site->domain    = $domain;
1029          $current_site->path      = $path;
1030          $current_site->site_name = ucfirst( $domain );
1031          $wpdb->insert(
1032              $wpdb->blogs,
1033              array(
1034                  'site_id'    => $network_id,
1035                  'blog_id'    => 1,
1036                  'domain'     => $domain,
1037                  'path'       => $path,
1038                  'registered' => current_time( 'mysql' ),
1039              )
1040          );
1041          $current_site->blog_id = $wpdb->insert_id;
1042          update_user_meta( $site_user->ID, 'source_domain', $domain );
1043          update_user_meta( $site_user->ID, 'primary_blog', $current_site->blog_id );
1044  
1045          if ( $subdomain_install ) {
1046              $wp_rewrite->set_permalink_structure( '/%year%/%monthnum%/%day%/%postname%/' );
1047          } else {
1048              $wp_rewrite->set_permalink_structure( '/blog/%year%/%monthnum%/%day%/%postname%/' );
1049          }
1050  
1051          flush_rewrite_rules();
1052  
1053          if ( ! $subdomain_install ) {
1054              return true;
1055          }
1056  
1057          $vhost_ok = false;
1058          $errstr   = '';
1059          $hostname = substr( md5( time() ), 0, 6 ) . '.' . $domain; // Very random hostname!
1060          $page     = wp_remote_get(
1061              'http://' . $hostname,
1062              array(
1063                  'timeout'     => 5,
1064                  'httpversion' => '1.1',
1065              )
1066          );
1067          if ( is_wp_error( $page ) ) {
1068              $errstr = $page->get_error_message();
1069          } elseif ( 200 == wp_remote_retrieve_response_code( $page ) ) {
1070                  $vhost_ok = true;
1071          }
1072  
1073          if ( ! $vhost_ok ) {
1074              $msg = '<p><strong>' . __( 'Warning! Wildcard DNS may not be configured correctly!' ) . '</strong></p>';
1075  
1076              $msg .= '<p>' . sprintf(
1077                  /* translators: %s: Host name. */
1078                  __( 'The installer attempted to contact a random hostname (%s) on your domain.' ),
1079                  '<code>' . $hostname . '</code>'
1080              );
1081              if ( ! empty( $errstr ) ) {
1082                  /* translators: %s: Error message. */
1083                  $msg .= ' ' . sprintf( __( 'This resulted in an error message: %s' ), '<code>' . $errstr . '</code>' );
1084              }
1085              $msg .= '</p>';
1086  
1087              $msg .= '<p>' . sprintf(
1088                  /* translators: %s: Asterisk symbol (*). */
1089                  __( '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.' ),
1090                  '<code>*</code>'
1091              ) . '</p>';
1092  
1093              $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>';
1094  
1095              return new WP_Error( 'no_wildcard_dns', $msg );
1096          }
1097      }
1098  
1099      return true;
1100  }
1101  
1102  /**
1103   * Creates WordPress network meta and sets the default values.
1104   *
1105   * @since 5.1.0
1106   *
1107   * @global wpdb $wpdb          WordPress database abstraction object.
1108   * @global int  $wp_db_version WordPress database version.
1109   *
1110   * @param int   $network_id Network ID to populate meta for.
1111   * @param array $meta       Optional. Custom meta $key => $value pairs to use. Default empty array.
1112   */
1113  function populate_network_meta( $network_id, array $meta = array() ) {
1114      global $wpdb, $wp_db_version;
1115  
1116      $network_id = (int) $network_id;
1117  
1118      $email             = ! empty( $meta['admin_email'] ) ? $meta['admin_email'] : '';
1119      $subdomain_install = isset( $meta['subdomain_install'] ) ? (int) $meta['subdomain_install'] : 0;
1120  
1121      // If a user with the provided email does not exist, default to the current user as the new network admin.
1122      $site_user = ! empty( $email ) ? get_user_by( 'email', $email ) : false;
1123      if ( false === $site_user ) {
1124          $site_user = wp_get_current_user();
1125      }
1126  
1127      if ( empty( $email ) ) {
1128          $email = $site_user->user_email;
1129      }
1130  
1131      $template       = get_option( 'template' );
1132      $stylesheet     = get_option( 'stylesheet' );
1133      $allowed_themes = array( $stylesheet => true );
1134  
1135      if ( $template != $stylesheet ) {
1136          $allowed_themes[ $template ] = true;
1137      }
1138  
1139      if ( WP_DEFAULT_THEME != $stylesheet && WP_DEFAULT_THEME != $template ) {
1140          $allowed_themes[ WP_DEFAULT_THEME ] = true;
1141      }
1142  
1143      // If WP_DEFAULT_THEME doesn't exist, also whitelist the latest core default theme.
1144      if ( ! wp_get_theme( WP_DEFAULT_THEME )->exists() ) {
1145          $core_default = WP_Theme::get_core_default_theme();
1146          if ( $core_default ) {
1147              $allowed_themes[ $core_default->get_stylesheet() ] = true;
1148          }
1149      }
1150  
1151      if ( function_exists( 'clean_network_cache' ) ) {
1152          clean_network_cache( $network_id );
1153      } else {
1154          wp_cache_delete( $network_id, 'networks' );
1155      }
1156  
1157      wp_cache_delete( 'networks_have_paths', 'site-options' );
1158  
1159      if ( ! is_multisite() ) {
1160          $site_admins = array( $site_user->user_login );
1161          $users       = get_users(
1162              array(
1163                  'fields' => array( 'user_login' ),
1164                  'role'   => 'administrator',
1165              )
1166          );
1167          if ( $users ) {
1168              foreach ( $users as $user ) {
1169                  $site_admins[] = $user->user_login;
1170              }
1171  
1172              $site_admins = array_unique( $site_admins );
1173          }
1174      } else {
1175          $site_admins = get_site_option( 'site_admins' );
1176      }
1177  
1178      /* translators: Do not translate USERNAME, SITE_NAME, BLOG_URL, PASSWORD: those are placeholders. */
1179      $welcome_email = __(
1180          'Howdy USERNAME,
1181  
1182  Your new SITE_NAME site has been successfully set up at:
1183  BLOG_URL
1184  
1185  You can log in to the administrator account with the following information:
1186  
1187  Username: USERNAME
1188  Password: PASSWORD
1189  Log in here: BLOG_URLwp-login.php
1190  
1191  We hope you enjoy your new site. Thanks!
1192  
1193  --The Team @ SITE_NAME'
1194      );
1195  
1196      $misc_exts        = array(
1197          // Images.
1198          'jpg',
1199          'jpeg',
1200          'png',
1201          'gif',
1202          // Video.
1203          'mov',
1204          'avi',
1205          'mpg',
1206          '3gp',
1207          '3g2',
1208          // "audio".
1209          'midi',
1210          'mid',
1211          // Miscellaneous.
1212          'pdf',
1213          'doc',
1214          'ppt',
1215          'odt',
1216          'pptx',
1217          'docx',
1218          'pps',
1219          'ppsx',
1220          'xls',
1221          'xlsx',
1222          'key',
1223      );
1224      $audio_exts       = wp_get_audio_extensions();
1225      $video_exts       = wp_get_video_extensions();
1226      $upload_filetypes = array_unique( array_merge( $misc_exts, $audio_exts, $video_exts ) );
1227  
1228      $sitemeta = array(
1229          'site_name'                   => __( 'My Network' ),
1230          'admin_email'                 => $email,
1231          'admin_user_id'               => $site_user->ID,
1232          'registration'                => 'none',
1233          'upload_filetypes'            => implode( ' ', $upload_filetypes ),
1234          'blog_upload_space'           => 100,
1235          'fileupload_maxk'             => 1500,
1236          'site_admins'                 => $site_admins,
1237          'allowedthemes'               => $allowed_themes,
1238          'illegal_names'               => array( 'www', 'web', 'root', 'admin', 'main', 'invite', 'administrator', 'files' ),
1239          'wpmu_upgrade_site'           => $wp_db_version,
1240          'welcome_email'               => $welcome_email,
1241          /* translators: %s: Site link. */
1242          'first_post'                  => __( 'Welcome to %s. This is your first post. Edit or delete it, then start writing!' ),
1243          // @todo - Network admins should have a method of editing the network siteurl (used for cookie hash).
1244          'siteurl'                     => get_option( 'siteurl' ) . '/',
1245          'add_new_users'               => '0',
1246          'upload_space_check_disabled' => is_multisite() ? get_site_option( 'upload_space_check_disabled' ) : '1',
1247          'subdomain_install'           => $subdomain_install,
1248          'global_terms_enabled'        => global_terms_enabled() ? '1' : '0',
1249          'ms_files_rewriting'          => is_multisite() ? get_site_option( 'ms_files_rewriting' ) : '0',
1250          'initial_db_version'          => get_option( 'initial_db_version' ),
1251          'active_sitewide_plugins'     => array(),
1252          'WPLANG'                      => get_locale(),
1253      );
1254      if ( ! $subdomain_install ) {
1255          $sitemeta['illegal_names'][] = 'blog';
1256      }
1257  
1258      $sitemeta = wp_parse_args( $meta, $sitemeta );
1259  
1260      /**
1261       * Filters meta for a network on creation.
1262       *
1263       * @since 3.7.0
1264       *
1265       * @param array $sitemeta   Associative array of network meta keys and values to be inserted.
1266       * @param int   $network_id ID of network to populate.
1267       */
1268      $sitemeta = apply_filters( 'populate_network_meta', $sitemeta, $network_id );
1269  
1270      $insert = '';
1271      foreach ( $sitemeta as $meta_key => $meta_value ) {
1272          if ( is_array( $meta_value ) ) {
1273              $meta_value = serialize( $meta_value );
1274          }
1275          if ( ! empty( $insert ) ) {
1276              $insert .= ', ';
1277          }
1278          $insert .= $wpdb->prepare( '( %d, %s, %s)', $network_id, $meta_key, $meta_value );
1279      }
1280      $wpdb->query( "INSERT INTO $wpdb->sitemeta ( site_id, meta_key, meta_value ) VALUES " . $insert ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
1281  }
1282  
1283  /**
1284   * Creates WordPress site meta and sets the default values.
1285   *
1286   * @since 5.1.0
1287   *
1288   * @global wpdb $wpdb WordPress database abstraction object.
1289   *
1290   * @param int   $site_id Site ID to populate meta for.
1291   * @param array $meta    Optional. Custom meta $key => $value pairs to use. Default empty array.
1292   */
1293  function populate_site_meta( $site_id, array $meta = array() ) {
1294      global $wpdb;
1295  
1296      $site_id = (int) $site_id;
1297  
1298      if ( ! is_site_meta_supported() ) {
1299          return;
1300      }
1301  
1302      if ( empty( $meta ) ) {
1303          return;
1304      }
1305  
1306      /**
1307       * Filters meta for a site on creation.
1308       *
1309       * @since 5.2.0
1310       *
1311       * @param array $meta    Associative array of site meta keys and values to be inserted.
1312       * @param int   $site_id ID of site to populate.
1313       */
1314      $site_meta = apply_filters( 'populate_site_meta', $meta, $site_id );
1315  
1316      $insert = '';
1317      foreach ( $site_meta as $meta_key => $meta_value ) {
1318          if ( is_array( $meta_value ) ) {
1319              $meta_value = serialize( $meta_value );
1320          }
1321          if ( ! empty( $insert ) ) {
1322              $insert .= ', ';
1323          }
1324          $insert .= $wpdb->prepare( '( %d, %s, %s)', $site_id, $meta_key, $meta_value );
1325      }
1326  
1327      $wpdb->query( "INSERT INTO $wpdb->blogmeta ( blog_id, meta_key, meta_value ) VALUES " . $insert ); // phpcs:ignore WordPress.DB.PreparedSQL.NotPrepared
1328  
1329      wp_cache_delete( $site_id, 'blog_meta' );
1330      wp_cache_set_sites_last_changed();
1331  }


Generated : Sat Jun 6 08:20:01 2020 Cross-referenced by PHPXref