wp-admin/includes/schema.php

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