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 // 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, $wp_current_db_version;
 331
 332         $guessurl = wp_guess_url();
 333         /**
 334          * Fires before creating WordPress options and populating their default values.
 335          *
 336          * @since 2.6.0
 337          */
 338         do_action( 'populate_options' );
 339
 340         if ( ini_get('safe_mode') ) {
 341                 // Safe mode can break mkdir() so use a flat structure by default.
 342                 $uploads_use_yearmonth_folders = 0;
 343         } else {
 344                 $uploads_use_yearmonth_folders = 1;
 345         }
 346
 347         $template = WP_DEFAULT_THEME;
 348         // If default theme is a child theme, we need to get its template
 349         $theme = wp_get_theme( $template );
 350         if ( ! $theme->errors() )
 351                 $template = $theme->get_template();
 352
 353         $timezone_string = '';
 354         $gmt_offset = 0;
 355         /* translators: default GMT offset or timezone string. Must be either a valid offset (-12 to 14)
 356            or a valid timezone string (America/New_York). See http://us3.php.net/manual/en/timezones.php
 357            for all timezone strings supported by PHP.
 358         */
 359         $offset_or_tz = _x( '0', 'default GMT offset or timezone string' );
 360         if ( is_numeric( $offset_or_tz ) )
 361                 $gmt_offset = $offset_or_tz;
 362         elseif ( $offset_or_tz && in_array( $offset_or_tz, timezone_identifiers_list() ) )
 363                         $timezone_string = $offset_or_tz;
 364
 365         $options = array(
 366         'siteurl' => $guessurl,
 367         'blogname' => __('My Site'),
 368         /* translators: blog tagline */
 369         'blogdescription' => __('Just another WordPress site'),
 370         'users_can_register' => 0,
 371         'admin_email' => 'you@example.com',
 372         /* translators: default start of the week. 0 = Sunday, 1 = Monday */
 373         'start_of_week' => _x( '1', 'start of week' ),
 374         'use_balanceTags' => 0,
 375         'use_smilies' => 1,
 376         'require_name_email' => 1,
 377         'comments_notify' => 1,
 378         'posts_per_rss' => 10,
 379         'rss_use_excerpt' => 0,
 380         'mailserver_url' => 'mail.example.com',
 381         'mailserver_login' => 'login@example.com',
 382         'mailserver_pass' => 'password',
 383         'mailserver_port' => 110,
 384         'default_category' => 1,
 385         'default_comment_status' => 'open',
 386         'default_ping_status' => 'open',
 387         'default_pingback_flag' => 1,
 388         'posts_per_page' => 10,
 389         /* translators: default date format, see http://php.net/date */
 390         'date_format' => __('F j, Y'),
 391         /* translators: default time format, see http://php.net/date */
 392         'time_format' => __('g:i a'),
 393         /* translators: links last updated date format, see http://php.net/date */
 394         'links_updated_date_format' => __('F j, Y g:i a'),
 395         'comment_moderation' => 0,
 396         'moderation_notify' => 1,
 397         'permalink_structure' => '',
 398         'gzipcompression' => 0,
 399         'hack_file' => 0,
 400         'blog_charset' => 'UTF-8',
 401         'moderation_keys' => '',
 402         'active_plugins' => array(),
 403         'home' => $guessurl,
 404         'category_base' => '',
 405         'ping_sites' => 'http://rpc.pingomatic.com/',
 406         'advanced_edit' => 0,
 407         'comment_max_links' => 2,
 408         'gmt_offset' => $gmt_offset,
 409
 410         // 1.5
 411         'default_email_category' => 1,
 412         'recently_edited' => '',
 413         'template' => $template,
 414         'stylesheet' => WP_DEFAULT_THEME,
 415         'comment_whitelist' => 1,
 416         'blacklist_keys' => '',
 417         'comment_registration' => 0,
 418         'html_type' => 'text/html',
 419
 420         // 1.5.1
 421         'use_trackback' => 0,
 422
 423         // 2.0
 424         'default_role' => 'subscriber',
 425         'db_version' => $wp_db_version,
 426
 427         // 2.0.1
 428         'uploads_use_yearmonth_folders' => $uploads_use_yearmonth_folders,
 429         'upload_path' => '',
 430
 431         // 2.1
 432         'blog_public' => '1',
 433         'default_link_category' => 2,
 434         'show_on_front' => 'posts',
 435
 436         // 2.2
 437         'tag_base' => '',
 438
 439         // 2.5
 440         'show_avatars' => '1',
 441         'avatar_rating' => 'G',
 442         'upload_url_path' => '',
 443         'thumbnail_size_w' => 150,
 444         'thumbnail_size_h' => 150,
 445         'thumbnail_crop' => 1,
 446         'medium_size_w' => 300,
 447         'medium_size_h' => 300,
 448
 449         // 2.6
 450         'avatar_default' => 'mystery',
 451
 452         // 2.7
 453         'large_size_w' => 1024,
 454         'large_size_h' => 1024,
 455         'image_default_link_type' => 'file',
 456         'image_default_size' => '',
 457         'image_default_align' => '',
 458         'close_comments_for_old_posts' => 0,
 459         'close_comments_days_old' => 14,
 460         'thread_comments' => 1,
 461         'thread_comments_depth' => 5,
 462         'page_comments' => 0,
 463         'comments_per_page' => 50,
 464         'default_comments_page' => 'newest',
 465         'comment_order' => 'asc',
 466         'sticky_posts' => array(),
 467         'widget_categories' => array(),
 468         'widget_text' => array(),
 469         'widget_rss' => array(),
 470         'uninstall_plugins' => array(),
 471
 472         // 2.8
 473         'timezone_string' => $timezone_string,
 474
 475         // 3.0
 476         'page_for_posts' => 0,
 477         'page_on_front' => 0,
 478
 479         // 3.1
 480         'default_post_format' => 0,
 481
 482         // 3.5
 483         'link_manager_enabled' => 0,
 484         );
 485
 486         // 3.3
 487         if ( ! is_multisite() ) {
 488                 $options['initial_db_version'] = ! empty( $wp_current_db_version ) && $wp_current_db_version < $wp_db_version
 489                         ? $wp_current_db_version : $wp_db_version;
 490         }
 491
 492         // 3.0 multisite
 493         if ( is_multisite() ) {
 494                 /* translators: blog tagline */
 495                 $options[ 'blogdescription' ] = sprintf(__('Just another %s site'), get_current_site()->site_name );
 496                 $options[ 'permalink_structure' ] = '/%year%/%monthnum%/%day%/%postname%/';
 497         }
 498
 499         // Set autoload to no for these options
 500         $fat_options = array( 'moderation_keys', 'recently_edited', 'blacklist_keys', 'uninstall_plugins' );
 501
 502         $keys = "'" . implode( "', '", array_keys( $options ) ) . "'";
 503         $existing_options = $wpdb->get_col( "SELECT option_name FROM $wpdb->options WHERE option_name in ( $keys )" );
 504
 505         $insert = '';
 506         foreach ( $options as $option => $value ) {
 507                 if ( in_array($option, $existing_options) )
 508                         continue;
 509                 if ( in_array($option, $fat_options) )
 510                         $autoload = 'no';
 511                 else
 512                         $autoload = 'yes';
 513
 514                 if ( is_array($value) )
 515                         $value = serialize($value);
 516                 if ( !empty($insert) )
 517                         $insert .= ', ';
 518                 $insert .= $wpdb->prepare( "(%s, %s, %s)", $option, $value, $autoload );
 519         }
 520
 521         if ( !empty($insert) )
 522                 $wpdb->query("INSERT INTO $wpdb->options (option_name, option_value, autoload) VALUES " . $insert);
 523
 524         // in case it is set, but blank, update "home"
 525         if ( !__get_option('home') ) update_option('home', $guessurl);
 526
 527         // Delete unused options
 528         $unusedoptions = array(
 529                 'blodotgsping_url', 'bodyterminator', 'emailtestonly', 'phoneemail_separator', 'smilies_directory',
 530                 'subjectprefix', 'use_bbcode', 'use_blodotgsping', 'use_phoneemail', 'use_quicktags', 'use_weblogsping',
 531                 'weblogs_cache_file', 'use_preview', 'use_htmltrans', 'smilies_directory', 'fileupload_allowedusers',
 532                 'use_phoneemail', 'default_post_status', 'default_post_category', 'archive_mode', 'time_difference',
 533                 'links_minadminlevel', 'links_use_adminlevels', 'links_rating_type', 'links_rating_char',
 534                 'links_rating_ignore_zero', 'links_rating_single_image', 'links_rating_image0', 'links_rating_image1',
 535                 'links_rating_image2', 'links_rating_image3', 'links_rating_image4', 'links_rating_image5',
 536                 'links_rating_image6', 'links_rating_image7', 'links_rating_image8', 'links_rating_image9',
 537                 'links_recently_updated_time', 'links_recently_updated_prepend', 'links_recently_updated_append',
 538                 'weblogs_cacheminutes', 'comment_allowed_tags', 'search_engine_friendly_urls', 'default_geourl_lat',
 539                 'default_geourl_lon', 'use_default_geourl', 'weblogs_xml_url', 'new_users_can_blog', '_wpnonce',
 540                 '_wp_http_referer', 'Update', 'action', 'rich_editing', 'autosave_interval', 'deactivated_plugins',
 541                 'can_compress_scripts', 'page_uris', 'update_core', 'update_plugins', 'update_themes', 'doing_cron',
 542                 'random_seed', 'rss_excerpt_length', 'secret', 'use_linksupdate', 'default_comment_status_page',
 543                 'wporg_popular_tags', 'what_to_show', 'rss_language', 'language', 'enable_xmlrpc', 'enable_app',
 544                 'embed_autourls', 'default_post_edit_rows',
 545         );
 546         foreach ( $unusedoptions as $option )
 547                 delete_option($option);
 548
 549         // delete obsolete magpie stuff
 550         $wpdb->query("DELETE FROM $wpdb->options WHERE option_name REGEXP '^rss_[0-9a-f]{32}(_ts)?$'");
 551
 552         // Deletes all expired transients.
 553         // The multi-table delete syntax is used to delete the transient record from table a,
 554         // and the corresponding transient_timeout record from table b.
 555         $time = time();
 556         $wpdb->query("DELETE a, b FROM $wpdb->options a, $wpdb->options b WHERE
 557                 a.option_name LIKE '\_transient\_%' AND
 558                 a.option_name NOT LIKE '\_transient\_timeout\_%' AND
 559                 b.option_name = CONCAT( '_transient_timeout_', SUBSTRING( a.option_name, 12 ) )
 560                 AND b.option_value < $time");
 561
 562         if ( is_main_site() && is_main_network() ) {
 563                 $wpdb->query("DELETE a, b FROM $wpdb->options a, $wpdb->options b WHERE
 564                         a.option_name LIKE '\_site\_transient\_%' AND
 565                         a.option_name NOT LIKE '\_site\_transient\_timeout\_%' AND
 566                         b.option_name = CONCAT( '_site_transient_timeout_', SUBSTRING( a.option_name, 17 ) )
 567                         AND b.option_value < $time");
 568     }
 569 }
 570
 571 /**
 572  * Execute WordPress role creation for the various WordPress versions.
 573  *
 574  * @since 2.0.0
 575  */
 576 function populate_roles() {
 577         populate_roles_160();
 578         populate_roles_210();
 579         populate_roles_230();
 580         populate_roles_250();
 581         populate_roles_260();
 582         populate_roles_270();
 583         populate_roles_280();
 584         populate_roles_300();
 585 }
 586
 587 /**
 588  * Create the roles for WordPress 2.0
 589  *
 590  * @since 2.0.0
 591  */
 592 function populate_roles_160() {
 593         // Add roles
 594
 595         // Dummy gettext calls to get strings in the catalog.
 596         /* translators: user role */
 597         _x('Administrator', 'User role');
 598         /* translators: user role */
 599         _x('Editor', 'User role');
 600         /* translators: user role */
 601         _x('Author', 'User role');
 602         /* translators: user role */
 603         _x('Contributor', 'User role');
 604         /* translators: user role */
 605         _x('Subscriber', 'User role');
 606
 607         add_role('administrator', 'Administrator');
 608         add_role('editor', 'Editor');
 609         add_role('author', 'Author');
 610         add_role('contributor', 'Contributor');
 611         add_role('subscriber', 'Subscriber');
 612
 613         // Add caps for Administrator role
 614         $role = get_role('administrator');
 615         $role->add_cap('switch_themes');
 616         $role->add_cap('edit_themes');
 617         $role->add_cap('activate_plugins');
 618         $role->add_cap('edit_plugins');
 619         $role->add_cap('edit_users');
 620         $role->add_cap('edit_files');
 621         $role->add_cap('manage_options');
 622         $role->add_cap('moderate_comments');
 623         $role->add_cap('manage_categories');
 624         $role->add_cap('manage_links');
 625         $role->add_cap('upload_files');
 626         $role->add_cap('import');
 627         $role->add_cap('unfiltered_html');
 628         $role->add_cap('edit_posts');
 629         $role->add_cap('edit_others_posts');
 630         $role->add_cap('edit_published_posts');
 631         $role->add_cap('publish_posts');
 632         $role->add_cap('edit_pages');
 633         $role->add_cap('read');
 634         $role->add_cap('level_10');
 635         $role->add_cap('level_9');
 636         $role->add_cap('level_8');
 637         $role->add_cap('level_7');
 638         $role->add_cap('level_6');
 639         $role->add_cap('level_5');
 640         $role->add_cap('level_4');
 641         $role->add_cap('level_3');
 642         $role->add_cap('level_2');
 643         $role->add_cap('level_1');
 644         $role->add_cap('level_0');
 645
 646         // Add caps for Editor role
 647         $role = get_role('editor');
 648         $role->add_cap('moderate_comments');
 649         $role->add_cap('manage_categories');
 650         $role->add_cap('manage_links');
 651         $role->add_cap('upload_files');
 652         $role->add_cap('unfiltered_html');
 653         $role->add_cap('edit_posts');
 654         $role->add_cap('edit_others_posts');
 655         $role->add_cap('edit_published_posts');
 656         $role->add_cap('publish_posts');
 657         $role->add_cap('edit_pages');
 658         $role->add_cap('read');
 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 Author role
 669         $role = get_role('author');
 670         $role->add_cap('upload_files');
 671         $role->add_cap('edit_posts');
 672         $role->add_cap('edit_published_posts');
 673         $role->add_cap('publish_posts');
 674         $role->add_cap('read');
 675         $role->add_cap('level_2');
 676         $role->add_cap('level_1');
 677         $role->add_cap('level_0');
 678
 679         // Add caps for Contributor role
 680         $role = get_role('contributor');
 681         $role->add_cap('edit_posts');
 682         $role->add_cap('read');
 683         $role->add_cap('level_1');
 684         $role->add_cap('level_0');
 685
 686         // Add caps for Subscriber role
 687         $role = get_role('subscriber');
 688         $role->add_cap('read');
 689         $role->add_cap('level_0');
 690 }
 691
 692 /**
 693  * Create and modify WordPress roles for WordPress 2.1.
 694  *
 695  * @since 2.1.0
 696  */
 697 function populate_roles_210() {
 698         $roles = array('administrator', 'editor');
 699         foreach ($roles as $role) {
 700                 $role = get_role($role);
 701                 if ( empty($role) )
 702                         continue;
 703
 704                 $role->add_cap('edit_others_pages');
 705                 $role->add_cap('edit_published_pages');
 706                 $role->add_cap('publish_pages');
 707                 $role->add_cap('delete_pages');
 708                 $role->add_cap('delete_others_pages');
 709                 $role->add_cap('delete_published_pages');
 710                 $role->add_cap('delete_posts');
 711                 $role->add_cap('delete_others_posts');
 712                 $role->add_cap('delete_published_posts');
 713                 $role->add_cap('delete_private_posts');
 714                 $role->add_cap('edit_private_posts');
 715                 $role->add_cap('read_private_posts');
 716                 $role->add_cap('delete_private_pages');
 717                 $role->add_cap('edit_private_pages');
 718                 $role->add_cap('read_private_pages');
 719         }
 720
 721         $role = get_role('administrator');
 722         if ( ! empty($role) ) {
 723                 $role->add_cap('delete_users');
 724                 $role->add_cap('create_users');
 725         }
 726
 727         $role = get_role('author');
 728         if ( ! empty($role) ) {
 729                 $role->add_cap('delete_posts');
 730                 $role->add_cap('delete_published_posts');
 731         }
 732
 733         $role = get_role('contributor');
 734         if ( ! empty($role) ) {
 735                 $role->add_cap('delete_posts');
 736         }
 737 }
 738
 739 /**
 740  * Create and modify WordPress roles for WordPress 2.3.
 741  *
 742  * @since 2.3.0
 743  */
 744 function populate_roles_230() {
 745         $role = get_role( 'administrator' );
 746
 747         if ( !empty( $role ) ) {
 748                 $role->add_cap( 'unfiltered_upload' );
 749         }
 750 }
 751
 752 /**
 753  * Create and modify WordPress roles for WordPress 2.5.
 754  *
 755  * @since 2.5.0
 756  */
 757 function populate_roles_250() {
 758         $role = get_role( 'administrator' );
 759
 760         if ( !empty( $role ) ) {
 761                 $role->add_cap( 'edit_dashboard' );
 762         }
 763 }
 764
 765 /**
 766  * Create and modify WordPress roles for WordPress 2.6.
 767  *
 768  * @since 2.6.0
 769  */
 770 function populate_roles_260() {
 771         $role = get_role( 'administrator' );
 772
 773         if ( !empty( $role ) ) {
 774                 $role->add_cap( 'update_plugins' );
 775                 $role->add_cap( 'delete_plugins' );
 776         }
 777 }
 778
 779 /**
 780  * Create and modify WordPress roles for WordPress 2.7.
 781  *
 782  * @since 2.7.0
 783  */
 784 function populate_roles_270() {
 785         $role = get_role( 'administrator' );
 786
 787         if ( !empty( $role ) ) {
 788                 $role->add_cap( 'install_plugins' );
 789                 $role->add_cap( 'update_themes' );
 790         }
 791 }
 792
 793 /**
 794  * Create and modify WordPress roles for WordPress 2.8.
 795  *
 796  * @since 2.8.0
 797  */
 798 function populate_roles_280() {
 799         $role = get_role( 'administrator' );
 800
 801         if ( !empty( $role ) ) {
 802                 $role->add_cap( 'install_themes' );
 803         }
 804 }
 805
 806 /**
 807  * Create and modify WordPress roles for WordPress 3.0.
 808  *
 809  * @since 3.0.0
 810  */
 811 function populate_roles_300() {
 812         $role = get_role( 'administrator' );
 813
 814         if ( !empty( $role ) ) {
 815                 $role->add_cap( 'update_core' );
 816                 $role->add_cap( 'list_users' );
 817                 $role->add_cap( 'remove_users' );
 818
 819                 // Never used, will be removed. create_users or
 820                 // promote_users is the capability you're looking for.
 821                 $role->add_cap( 'add_users' );
 822
 823                 $role->add_cap( 'promote_users' );
 824                 $role->add_cap( 'edit_theme_options' );
 825                 $role->add_cap( 'delete_themes' );
 826                 $role->add_cap( 'export' );
 827         }
 828 }
 829
 830 /**
 831  * Install Network.
 832  *
 833  * @since 3.0.0
 834  *
 835  */
 836 if ( !function_exists( 'install_network' ) ) :
 837 function install_network() {
 838         if ( ! defined( 'WP_INSTALLING_NETWORK' ) )
 839                 define( 'WP_INSTALLING_NETWORK', true );
 840
 841         dbDelta( wp_get_db_schema( 'global' ) );
 842 }
 843 endif;
 844
 845 /**
 846  * Populate network settings.
 847  *
 848  * @since 3.0.0
 849  *
 850  * @param int $network_id ID of network to populate.
 851  * @return bool|WP_Error True on success, or WP_Error on warning (with the install otherwise successful,
 852  *                       so the error code must be checked) or failure.
 853  */
 854 function populate_network( $network_id = 1, $domain = '', $email = '', $site_name = '', $path = '/', $subdomain_install = false ) {
 855         global $wpdb, $current_site, $wp_db_version, $wp_rewrite;
 856
 857         $errors = new WP_Error();
 858         if ( '' == $domain )
 859                 $errors->add( 'empty_domain', __( 'You must provide a domain name.' ) );
 860         if ( '' == $site_name )
 861                 $errors->add( 'empty_sitename', __( 'You must provide a name for your network of sites.' ) );
 862
 863         // check for network collision
 864         if ( $network_id == $wpdb->get_var( $wpdb->prepare( "SELECT id FROM $wpdb->site WHERE id = %d", $network_id ) ) )
 865                 $errors->add( 'siteid_exists', __( 'The network already exists.' ) );
 866
 867         $site_user = get_user_by( 'email', $email );
 868         if ( ! is_email( $email ) )
 869                 $errors->add( 'invalid_email', __( 'You must provide a valid e-mail address.' ) );
 870
 871         if ( $errors->get_error_code() )
 872                 return $errors;
 873
 874         // set up site tables
 875         $template = get_option( 'template' );
 876         $stylesheet = get_option( 'stylesheet' );
 877         $allowed_themes = array( $stylesheet => true );
 878         if ( $template != $stylesheet )
 879                 $allowed_themes[ $template ] = true;
 880         if ( WP_DEFAULT_THEME != $stylesheet && WP_DEFAULT_THEME != $template )
 881                 $allowed_themes[ WP_DEFAULT_THEME ] = true;
 882
 883         if ( 1 == $network_id ) {
 884                 $wpdb->insert( $wpdb->site, array( 'domain' => $domain, 'path' => $path ) );
 885                 $network_id = $wpdb->insert_id;
 886         } else {
 887                 $wpdb->insert( $wpdb->site, array( 'domain' => $domain, 'path' => $path, 'id' => $network_id ) );
 888         }
 889
 890         wp_cache_delete( 'networks_have_paths', 'site-options' );
 891
 892         if ( !is_multisite() ) {
 893                 $site_admins = array( $site_user->user_login );
 894                 $users = get_users( array( 'fields' => array( 'ID', 'user_login' ) ) );
 895                 if ( $users ) {
 896                         foreach ( $users as $user ) {
 897                                 if ( is_super_admin( $user->ID ) && !in_array( $user->user_login, $site_admins ) )
 898                                         $site_admins[] = $user->user_login;
 899                         }
 900                 }
 901         } else {
 902                 $site_admins = get_site_option( 'site_admins' );
 903         }
 904
 905         $welcome_email = __( 'Dear User,
 906
 907 Your new SITE_NAME site has been successfully set up at:
 908 BLOG_URL
 909
 910 You can log in to the administrator account with the following information:
 911 Username: USERNAME
 912 Password: PASSWORD
 913 Log in here: BLOG_URLwp-login.php
 914
 915 We hope you enjoy your new site. Thanks!
 916
 917 --The Team @ SITE_NAME' );
 918
 919         $sitemeta = array(
 920                 'site_name' => $site_name,
 921                 'admin_email' => $site_user->user_email,
 922                 'admin_user_id' => $site_user->ID,
 923                 'registration' => 'none',
 924                 'upload_filetypes' => 'jpg jpeg png gif mp3 mov avi wmv midi mid pdf',
 925                 'blog_upload_space' => 100,
 926                 'fileupload_maxk' => 1500,
 927                 'site_admins' => $site_admins,
 928                 'allowedthemes' => $allowed_themes,
 929                 'illegal_names' => array( 'www', 'web', 'root', 'admin', 'main', 'invite', 'administrator', 'files' ),
 930                 'wpmu_upgrade_site' => $wp_db_version,
 931                 'welcome_email' => $welcome_email,
 932                 'first_post' => __( 'Welcome to <a href="SITE_URL">SITE_NAME</a>. This is your first post. Edit or delete it, then start blogging!' ),
 933                 // @todo - network admins should have a method of editing the network siteurl (used for cookie hash)
 934                 'siteurl' => get_option( 'siteurl' ) . '/',
 935                 'add_new_users' => '0',
 936                 'upload_space_check_disabled' => is_multisite() ? get_site_option( 'upload_space_check_disabled' ) : '1',
 937                 'subdomain_install' => intval( $subdomain_install ),
 938                 'global_terms_enabled' => global_terms_enabled() ? '1' : '0',
 939                 'ms_files_rewriting' => is_multisite() ? get_site_option( 'ms_files_rewriting' ) : '0',
 940                 'initial_db_version' => get_option( 'initial_db_version' ),
 941                 'active_sitewide_plugins' => array(),
 942                 'WPLANG' => get_locale(),
 943         );
 944         if ( ! $subdomain_install )
 945                 $sitemeta['illegal_names'][] = 'blog';
 946
 947         /**
 948          * Filter meta for a network on creation.
 949          *
 950          * @since 3.7.0
 951          *
 952          * @param array $sitemeta   Associative array of network meta keys and values to be inserted.
 953          * @param int   $network_id ID of network to populate.
 954          */
 955         $sitemeta = apply_filters( 'populate_network_meta', $sitemeta, $network_id );
 956
 957         $insert = '';
 958         foreach ( $sitemeta as $meta_key => $meta_value ) {
 959                 if ( is_array( $meta_value ) )
 960                         $meta_value = serialize( $meta_value );
 961                 if ( !empty( $insert ) )
 962                         $insert .= ', ';
 963                 $insert .= $wpdb->prepare( "( %d, %s, %s)", $network_id, $meta_key, $meta_value );
 964         }
 965         $wpdb->query( "INSERT INTO $wpdb->sitemeta ( site_id, meta_key, meta_value ) VALUES " . $insert );
 966
 967         // When upgrading from single to multisite, assume the current site will become the main site of the network.
 968         // When using populate_network() to create another network in an existing multisite environment,
 969         // skip these steps since the main site of the new network has not yet been created.
 970         if ( ! is_multisite() ) {
 971                 $current_site = new stdClass;
 972                 $current_site->domain = $domain;
 973                 $current_site->path = $path;
 974                 $current_site->site_name = ucfirst( $domain );
 975                 $wpdb->insert( $wpdb->blogs, array( 'site_id' => $network_id, 'blog_id' => 1, 'domain' => $domain, 'path' => $path, 'registered' => current_time( 'mysql' ) ) );
 976                 $current_site->blog_id = $blog_id = $wpdb->insert_id;
 977                 update_user_meta( $site_user->ID, 'source_domain', $domain );
 978                 update_user_meta( $site_user->ID, 'primary_blog', $blog_id );
 979
 980                 if ( $subdomain_install )
 981                         $wp_rewrite->set_permalink_structure( '/%year%/%monthnum%/%day%/%postname%/' );
 982                 else
 983                         $wp_rewrite->set_permalink_structure( '/blog/%year%/%monthnum%/%day%/%postname%/' );
 984
 985                 flush_rewrite_rules();
 986
 987                 if ( ! $subdomain_install )
 988                         return true;
 989
 990                 $vhost_ok = false;
 991                 $errstr = '';
 992                 $hostname = substr( md5( time() ), 0, 6 ) . '.' . $domain; // Very random hostname!
 993                 $page = wp_remote_get( 'http://' . $hostname, array( 'timeout' => 5, 'httpversion' => '1.1' ) );
 994                 if ( is_wp_error( $page ) )
 995                         $errstr = $page->get_error_message();
 996                 elseif ( 200 == wp_remote_retrieve_response_code( $page ) )
 997                                 $vhost_ok = true;
 998
 999                 if ( ! $vhost_ok ) {
1000                         $msg = '<p><strong>' . __( 'Warning! Wildcard DNS may not be configured correctly!' ) . '</strong></p>';
1001                         $msg .= '<p>' . sprintf( __( 'The installer attempted to contact a random hostname (<code>%1$s</code>) on your domain.' ), $hostname );
1002                         if ( ! empty ( $errstr ) )
1003                                 $msg .= ' ' . sprintf( __( 'This resulted in an error message: %s' ), '<code>' . $errstr . '</code>' );
1004                         $msg .= '</p>';
1005                         $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>';
1006                         $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>';
1007                         return new WP_Error( 'no_wildcard_dns', $msg );
1008                 }
1009         }
1010
1011         return true;
1012 }