3 * WordPress Administration Scheme API
5 * Here we keep the DB structure and option values.
8 * @subpackage Administration
11 // Declare these as global in case schema.php is included from a function.
12 global $wpdb, $wp_queries, $charset_collate;
15 * The database character collate.
18 * @name $charset_collate
20 $charset_collate = $wpdb->get_charset_collate();
23 * Retrieve the SQL for creating database tables.
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.
31 function wp_get_db_schema( $scope = 'all', $blog_id = null ) {
34 $charset_collate = '';
36 if ( ! empty($wpdb->charset) )
37 $charset_collate = "DEFAULT CHARACTER SET $wpdb->charset";
38 if ( ! empty($wpdb->collate) )
39 $charset_collate .= " COLLATE $wpdb->collate";
41 if ( $blog_id && $blog_id != $wpdb->blogid )
42 $old_blog_id = $wpdb->set_blog_id( $blog_id );
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 );
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),
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)
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)
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,
80 PRIMARY KEY (meta_id),
81 KEY comment_id (comment_id),
82 KEY meta_key (meta_key)
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)
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)
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)
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,
136 PRIMARY KEY (meta_id),
137 KEY post_id (post_id),
138 KEY meta_key (meta_key)
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',
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";
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 '',
184 KEY user_login_key (user_login),
185 KEY user_nicename (user_nicename)
186 ) $charset_collate;\n";
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',
203 KEY user_login_key (user_login),
204 KEY user_nicename (user_nicename)
205 ) $charset_collate;\n";
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,
213 PRIMARY KEY (umeta_id),
214 KEY user_id (user_id),
215 KEY meta_key (meta_key)
216 ) $charset_collate;\n";
220 $global_tables = $users_multi_table . $usermeta_table;
222 $global_tables = $users_single_table . $usermeta_table;
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)
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)
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',
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 '',
263 KEY domain (domain,path)
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,
270 PRIMARY KEY (meta_id),
271 KEY meta_key (meta_key),
272 KEY site_id (site_id)
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 '',
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;";
295 $queries = $blog_tables;
298 $queries = $global_tables;
300 $queries .= $ms_global_tables;
303 $queries = $ms_global_tables;
307 $queries = $global_tables . $blog_tables;
309 $queries .= $ms_global_tables;
313 if ( isset( $old_blog_id ) )
314 $wpdb->set_blog_id( $old_blog_id );
319 // Populate for back compat.
320 $wp_queries = wp_get_db_schema( 'all' );
323 * Create WordPress options and set the default values.
327 * @uses $wp_db_version
329 function populate_options() {
330 global $wpdb, $wp_db_version, $wp_current_db_version;
332 $guessurl = wp_guess_url();
334 * Fires before creating WordPress options and populating their default values.
338 do_action( 'populate_options' );
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;
344 $uploads_use_yearmonth_folders = 1;
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();
353 $timezone_string = '';
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.
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;
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,
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,
400 'blog_charset' => 'UTF-8',
401 'moderation_keys' => '',
402 'active_plugins' => array(),
404 'category_base' => '',
405 'ping_sites' => 'http://rpc.pingomatic.com/',
406 'advanced_edit' => 0,
407 'comment_max_links' => 2,
408 'gmt_offset' => $gmt_offset,
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',
421 'use_trackback' => 0,
424 'default_role' => 'subscriber',
425 'db_version' => $wp_db_version,
428 'uploads_use_yearmonth_folders' => $uploads_use_yearmonth_folders,
432 'blog_public' => '1',
433 'default_link_category' => 2,
434 'show_on_front' => 'posts',
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,
450 'avatar_default' => 'mystery',
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(),
473 'timezone_string' => $timezone_string,
476 'page_for_posts' => 0,
477 'page_on_front' => 0,
480 'default_post_format' => 0,
483 'link_manager_enabled' => 0,
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;
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%/';
499 // Set autoload to no for these options
500 $fat_options = array( 'moderation_keys', 'recently_edited', 'blacklist_keys', 'uninstall_plugins' );
502 $keys = "'" . implode( "', '", array_keys( $options ) ) . "'";
503 $existing_options = $wpdb->get_col( "SELECT option_name FROM $wpdb->options WHERE option_name in ( $keys )" );
506 foreach ( $options as $option => $value ) {
507 if ( in_array($option, $existing_options) )
509 if ( in_array($option, $fat_options) )
514 if ( is_array($value) )
515 $value = serialize($value);
516 if ( !empty($insert) )
518 $insert .= $wpdb->prepare( "(%s, %s, %s)", $option, $value, $autoload );
521 if ( !empty($insert) )
522 $wpdb->query("INSERT INTO $wpdb->options (option_name, option_value, autoload) VALUES " . $insert);
524 // in case it is set, but blank, update "home"
525 if ( !__get_option('home') ) update_option('home', $guessurl);
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',
546 foreach ( $unusedoptions as $option )
547 delete_option($option);
549 // delete obsolete magpie stuff
550 $wpdb->query("DELETE FROM $wpdb->options WHERE option_name REGEXP '^rss_[0-9a-f]{32}(_ts)?$'");
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.
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");
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");
572 * Execute WordPress role creation for the various WordPress versions.
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();
588 * Create the roles for WordPress 2.0
592 function populate_roles_160() {
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');
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');
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');
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');
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');
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');
686 // Add caps for Subscriber role
687 $role = get_role('subscriber');
688 $role->add_cap('read');
689 $role->add_cap('level_0');
693 * Create and modify WordPress roles for WordPress 2.1.
697 function populate_roles_210() {
698 $roles = array('administrator', 'editor');
699 foreach ($roles as $role) {
700 $role = get_role($role);
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');
721 $role = get_role('administrator');
722 if ( ! empty($role) ) {
723 $role->add_cap('delete_users');
724 $role->add_cap('create_users');
727 $role = get_role('author');
728 if ( ! empty($role) ) {
729 $role->add_cap('delete_posts');
730 $role->add_cap('delete_published_posts');
733 $role = get_role('contributor');
734 if ( ! empty($role) ) {
735 $role->add_cap('delete_posts');
740 * Create and modify WordPress roles for WordPress 2.3.
744 function populate_roles_230() {
745 $role = get_role( 'administrator' );
747 if ( !empty( $role ) ) {
748 $role->add_cap( 'unfiltered_upload' );
753 * Create and modify WordPress roles for WordPress 2.5.
757 function populate_roles_250() {
758 $role = get_role( 'administrator' );
760 if ( !empty( $role ) ) {
761 $role->add_cap( 'edit_dashboard' );
766 * Create and modify WordPress roles for WordPress 2.6.
770 function populate_roles_260() {
771 $role = get_role( 'administrator' );
773 if ( !empty( $role ) ) {
774 $role->add_cap( 'update_plugins' );
775 $role->add_cap( 'delete_plugins' );
780 * Create and modify WordPress roles for WordPress 2.7.
784 function populate_roles_270() {
785 $role = get_role( 'administrator' );
787 if ( !empty( $role ) ) {
788 $role->add_cap( 'install_plugins' );
789 $role->add_cap( 'update_themes' );
794 * Create and modify WordPress roles for WordPress 2.8.
798 function populate_roles_280() {
799 $role = get_role( 'administrator' );
801 if ( !empty( $role ) ) {
802 $role->add_cap( 'install_themes' );
807 * Create and modify WordPress roles for WordPress 3.0.
811 function populate_roles_300() {
812 $role = get_role( 'administrator' );
814 if ( !empty( $role ) ) {
815 $role->add_cap( 'update_core' );
816 $role->add_cap( 'list_users' );
817 $role->add_cap( 'remove_users' );
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' );
823 $role->add_cap( 'promote_users' );
824 $role->add_cap( 'edit_theme_options' );
825 $role->add_cap( 'delete_themes' );
826 $role->add_cap( 'export' );
836 if ( !function_exists( 'install_network' ) ) :
837 function install_network() {
838 if ( ! defined( 'WP_INSTALLING_NETWORK' ) )
839 define( 'WP_INSTALLING_NETWORK', true );
841 dbDelta( wp_get_db_schema( 'global' ) );
846 * Populate network settings.
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.
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;
857 $errors = new WP_Error();
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.' ) );
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.' ) );
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.' ) );
871 if ( $errors->get_error_code() )
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;
883 if ( 1 == $network_id ) {
884 $wpdb->insert( $wpdb->site, array( 'domain' => $domain, 'path' => $path ) );
885 $network_id = $wpdb->insert_id;
887 $wpdb->insert( $wpdb->site, array( 'domain' => $domain, 'path' => $path, 'id' => $network_id ) );
890 wp_cache_delete( 'networks_have_paths', 'site-options' );
892 if ( !is_multisite() ) {
893 $site_admins = array( $site_user->user_login );
894 $users = get_users( array( 'fields' => array( 'ID', 'user_login' ) ) );
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;
902 $site_admins = get_site_option( 'site_admins' );
905 $welcome_email = __( 'Dear User,
907 Your new SITE_NAME site has been successfully set up at:
910 You can log in to the administrator account with the following information:
913 Log in here: BLOG_URLwp-login.php
915 We hope you enjoy your new site. Thanks!
917 --The Team @ SITE_NAME' );
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(),
944 if ( ! $subdomain_install )
945 $sitemeta['illegal_names'][] = 'blog';
948 * Filter meta for a network on creation.
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.
955 $sitemeta = apply_filters( 'populate_network_meta', $sitemeta, $network_id );
958 foreach ( $sitemeta as $meta_key => $meta_value ) {
959 if ( is_array( $meta_value ) )
960 $meta_value = serialize( $meta_value );
961 if ( !empty( $insert ) )
963 $insert .= $wpdb->prepare( "( %d, %s, %s)", $network_id, $meta_key, $meta_value );
965 $wpdb->query( "INSERT INTO $wpdb->sitemeta ( site_id, meta_key, meta_value ) VALUES " . $insert );
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 );
980 if ( $subdomain_install )
981 $wp_rewrite->set_permalink_structure( '/%year%/%monthnum%/%day%/%postname%/' );
983 $wp_rewrite->set_permalink_structure( '/blog/%year%/%monthnum%/%day%/%postname%/' );
985 flush_rewrite_rules();
987 if ( ! $subdomain_install )
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 ) )
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>' );
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 );