wp/wp-admin/includes/schema.php
changeset 0 d970ebf37754
child 5 5e2f62d02dcd
equal deleted inserted replaced
-1:000000000000 0:d970ebf37754
       
     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 // Declare these as global in case schema.php is included from a function.
       
    12 global $wpdb, $wp_queries, $charset_collate;
       
    13 
       
    14 /**
       
    15  * The database character collate.
       
    16  * @var string
       
    17  * @global string
       
    18  * @name $charset_collate
       
    19  */
       
    20 $charset_collate = $wpdb->get_charset_collate();
       
    21 
       
    22 /**
       
    23  * Retrieve the SQL for creating database tables.
       
    24  *
       
    25  * @since 3.3.0
       
    26  *
       
    27  * @param string $scope Optional. The tables for which to retrieve SQL. Can be all, global, ms_global, or blog tables. Defaults to all.
       
    28  * @param int $blog_id Optional. The blog ID for which to retrieve SQL. Default is the current blog ID.
       
    29  * @return string The SQL needed to create the requested tables.
       
    30  */
       
    31 function wp_get_db_schema( $scope = 'all', $blog_id = null ) {
       
    32 	global $wpdb;
       
    33 
       
    34 	$charset_collate = '';
       
    35 
       
    36 	if ( ! empty($wpdb->charset) )
       
    37 		$charset_collate = "DEFAULT CHARACTER SET $wpdb->charset";
       
    38 	if ( ! empty($wpdb->collate) )
       
    39 		$charset_collate .= " COLLATE $wpdb->collate";
       
    40 
       
    41 	if ( $blog_id && $blog_id != $wpdb->blogid )
       
    42 		$old_blog_id = $wpdb->set_blog_id( $blog_id );
       
    43 
       
    44 	// Engage multisite if in the middle of turning it on from network.php.
       
    45 	$is_multisite = is_multisite() || ( defined( 'WP_INSTALLING_NETWORK' ) && WP_INSTALLING_NETWORK );
       
    46 
       
    47 	// Blog specific tables.
       
    48 	$blog_tables = "CREATE TABLE $wpdb->terms (
       
    49  term_id bigint(20) unsigned NOT NULL auto_increment,
       
    50  name varchar(200) NOT NULL default '',
       
    51  slug varchar(200) NOT NULL default '',
       
    52  term_group bigint(10) NOT NULL default 0,
       
    53  PRIMARY KEY  (term_id),
       
    54  UNIQUE KEY slug (slug),
       
    55  KEY name (name)
       
    56 ) $charset_collate;
       
    57 CREATE TABLE $wpdb->term_taxonomy (
       
    58  term_taxonomy_id bigint(20) unsigned NOT NULL auto_increment,
       
    59  term_id bigint(20) unsigned NOT NULL default 0,
       
    60  taxonomy varchar(32) NOT NULL default '',
       
    61  description longtext NOT NULL,
       
    62  parent bigint(20) unsigned NOT NULL default 0,
       
    63  count bigint(20) NOT NULL default 0,
       
    64  PRIMARY KEY  (term_taxonomy_id),
       
    65  UNIQUE KEY term_id_taxonomy (term_id,taxonomy),
       
    66  KEY taxonomy (taxonomy)
       
    67 ) $charset_collate;
       
    68 CREATE TABLE $wpdb->term_relationships (
       
    69  object_id bigint(20) unsigned NOT NULL default 0,
       
    70  term_taxonomy_id bigint(20) unsigned NOT NULL default 0,
       
    71  term_order int(11) NOT NULL default 0,
       
    72  PRIMARY KEY  (object_id,term_taxonomy_id),
       
    73  KEY term_taxonomy_id (term_taxonomy_id)
       
    74 ) $charset_collate;
       
    75 CREATE TABLE $wpdb->commentmeta (
       
    76   meta_id bigint(20) unsigned NOT NULL auto_increment,
       
    77   comment_id bigint(20) unsigned NOT NULL default '0',
       
    78   meta_key varchar(255) default NULL,
       
    79   meta_value longtext,
       
    80   PRIMARY KEY  (meta_id),
       
    81   KEY comment_id (comment_id),
       
    82   KEY meta_key (meta_key)
       
    83 ) $charset_collate;
       
    84 CREATE TABLE $wpdb->comments (
       
    85   comment_ID bigint(20) unsigned NOT NULL auto_increment,
       
    86   comment_post_ID bigint(20) unsigned NOT NULL default '0',
       
    87   comment_author tinytext NOT NULL,
       
    88   comment_author_email varchar(100) NOT NULL default '',
       
    89   comment_author_url varchar(200) NOT NULL default '',
       
    90   comment_author_IP varchar(100) NOT NULL default '',
       
    91   comment_date datetime NOT NULL default '0000-00-00 00:00:00',
       
    92   comment_date_gmt datetime NOT NULL default '0000-00-00 00:00:00',
       
    93   comment_content text NOT NULL,
       
    94   comment_karma int(11) NOT NULL default '0',
       
    95   comment_approved varchar(20) NOT NULL default '1',
       
    96   comment_agent varchar(255) NOT NULL default '',
       
    97   comment_type varchar(20) NOT NULL default '',
       
    98   comment_parent bigint(20) unsigned NOT NULL default '0',
       
    99   user_id bigint(20) unsigned NOT NULL default '0',
       
   100   PRIMARY KEY  (comment_ID),
       
   101   KEY comment_post_ID (comment_post_ID),
       
   102   KEY comment_approved_date_gmt (comment_approved,comment_date_gmt),
       
   103   KEY comment_date_gmt (comment_date_gmt),
       
   104   KEY comment_parent (comment_parent)
       
   105 ) $charset_collate;
       
   106 CREATE TABLE $wpdb->links (
       
   107   link_id bigint(20) unsigned NOT NULL auto_increment,
       
   108   link_url varchar(255) NOT NULL default '',
       
   109   link_name varchar(255) NOT NULL default '',
       
   110   link_image varchar(255) NOT NULL default '',
       
   111   link_target varchar(25) NOT NULL default '',
       
   112   link_description varchar(255) NOT NULL default '',
       
   113   link_visible varchar(20) NOT NULL default 'Y',
       
   114   link_owner bigint(20) unsigned NOT NULL default '1',
       
   115   link_rating int(11) NOT NULL default '0',
       
   116   link_updated datetime NOT NULL default '0000-00-00 00:00:00',
       
   117   link_rel varchar(255) NOT NULL default '',
       
   118   link_notes mediumtext NOT NULL,
       
   119   link_rss varchar(255) NOT NULL default '',
       
   120   PRIMARY KEY  (link_id),
       
   121   KEY link_visible (link_visible)
       
   122 ) $charset_collate;
       
   123 CREATE TABLE $wpdb->options (
       
   124   option_id bigint(20) unsigned NOT NULL auto_increment,
       
   125   option_name varchar(64) NOT NULL default '',
       
   126   option_value longtext NOT NULL,
       
   127   autoload varchar(20) NOT NULL default 'yes',
       
   128   PRIMARY KEY  (option_id),
       
   129   UNIQUE KEY option_name (option_name)
       
   130 ) $charset_collate;
       
   131 CREATE TABLE $wpdb->postmeta (
       
   132   meta_id bigint(20) unsigned NOT NULL auto_increment,
       
   133   post_id bigint(20) unsigned NOT NULL default '0',
       
   134   meta_key varchar(255) default NULL,
       
   135   meta_value longtext,
       
   136   PRIMARY KEY  (meta_id),
       
   137   KEY post_id (post_id),
       
   138   KEY meta_key (meta_key)
       
   139 ) $charset_collate;
       
   140 CREATE TABLE $wpdb->posts (
       
   141   ID bigint(20) unsigned NOT NULL auto_increment,
       
   142   post_author bigint(20) unsigned NOT NULL default '0',
       
   143   post_date datetime NOT NULL default '0000-00-00 00:00:00',
       
   144   post_date_gmt datetime NOT NULL default '0000-00-00 00:00:00',
       
   145   post_content longtext NOT NULL,
       
   146   post_title text NOT NULL,
       
   147   post_excerpt text NOT NULL,
       
   148   post_status varchar(20) NOT NULL default 'publish',
       
   149   comment_status varchar(20) NOT NULL default 'open',
       
   150   ping_status varchar(20) NOT NULL default 'open',
       
   151   post_password varchar(20) NOT NULL default '',
       
   152   post_name varchar(200) NOT NULL default '',
       
   153   to_ping text NOT NULL,
       
   154   pinged text NOT NULL,
       
   155   post_modified datetime NOT NULL default '0000-00-00 00:00:00',
       
   156   post_modified_gmt datetime NOT NULL default '0000-00-00 00:00:00',
       
   157   post_content_filtered longtext NOT NULL,
       
   158   post_parent bigint(20) unsigned NOT NULL default '0',
       
   159   guid varchar(255) NOT NULL default '',
       
   160   menu_order int(11) NOT NULL default '0',
       
   161   post_type varchar(20) NOT NULL default 'post',
       
   162   post_mime_type varchar(100) NOT NULL default '',
       
   163   comment_count bigint(20) NOT NULL default '0',
       
   164   PRIMARY KEY  (ID),
       
   165   KEY post_name (post_name),
       
   166   KEY type_status_date (post_type,post_status,post_date,ID),
       
   167   KEY post_parent (post_parent),
       
   168   KEY post_author (post_author)
       
   169 ) $charset_collate;\n";
       
   170 
       
   171 	// Single site users table. The multisite flavor of the users table is handled below.
       
   172 	$users_single_table = "CREATE TABLE $wpdb->users (
       
   173   ID bigint(20) unsigned NOT NULL auto_increment,
       
   174   user_login varchar(60) NOT NULL default '',
       
   175   user_pass varchar(64) NOT NULL default '',
       
   176   user_nicename varchar(50) NOT NULL default '',
       
   177   user_email varchar(100) NOT NULL default '',
       
   178   user_url varchar(100) NOT NULL default '',
       
   179   user_registered datetime NOT NULL default '0000-00-00 00:00:00',
       
   180   user_activation_key varchar(60) NOT NULL default '',
       
   181   user_status int(11) NOT NULL default '0',
       
   182   display_name varchar(250) NOT NULL default '',
       
   183   PRIMARY KEY  (ID),
       
   184   KEY user_login_key (user_login),
       
   185   KEY user_nicename (user_nicename)
       
   186 ) $charset_collate;\n";
       
   187 
       
   188 	// Multisite users table
       
   189 	$users_multi_table = "CREATE TABLE $wpdb->users (
       
   190   ID bigint(20) unsigned NOT NULL auto_increment,
       
   191   user_login varchar(60) NOT NULL default '',
       
   192   user_pass varchar(64) NOT NULL default '',
       
   193   user_nicename varchar(50) NOT NULL default '',
       
   194   user_email varchar(100) NOT NULL default '',
       
   195   user_url varchar(100) NOT NULL default '',
       
   196   user_registered datetime NOT NULL default '0000-00-00 00:00:00',
       
   197   user_activation_key varchar(60) NOT NULL default '',
       
   198   user_status int(11) NOT NULL default '0',
       
   199   display_name varchar(250) NOT NULL default '',
       
   200   spam tinyint(2) NOT NULL default '0',
       
   201   deleted tinyint(2) NOT NULL default '0',
       
   202   PRIMARY KEY  (ID),
       
   203   KEY user_login_key (user_login),
       
   204   KEY user_nicename (user_nicename)
       
   205 ) $charset_collate;\n";
       
   206 
       
   207 	// usermeta
       
   208 	$usermeta_table = "CREATE TABLE $wpdb->usermeta (
       
   209   umeta_id bigint(20) unsigned NOT NULL auto_increment,
       
   210   user_id bigint(20) unsigned NOT NULL default '0',
       
   211   meta_key varchar(255) default NULL,
       
   212   meta_value longtext,
       
   213   PRIMARY KEY  (umeta_id),
       
   214   KEY user_id (user_id),
       
   215   KEY meta_key (meta_key)
       
   216 ) $charset_collate;\n";
       
   217 
       
   218 	// Global tables
       
   219 	if ( $is_multisite )
       
   220 		$global_tables = $users_multi_table . $usermeta_table;
       
   221 	else
       
   222 		$global_tables = $users_single_table . $usermeta_table;
       
   223 
       
   224 	// Multisite global tables.
       
   225 	$ms_global_tables = "CREATE TABLE $wpdb->blogs (
       
   226   blog_id bigint(20) NOT NULL auto_increment,
       
   227   site_id bigint(20) NOT NULL default '0',
       
   228   domain varchar(200) NOT NULL default '',
       
   229   path varchar(100) NOT NULL default '',
       
   230   registered datetime NOT NULL default '0000-00-00 00:00:00',
       
   231   last_updated datetime NOT NULL default '0000-00-00 00:00:00',
       
   232   public tinyint(2) NOT NULL default '1',
       
   233   archived tinyint(2) NOT NULL default '0',
       
   234   mature tinyint(2) NOT NULL default '0',
       
   235   spam tinyint(2) NOT NULL default '0',
       
   236   deleted tinyint(2) NOT NULL default '0',
       
   237   lang_id int(11) NOT NULL default '0',
       
   238   PRIMARY KEY  (blog_id),
       
   239   KEY domain (domain(50),path(5)),
       
   240   KEY lang_id (lang_id)
       
   241 ) $charset_collate;
       
   242 CREATE TABLE $wpdb->blog_versions (
       
   243   blog_id bigint(20) NOT NULL default '0',
       
   244   db_version varchar(20) NOT NULL default '',
       
   245   last_updated datetime NOT NULL default '0000-00-00 00:00:00',
       
   246   PRIMARY KEY  (blog_id),
       
   247   KEY db_version (db_version)
       
   248 ) $charset_collate;
       
   249 CREATE TABLE $wpdb->registration_log (
       
   250   ID bigint(20) NOT NULL auto_increment,
       
   251   email varchar(255) NOT NULL default '',
       
   252   IP varchar(30) NOT NULL default '',
       
   253   blog_id bigint(20) NOT NULL default '0',
       
   254   date_registered datetime NOT NULL default '0000-00-00 00:00:00',
       
   255   PRIMARY KEY  (ID),
       
   256   KEY IP (IP)
       
   257 ) $charset_collate;
       
   258 CREATE TABLE $wpdb->site (
       
   259   id bigint(20) NOT NULL auto_increment,
       
   260   domain varchar(200) NOT NULL default '',
       
   261   path varchar(100) NOT NULL default '',
       
   262   PRIMARY KEY  (id),
       
   263   KEY domain (domain,path)
       
   264 ) $charset_collate;
       
   265 CREATE TABLE $wpdb->sitemeta (
       
   266   meta_id bigint(20) NOT NULL auto_increment,
       
   267   site_id bigint(20) NOT NULL default '0',
       
   268   meta_key varchar(255) default NULL,
       
   269   meta_value longtext,
       
   270   PRIMARY KEY  (meta_id),
       
   271   KEY meta_key (meta_key),
       
   272   KEY site_id (site_id)
       
   273 ) $charset_collate;
       
   274 CREATE TABLE $wpdb->signups (
       
   275   signup_id bigint(20) NOT NULL auto_increment,
       
   276   domain varchar(200) NOT NULL default '',
       
   277   path varchar(100) NOT NULL default '',
       
   278   title longtext NOT NULL,
       
   279   user_login varchar(60) NOT NULL default '',
       
   280   user_email varchar(100) NOT NULL default '',
       
   281   registered datetime NOT NULL default '0000-00-00 00:00:00',
       
   282   activated datetime NOT NULL default '0000-00-00 00:00:00',
       
   283   active tinyint(1) NOT NULL default '0',
       
   284   activation_key varchar(50) NOT NULL default '',
       
   285   meta longtext,
       
   286   PRIMARY KEY  (signup_id),
       
   287   KEY activation_key (activation_key),
       
   288   KEY user_email (user_email),
       
   289   KEY user_login_email (user_login,user_email),
       
   290   KEY domain_path (domain,path)
       
   291 ) $charset_collate;";
       
   292 
       
   293 	switch ( $scope ) {
       
   294 		case 'blog' :
       
   295 			$queries = $blog_tables;
       
   296 			break;
       
   297 		case 'global' :
       
   298 			$queries = $global_tables;
       
   299 			if ( $is_multisite )
       
   300 				$queries .= $ms_global_tables;
       
   301 			break;
       
   302 		case 'ms_global' :
       
   303 			$queries = $ms_global_tables;
       
   304 			break;
       
   305 		default:
       
   306 		case 'all' :
       
   307 			$queries = $global_tables . $blog_tables;
       
   308 			if ( $is_multisite )
       
   309 				$queries .= $ms_global_tables;
       
   310 			break;
       
   311 	}
       
   312 
       
   313 	if ( isset( $old_blog_id ) )
       
   314 		$wpdb->set_blog_id( $old_blog_id );
       
   315 
       
   316 	return $queries;
       
   317 }
       
   318 
       
   319 // Populate for back compat.
       
   320 $wp_queries = wp_get_db_schema( 'all' );
       
   321 
       
   322 /**
       
   323  * Create WordPress options and set the default values.
       
   324  *
       
   325  * @since 1.5.0
       
   326  * @uses $wpdb
       
   327  * @uses $wp_db_version
       
   328  */
       
   329 function populate_options() {
       
   330 	global $wpdb, $wp_db_version, $current_site, $wp_current_db_version;
       
   331 
       
   332 	$guessurl = wp_guess_url();
       
   333 
       
   334 	do_action('populate_options');
       
   335 
       
   336 	if ( ini_get('safe_mode') ) {
       
   337 		// Safe mode can break mkdir() so use a flat structure by default.
       
   338 		$uploads_use_yearmonth_folders = 0;
       
   339 	} else {
       
   340 		$uploads_use_yearmonth_folders = 1;
       
   341 	}
       
   342 
       
   343 	$template = WP_DEFAULT_THEME;
       
   344 	// If default theme is a child theme, we need to get its template
       
   345 	$theme = wp_get_theme( $template );
       
   346 	if ( ! $theme->errors() )
       
   347 		$template = $theme->get_template();
       
   348 
       
   349 	$timezone_string = '';
       
   350 	$gmt_offset = 0;
       
   351 	/* translators: default GMT offset or timezone string. Must be either a valid offset (-12 to 14)
       
   352 	   or a valid timezone string (America/New_York). See http://us3.php.net/manual/en/timezones.php
       
   353 	   for all timezone strings supported by PHP.
       
   354 	*/
       
   355 	$offset_or_tz = _x( '0', 'default GMT offset or timezone string' );
       
   356 	if ( is_numeric( $offset_or_tz ) )
       
   357 		$gmt_offset = $offset_or_tz;
       
   358 	elseif ( $offset_or_tz && in_array( $offset_or_tz, timezone_identifiers_list() ) )
       
   359 			$timezone_string = $offset_or_tz;
       
   360 
       
   361 	$options = array(
       
   362 	'siteurl' => $guessurl,
       
   363 	'blogname' => __('My Site'),
       
   364 	/* translators: blog tagline */
       
   365 	'blogdescription' => __('Just another WordPress site'),
       
   366 	'users_can_register' => 0,
       
   367 	'admin_email' => 'you@example.com',
       
   368 	/* translators: default start of the week. 0 = Sunday, 1 = Monday */
       
   369 	'start_of_week' => _x( '1', 'start of week' ),
       
   370 	'use_balanceTags' => 0,
       
   371 	'use_smilies' => 1,
       
   372 	'require_name_email' => 1,
       
   373 	'comments_notify' => 1,
       
   374 	'posts_per_rss' => 10,
       
   375 	'rss_use_excerpt' => 0,
       
   376 	'mailserver_url' => 'mail.example.com',
       
   377 	'mailserver_login' => 'login@example.com',
       
   378 	'mailserver_pass' => 'password',
       
   379 	'mailserver_port' => 110,
       
   380 	'default_category' => 1,
       
   381 	'default_comment_status' => 'open',
       
   382 	'default_ping_status' => 'open',
       
   383 	'default_pingback_flag' => 1,
       
   384 	'posts_per_page' => 10,
       
   385 	/* translators: default date format, see http://php.net/date */
       
   386 	'date_format' => __('F j, Y'),
       
   387 	/* translators: default time format, see http://php.net/date */
       
   388 	'time_format' => __('g:i a'),
       
   389 	/* translators: links last updated date format, see http://php.net/date */
       
   390 	'links_updated_date_format' => __('F j, Y g:i a'),
       
   391 	'links_recently_updated_prepend' => '<em>',
       
   392 	'links_recently_updated_append' => '</em>',
       
   393 	'links_recently_updated_time' => 120,
       
   394 	'comment_moderation' => 0,
       
   395 	'moderation_notify' => 1,
       
   396 	'permalink_structure' => '',
       
   397 	'gzipcompression' => 0,
       
   398 	'hack_file' => 0,
       
   399 	'blog_charset' => 'UTF-8',
       
   400 	'moderation_keys' => '',
       
   401 	'active_plugins' => array(),
       
   402 	'home' => $guessurl,
       
   403 	'category_base' => '',
       
   404 	'ping_sites' => 'http://rpc.pingomatic.com/',
       
   405 	'advanced_edit' => 0,
       
   406 	'comment_max_links' => 2,
       
   407 	'gmt_offset' => $gmt_offset,
       
   408 
       
   409 	// 1.5
       
   410 	'default_email_category' => 1,
       
   411 	'recently_edited' => '',
       
   412 	'template' => $template,
       
   413 	'stylesheet' => WP_DEFAULT_THEME,
       
   414 	'comment_whitelist' => 1,
       
   415 	'blacklist_keys' => '',
       
   416 	'comment_registration' => 0,
       
   417 	'html_type' => 'text/html',
       
   418 
       
   419 	// 1.5.1
       
   420 	'use_trackback' => 0,
       
   421 
       
   422 	// 2.0
       
   423 	'default_role' => 'subscriber',
       
   424 	'db_version' => $wp_db_version,
       
   425 
       
   426 	// 2.0.1
       
   427 	'uploads_use_yearmonth_folders' => $uploads_use_yearmonth_folders,
       
   428 	'upload_path' => '',
       
   429 
       
   430 	// 2.1
       
   431 	'blog_public' => '1',
       
   432 	'default_link_category' => 2,
       
   433 	'show_on_front' => 'posts',
       
   434 
       
   435 	// 2.2
       
   436 	'tag_base' => '',
       
   437 
       
   438 	// 2.5
       
   439 	'show_avatars' => '1',
       
   440 	'avatar_rating' => 'G',
       
   441 	'upload_url_path' => '',
       
   442 	'thumbnail_size_w' => 150,
       
   443 	'thumbnail_size_h' => 150,
       
   444 	'thumbnail_crop' => 1,
       
   445 	'medium_size_w' => 300,
       
   446 	'medium_size_h' => 300,
       
   447 
       
   448 	// 2.6
       
   449 	'avatar_default' => 'mystery',
       
   450 
       
   451 	// 2.7
       
   452 	'large_size_w' => 1024,
       
   453 	'large_size_h' => 1024,
       
   454 	'image_default_link_type' => 'file',
       
   455 	'image_default_size' => '',
       
   456 	'image_default_align' => '',
       
   457 	'close_comments_for_old_posts' => 0,
       
   458 	'close_comments_days_old' => 14,
       
   459 	'thread_comments' => 1,
       
   460 	'thread_comments_depth' => 5,
       
   461 	'page_comments' => 0,
       
   462 	'comments_per_page' => 50,
       
   463 	'default_comments_page' => 'newest',
       
   464 	'comment_order' => 'asc',
       
   465 	'sticky_posts' => array(),
       
   466 	'widget_categories' => array(),
       
   467 	'widget_text' => array(),
       
   468 	'widget_rss' => array(),
       
   469 	'uninstall_plugins' => array(),
       
   470 
       
   471 	// 2.8
       
   472 	'timezone_string' => $timezone_string,
       
   473 
       
   474 	// 3.0
       
   475 	'page_for_posts' => 0,
       
   476 	'page_on_front' => 0,
       
   477 
       
   478 	// 3.1
       
   479 	'default_post_format' => 0,
       
   480 
       
   481 	// 3.5
       
   482 	'link_manager_enabled' => 0,
       
   483 	);
       
   484 
       
   485 	// 3.3
       
   486 	if ( ! is_multisite() ) {
       
   487 		$options['initial_db_version'] = ! empty( $wp_current_db_version ) && $wp_current_db_version < $wp_db_version
       
   488 			? $wp_current_db_version : $wp_db_version;
       
   489 	}
       
   490 
       
   491 	// 3.0 multisite
       
   492 	if ( is_multisite() ) {
       
   493 		/* translators: blog tagline */
       
   494 		$options[ 'blogdescription' ] = sprintf(__('Just another %s site'), $current_site->site_name );
       
   495 		$options[ 'permalink_structure' ] = '/%year%/%monthnum%/%day%/%postname%/';
       
   496 	}
       
   497 
       
   498 	// Set autoload to no for these options
       
   499 	$fat_options = array( 'moderation_keys', 'recently_edited', 'blacklist_keys', 'uninstall_plugins' );
       
   500 
       
   501 	$keys = "'" . implode( "', '", array_keys( $options ) ) . "'";
       
   502 	$existing_options = $wpdb->get_col( "SELECT option_name FROM $wpdb->options WHERE option_name in ( $keys )" );
       
   503 
       
   504 	$insert = '';
       
   505 	foreach ( $options as $option => $value ) {
       
   506 		if ( in_array($option, $existing_options) )
       
   507 			continue;
       
   508 		if ( in_array($option, $fat_options) )
       
   509 			$autoload = 'no';
       
   510 		else
       
   511 			$autoload = 'yes';
       
   512 
       
   513 		if ( is_array($value) )
       
   514 			$value = serialize($value);
       
   515 		if ( !empty($insert) )
       
   516 			$insert .= ', ';
       
   517 		$insert .= $wpdb->prepare( "(%s, %s, %s)", $option, $value, $autoload );
       
   518 	}
       
   519 
       
   520 	if ( !empty($insert) )
       
   521 		$wpdb->query("INSERT INTO $wpdb->options (option_name, option_value, autoload) VALUES " . $insert);
       
   522 
       
   523 	// in case it is set, but blank, update "home"
       
   524 	if ( !__get_option('home') ) update_option('home', $guessurl);
       
   525 
       
   526 	// Delete unused options
       
   527 	$unusedoptions = array(
       
   528 		'blodotgsping_url', 'bodyterminator', 'emailtestonly', 'phoneemail_separator', 'smilies_directory',
       
   529 		'subjectprefix', 'use_bbcode', 'use_blodotgsping', 'use_phoneemail', 'use_quicktags', 'use_weblogsping',
       
   530 		'weblogs_cache_file', 'use_preview', 'use_htmltrans', 'smilies_directory', 'fileupload_allowedusers',
       
   531 		'use_phoneemail', 'default_post_status', 'default_post_category', 'archive_mode', 'time_difference',
       
   532 		'links_minadminlevel', 'links_use_adminlevels', 'links_rating_type', 'links_rating_char',
       
   533 		'links_rating_ignore_zero', 'links_rating_single_image', 'links_rating_image0', 'links_rating_image1',
       
   534 		'links_rating_image2', 'links_rating_image3', 'links_rating_image4', 'links_rating_image5',
       
   535 		'links_rating_image6', 'links_rating_image7', 'links_rating_image8', 'links_rating_image9',
       
   536 		'weblogs_cacheminutes', 'comment_allowed_tags', 'search_engine_friendly_urls', 'default_geourl_lat',
       
   537 		'default_geourl_lon', 'use_default_geourl', 'weblogs_xml_url', 'new_users_can_blog', '_wpnonce',
       
   538 		'_wp_http_referer', 'Update', 'action', 'rich_editing', 'autosave_interval', 'deactivated_plugins',
       
   539 		'can_compress_scripts', 'page_uris', 'update_core', 'update_plugins', 'update_themes', 'doing_cron',
       
   540 		'random_seed', 'rss_excerpt_length', 'secret', 'use_linksupdate', 'default_comment_status_page',
       
   541 		'wporg_popular_tags', 'what_to_show', 'rss_language', 'language', 'enable_xmlrpc', 'enable_app',
       
   542 		'embed_autourls', 'default_post_edit_rows',
       
   543 	);
       
   544 	foreach ( $unusedoptions as $option )
       
   545 		delete_option($option);
       
   546 
       
   547 	// delete obsolete magpie stuff
       
   548 	$wpdb->query("DELETE FROM $wpdb->options WHERE option_name REGEXP '^rss_[0-9a-f]{32}(_ts)?$'");
       
   549 
       
   550 	// Deletes all expired transients.
       
   551 	// The multi-table delete syntax is used to delete the transient record from table a,
       
   552 	// and the corresponding transient_timeout record from table b.
       
   553 	$time = time();
       
   554 	$wpdb->query("DELETE a, b FROM $wpdb->options a, $wpdb->options b WHERE
       
   555 	        a.option_name LIKE '\_transient\_%' AND
       
   556 	        a.option_name NOT LIKE '\_transient\_timeout\_%' AND
       
   557 	        b.option_name = CONCAT( '_transient_timeout_', SUBSTRING( a.option_name, 12 ) )
       
   558 	        AND b.option_value < $time");
       
   559 
       
   560 	if ( is_main_site() && is_main_network() ) {
       
   561 		$wpdb->query("DELETE a, b FROM $wpdb->options a, $wpdb->options b WHERE
       
   562 			a.option_name LIKE '\_site\_transient\_%' AND
       
   563 			a.option_name NOT LIKE '\_site\_transient\_timeout\_%' AND
       
   564 			b.option_name = CONCAT( '_site_transient_timeout_', SUBSTRING( a.option_name, 17 ) )
       
   565 			AND b.option_value < $time");
       
   566     }
       
   567 }
       
   568 
       
   569 /**
       
   570  * Execute WordPress role creation for the various WordPress versions.
       
   571  *
       
   572  * @since 2.0.0
       
   573  */
       
   574 function populate_roles() {
       
   575 	populate_roles_160();
       
   576 	populate_roles_210();
       
   577 	populate_roles_230();
       
   578 	populate_roles_250();
       
   579 	populate_roles_260();
       
   580 	populate_roles_270();
       
   581 	populate_roles_280();
       
   582 	populate_roles_300();
       
   583 }
       
   584 
       
   585 /**
       
   586  * Create the roles for WordPress 2.0
       
   587  *
       
   588  * @since 2.0.0
       
   589  */
       
   590 function populate_roles_160() {
       
   591 	// Add roles
       
   592 
       
   593 	// Dummy gettext calls to get strings in the catalog.
       
   594 	/* translators: user role */
       
   595 	_x('Administrator', 'User role');
       
   596 	/* translators: user role */
       
   597 	_x('Editor', 'User role');
       
   598 	/* translators: user role */
       
   599 	_x('Author', 'User role');
       
   600 	/* translators: user role */
       
   601 	_x('Contributor', 'User role');
       
   602 	/* translators: user role */
       
   603 	_x('Subscriber', 'User role');
       
   604 
       
   605 	add_role('administrator', 'Administrator');
       
   606 	add_role('editor', 'Editor');
       
   607 	add_role('author', 'Author');
       
   608 	add_role('contributor', 'Contributor');
       
   609 	add_role('subscriber', 'Subscriber');
       
   610 
       
   611 	// Add caps for Administrator role
       
   612 	$role = get_role('administrator');
       
   613 	$role->add_cap('switch_themes');
       
   614 	$role->add_cap('edit_themes');
       
   615 	$role->add_cap('activate_plugins');
       
   616 	$role->add_cap('edit_plugins');
       
   617 	$role->add_cap('edit_users');
       
   618 	$role->add_cap('edit_files');
       
   619 	$role->add_cap('manage_options');
       
   620 	$role->add_cap('moderate_comments');
       
   621 	$role->add_cap('manage_categories');
       
   622 	$role->add_cap('manage_links');
       
   623 	$role->add_cap('upload_files');
       
   624 	$role->add_cap('import');
       
   625 	$role->add_cap('unfiltered_html');
       
   626 	$role->add_cap('edit_posts');
       
   627 	$role->add_cap('edit_others_posts');
       
   628 	$role->add_cap('edit_published_posts');
       
   629 	$role->add_cap('publish_posts');
       
   630 	$role->add_cap('edit_pages');
       
   631 	$role->add_cap('read');
       
   632 	$role->add_cap('level_10');
       
   633 	$role->add_cap('level_9');
       
   634 	$role->add_cap('level_8');
       
   635 	$role->add_cap('level_7');
       
   636 	$role->add_cap('level_6');
       
   637 	$role->add_cap('level_5');
       
   638 	$role->add_cap('level_4');
       
   639 	$role->add_cap('level_3');
       
   640 	$role->add_cap('level_2');
       
   641 	$role->add_cap('level_1');
       
   642 	$role->add_cap('level_0');
       
   643 
       
   644 	// Add caps for Editor role
       
   645 	$role = get_role('editor');
       
   646 	$role->add_cap('moderate_comments');
       
   647 	$role->add_cap('manage_categories');
       
   648 	$role->add_cap('manage_links');
       
   649 	$role->add_cap('upload_files');
       
   650 	$role->add_cap('unfiltered_html');
       
   651 	$role->add_cap('edit_posts');
       
   652 	$role->add_cap('edit_others_posts');
       
   653 	$role->add_cap('edit_published_posts');
       
   654 	$role->add_cap('publish_posts');
       
   655 	$role->add_cap('edit_pages');
       
   656 	$role->add_cap('read');
       
   657 	$role->add_cap('level_7');
       
   658 	$role->add_cap('level_6');
       
   659 	$role->add_cap('level_5');
       
   660 	$role->add_cap('level_4');
       
   661 	$role->add_cap('level_3');
       
   662 	$role->add_cap('level_2');
       
   663 	$role->add_cap('level_1');
       
   664 	$role->add_cap('level_0');
       
   665 
       
   666 	// Add caps for Author role
       
   667 	$role = get_role('author');
       
   668 	$role->add_cap('upload_files');
       
   669 	$role->add_cap('edit_posts');
       
   670 	$role->add_cap('edit_published_posts');
       
   671 	$role->add_cap('publish_posts');
       
   672 	$role->add_cap('read');
       
   673 	$role->add_cap('level_2');
       
   674 	$role->add_cap('level_1');
       
   675 	$role->add_cap('level_0');
       
   676 
       
   677 	// Add caps for Contributor role
       
   678 	$role = get_role('contributor');
       
   679 	$role->add_cap('edit_posts');
       
   680 	$role->add_cap('read');
       
   681 	$role->add_cap('level_1');
       
   682 	$role->add_cap('level_0');
       
   683 
       
   684 	// Add caps for Subscriber role
       
   685 	$role = get_role('subscriber');
       
   686 	$role->add_cap('read');
       
   687 	$role->add_cap('level_0');
       
   688 }
       
   689 
       
   690 /**
       
   691  * Create and modify WordPress roles for WordPress 2.1.
       
   692  *
       
   693  * @since 2.1.0
       
   694  */
       
   695 function populate_roles_210() {
       
   696 	$roles = array('administrator', 'editor');
       
   697 	foreach ($roles as $role) {
       
   698 		$role = get_role($role);
       
   699 		if ( empty($role) )
       
   700 			continue;
       
   701 
       
   702 		$role->add_cap('edit_others_pages');
       
   703 		$role->add_cap('edit_published_pages');
       
   704 		$role->add_cap('publish_pages');
       
   705 		$role->add_cap('delete_pages');
       
   706 		$role->add_cap('delete_others_pages');
       
   707 		$role->add_cap('delete_published_pages');
       
   708 		$role->add_cap('delete_posts');
       
   709 		$role->add_cap('delete_others_posts');
       
   710 		$role->add_cap('delete_published_posts');
       
   711 		$role->add_cap('delete_private_posts');
       
   712 		$role->add_cap('edit_private_posts');
       
   713 		$role->add_cap('read_private_posts');
       
   714 		$role->add_cap('delete_private_pages');
       
   715 		$role->add_cap('edit_private_pages');
       
   716 		$role->add_cap('read_private_pages');
       
   717 	}
       
   718 
       
   719 	$role = get_role('administrator');
       
   720 	if ( ! empty($role) ) {
       
   721 		$role->add_cap('delete_users');
       
   722 		$role->add_cap('create_users');
       
   723 	}
       
   724 
       
   725 	$role = get_role('author');
       
   726 	if ( ! empty($role) ) {
       
   727 		$role->add_cap('delete_posts');
       
   728 		$role->add_cap('delete_published_posts');
       
   729 	}
       
   730 
       
   731 	$role = get_role('contributor');
       
   732 	if ( ! empty($role) ) {
       
   733 		$role->add_cap('delete_posts');
       
   734 	}
       
   735 }
       
   736 
       
   737 /**
       
   738  * Create and modify WordPress roles for WordPress 2.3.
       
   739  *
       
   740  * @since 2.3.0
       
   741  */
       
   742 function populate_roles_230() {
       
   743 	$role = get_role( 'administrator' );
       
   744 
       
   745 	if ( !empty( $role ) ) {
       
   746 		$role->add_cap( 'unfiltered_upload' );
       
   747 	}
       
   748 }
       
   749 
       
   750 /**
       
   751  * Create and modify WordPress roles for WordPress 2.5.
       
   752  *
       
   753  * @since 2.5.0
       
   754  */
       
   755 function populate_roles_250() {
       
   756 	$role = get_role( 'administrator' );
       
   757 
       
   758 	if ( !empty( $role ) ) {
       
   759 		$role->add_cap( 'edit_dashboard' );
       
   760 	}
       
   761 }
       
   762 
       
   763 /**
       
   764  * Create and modify WordPress roles for WordPress 2.6.
       
   765  *
       
   766  * @since 2.6.0
       
   767  */
       
   768 function populate_roles_260() {
       
   769 	$role = get_role( 'administrator' );
       
   770 
       
   771 	if ( !empty( $role ) ) {
       
   772 		$role->add_cap( 'update_plugins' );
       
   773 		$role->add_cap( 'delete_plugins' );
       
   774 	}
       
   775 }
       
   776 
       
   777 /**
       
   778  * Create and modify WordPress roles for WordPress 2.7.
       
   779  *
       
   780  * @since 2.7.0
       
   781  */
       
   782 function populate_roles_270() {
       
   783 	$role = get_role( 'administrator' );
       
   784 
       
   785 	if ( !empty( $role ) ) {
       
   786 		$role->add_cap( 'install_plugins' );
       
   787 		$role->add_cap( 'update_themes' );
       
   788 	}
       
   789 }
       
   790 
       
   791 /**
       
   792  * Create and modify WordPress roles for WordPress 2.8.
       
   793  *
       
   794  * @since 2.8.0
       
   795  */
       
   796 function populate_roles_280() {
       
   797 	$role = get_role( 'administrator' );
       
   798 
       
   799 	if ( !empty( $role ) ) {
       
   800 		$role->add_cap( 'install_themes' );
       
   801 	}
       
   802 }
       
   803 
       
   804 /**
       
   805  * Create and modify WordPress roles for WordPress 3.0.
       
   806  *
       
   807  * @since 3.0.0
       
   808  */
       
   809 function populate_roles_300() {
       
   810 	$role = get_role( 'administrator' );
       
   811 
       
   812 	if ( !empty( $role ) ) {
       
   813 		$role->add_cap( 'update_core' );
       
   814 		$role->add_cap( 'list_users' );
       
   815 		$role->add_cap( 'remove_users' );
       
   816 
       
   817 		// Never used, will be removed. create_users or
       
   818 		// promote_users is the capability you're looking for.
       
   819 		$role->add_cap( 'add_users' );
       
   820 
       
   821 		$role->add_cap( 'promote_users' );
       
   822 		$role->add_cap( 'edit_theme_options' );
       
   823 		$role->add_cap( 'delete_themes' );
       
   824 		$role->add_cap( 'export' );
       
   825 	}
       
   826 }
       
   827 
       
   828 /**
       
   829  * Install Network.
       
   830  *
       
   831  * @since 3.0.0
       
   832  *
       
   833  */
       
   834 if ( !function_exists( 'install_network' ) ) :
       
   835 function install_network() {
       
   836 	if ( ! defined( 'WP_INSTALLING_NETWORK' ) )
       
   837 		define( 'WP_INSTALLING_NETWORK', true );
       
   838 
       
   839 	dbDelta( wp_get_db_schema( 'global' ) );
       
   840 }
       
   841 endif;
       
   842 
       
   843 /**
       
   844  * populate network settings
       
   845  *
       
   846  * @since 3.0.0
       
   847  *
       
   848  * @param int $network_id id of network to populate
       
   849  * @return bool|WP_Error True on success, or WP_Error on warning (with the install otherwise successful,
       
   850  * 	so the error code must be checked) or failure.
       
   851  */
       
   852 function populate_network( $network_id = 1, $domain = '', $email = '', $site_name = '', $path = '/', $subdomain_install = false ) {
       
   853 	global $wpdb, $current_site, $wp_db_version, $wp_rewrite;
       
   854 
       
   855 	$errors = new WP_Error();
       
   856 	if ( '' == $domain )
       
   857 		$errors->add( 'empty_domain', __( 'You must provide a domain name.' ) );
       
   858 	if ( '' == $site_name )
       
   859 		$errors->add( 'empty_sitename', __( 'You must provide a name for your network of sites.' ) );
       
   860 
       
   861 	// check for network collision
       
   862 	if ( $network_id == $wpdb->get_var( $wpdb->prepare( "SELECT id FROM $wpdb->site WHERE id = %d", $network_id ) ) )
       
   863 		$errors->add( 'siteid_exists', __( 'The network already exists.' ) );
       
   864 
       
   865 	$site_user = get_user_by( 'email', $email );
       
   866 	if ( ! is_email( $email ) )
       
   867 		$errors->add( 'invalid_email', __( 'You must provide a valid e-mail address.' ) );
       
   868 
       
   869 	if ( $errors->get_error_code() )
       
   870 		return $errors;
       
   871 
       
   872 	// set up site tables
       
   873 	$template = get_option( 'template' );
       
   874 	$stylesheet = get_option( 'stylesheet' );
       
   875 	$allowed_themes = array( $stylesheet => true );
       
   876 	if ( $template != $stylesheet )
       
   877 		$allowed_themes[ $template ] = true;
       
   878 	if ( WP_DEFAULT_THEME != $stylesheet && WP_DEFAULT_THEME != $template )
       
   879 		$allowed_themes[ WP_DEFAULT_THEME ] = true;
       
   880 
       
   881 	if ( 1 == $network_id ) {
       
   882 		$wpdb->insert( $wpdb->site, array( 'domain' => $domain, 'path' => $path ) );
       
   883 		$network_id = $wpdb->insert_id;
       
   884 	} else {
       
   885 		$wpdb->insert( $wpdb->site, array( 'domain' => $domain, 'path' => $path, 'id' => $network_id ) );
       
   886 	}
       
   887 
       
   888 	if ( !is_multisite() ) {
       
   889 		$site_admins = array( $site_user->user_login );
       
   890 		$users = get_users( array( 'fields' => array( 'ID', 'user_login' ) ) );
       
   891 		if ( $users ) {
       
   892 			foreach ( $users as $user ) {
       
   893 				if ( is_super_admin( $user->ID ) && !in_array( $user->user_login, $site_admins ) )
       
   894 					$site_admins[] = $user->user_login;
       
   895 			}
       
   896 		}
       
   897 	} else {
       
   898 		$site_admins = get_site_option( 'site_admins' );
       
   899 	}
       
   900 
       
   901 	$welcome_email = __( 'Dear User,
       
   902 
       
   903 Your new SITE_NAME site has been successfully set up at:
       
   904 BLOG_URL
       
   905 
       
   906 You can log in to the administrator account with the following information:
       
   907 Username: USERNAME
       
   908 Password: PASSWORD
       
   909 Log in here: BLOG_URLwp-login.php
       
   910 
       
   911 We hope you enjoy your new site. Thanks!
       
   912 
       
   913 --The Team @ SITE_NAME' );
       
   914 
       
   915 	$sitemeta = array(
       
   916 		'site_name' => $site_name,
       
   917 		'admin_email' => $site_user->user_email,
       
   918 		'admin_user_id' => $site_user->ID,
       
   919 		'registration' => 'none',
       
   920 		'upload_filetypes' => 'jpg jpeg png gif mp3 mov avi wmv midi mid pdf',
       
   921 		'blog_upload_space' => 100,
       
   922 		'fileupload_maxk' => 1500,
       
   923 		'site_admins' => $site_admins,
       
   924 		'allowedthemes' => $allowed_themes,
       
   925 		'illegal_names' => array( 'www', 'web', 'root', 'admin', 'main', 'invite', 'administrator', 'files' ),
       
   926 		'wpmu_upgrade_site' => $wp_db_version,
       
   927 		'welcome_email' => $welcome_email,
       
   928 		'first_post' => __( 'Welcome to <a href="SITE_URL">SITE_NAME</a>. This is your first post. Edit or delete it, then start blogging!' ),
       
   929 		// @todo - network admins should have a method of editing the network siteurl (used for cookie hash)
       
   930 		'siteurl' => get_option( 'siteurl' ) . '/',
       
   931 		'add_new_users' => '0',
       
   932 		'upload_space_check_disabled' => is_multisite() ? get_site_option( 'upload_space_check_disabled' ) : '1',
       
   933 		'subdomain_install' => intval( $subdomain_install ),
       
   934 		'global_terms_enabled' => global_terms_enabled() ? '1' : '0',
       
   935 		'ms_files_rewriting' => is_multisite() ? get_site_option( 'ms_files_rewriting' ) : '0',
       
   936 		'initial_db_version' => get_option( 'initial_db_version' ),
       
   937 		'active_sitewide_plugins' => array(),
       
   938 		'WPLANG' => get_locale(),
       
   939 	);
       
   940 	if ( ! $subdomain_install )
       
   941 		$sitemeta['illegal_names'][] = 'blog';
       
   942 
       
   943 	/**
       
   944 	 * Filter meta for a network on creation.
       
   945 	 *
       
   946 	 * @since 3.7.0
       
   947 	 *
       
   948 	 * @param array $sitemeta Associative of meta keys and values to be inserted.
       
   949 	 * @param int $network_id Network ID being created.
       
   950 	 */
       
   951 	$sitemeta = apply_filters( 'populate_network_meta', $sitemeta, $network_id );
       
   952 
       
   953 	$insert = '';
       
   954 	foreach ( $sitemeta as $meta_key => $meta_value ) {
       
   955 		if ( is_array( $meta_value ) )
       
   956 			$meta_value = serialize( $meta_value );
       
   957 		if ( !empty( $insert ) )
       
   958 			$insert .= ', ';
       
   959 		$insert .= $wpdb->prepare( "( %d, %s, %s)", $network_id, $meta_key, $meta_value );
       
   960 	}
       
   961 	$wpdb->query( "INSERT INTO $wpdb->sitemeta ( site_id, meta_key, meta_value ) VALUES " . $insert );
       
   962 
       
   963 	// When upgrading from single to multisite, assume the current site will become the main site of the network.
       
   964 	// When using populate_network() to create another network in an existing multisite environment,
       
   965 	// skip these steps since the main site of the new network has not yet been created.
       
   966 	if ( ! is_multisite() ) {
       
   967 		$current_site = new stdClass;
       
   968 		$current_site->domain = $domain;
       
   969 		$current_site->path = $path;
       
   970 		$current_site->site_name = ucfirst( $domain );
       
   971 		$wpdb->insert( $wpdb->blogs, array( 'site_id' => $network_id, 'blog_id' => 1, 'domain' => $domain, 'path' => $path, 'registered' => current_time( 'mysql' ) ) );
       
   972 		$current_site->blog_id = $blog_id = $wpdb->insert_id;
       
   973 		update_user_meta( $site_user->ID, 'source_domain', $domain );
       
   974 		update_user_meta( $site_user->ID, 'primary_blog', $blog_id );
       
   975 
       
   976 		if ( $subdomain_install )
       
   977 			$wp_rewrite->set_permalink_structure( '/%year%/%monthnum%/%day%/%postname%/' );
       
   978 		else
       
   979 			$wp_rewrite->set_permalink_structure( '/blog/%year%/%monthnum%/%day%/%postname%/' );
       
   980 
       
   981 		flush_rewrite_rules();
       
   982 
       
   983 		if ( ! $subdomain_install )
       
   984 			return true;
       
   985 
       
   986 		$vhost_ok = false;
       
   987 		$errstr = '';
       
   988 		$hostname = substr( md5( time() ), 0, 6 ) . '.' . $domain; // Very random hostname!
       
   989 		$page = wp_remote_get( 'http://' . $hostname, array( 'timeout' => 5, 'httpversion' => '1.1' ) );
       
   990 		if ( is_wp_error( $page ) )
       
   991 			$errstr = $page->get_error_message();
       
   992 		elseif ( 200 == wp_remote_retrieve_response_code( $page ) )
       
   993 				$vhost_ok = true;
       
   994 
       
   995 		if ( ! $vhost_ok ) {
       
   996 			$msg = '<p><strong>' . __( 'Warning! Wildcard DNS may not be configured correctly!' ) . '</strong></p>';
       
   997 			$msg .= '<p>' . sprintf( __( 'The installer attempted to contact a random hostname (<code>%1$s</code>) on your domain.' ), $hostname );
       
   998 			if ( ! empty ( $errstr ) )
       
   999 				$msg .= ' ' . sprintf( __( 'This resulted in an error message: %s' ), '<code>' . $errstr . '</code>' );
       
  1000 			$msg .= '</p>';
       
  1001 			$msg .= '<p>' . __( 'To use a subdomain configuration, you must have a wildcard entry in your DNS. This usually means adding a <code>*</code> hostname record pointing at your web server in your DNS configuration tool.' ) . '</p>';
       
  1002 			$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>';
       
  1003 			return new WP_Error( 'no_wildcard_dns', $msg );
       
  1004 		}
       
  1005 	}
       
  1006 
       
  1007 	return true;
       
  1008 }