Warning: This function has been deprecated.

install_blog( int $blog_id, string $blog_title = '' )

Install an empty blog.

Contents

Description Description

Creates the new blog tables and options. If calling this function directly, be sure to use switch_to_blog() first, so that $wpdb points to the new blog.

Parameters Parameters

$blog_id

(int) (Required) The value returned by wp_insert_site().

$blog_title

(string) (Optional) The title of the new site.

Default value: ''

Top ↑

Source Source

File: wp-includes/ms-deprecated.php

605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
function install_blog( $blog_id, $blog_title = '' ) {
    global $wpdb, $wp_roles;
 
    _deprecated_function( __FUNCTION__, '5.1.0' );
 
    // Cast for security
    $blog_id = (int) $blog_id;
 
    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
 
    $suppress = $wpdb->suppress_errors();
    if ( $wpdb->get_results( "DESCRIBE {$wpdb->posts}" ) ) {
        die( '<h1>' . __( 'Already Installed' ) . '</h1><p>' . __( 'You appear to have already installed WordPress. To reinstall please clear your old database tables first.' ) . '</p></body></html>' );
    }
    $wpdb->suppress_errors( $suppress );
 
    $url = get_blogaddress_by_id( $blog_id );
 
    // Set everything up
    make_db_current_silent( 'blog' );
    populate_options();
    populate_roles();
 
    // populate_roles() clears previous role definitions so we start over.
    $wp_roles = new WP_Roles();
 
    $siteurl = $home = untrailingslashit( $url );
 
    if ( ! is_subdomain_install() ) {
 
        if ( 'https' === parse_url( get_site_option( 'siteurl' ), PHP_URL_SCHEME ) ) {
            $siteurl = set_url_scheme( $siteurl, 'https' );
        }
        if ( 'https' === parse_url( get_home_url( get_network()->site_id ), PHP_URL_SCHEME ) ) {
            $home = set_url_scheme( $home, 'https' );
        }
    }
 
    update_option( 'siteurl', $siteurl );
    update_option( 'home', $home );
 
    if ( get_site_option( 'ms_files_rewriting' ) ) {
        update_option( 'upload_path', UPLOADBLOGSDIR . "/$blog_id/files" );
    } else {
        update_option( 'upload_path', get_blog_option( get_network()->site_id, 'upload_path' ) );
    }
 
    update_option( 'blogname', wp_unslash( $blog_title ) );
    update_option( 'admin_email', '' );
 
    // remove all perms
    $table_prefix = $wpdb->get_blog_prefix();
    delete_metadata( 'user', 0, $table_prefix . 'user_level', null, true ); // delete all
    delete_metadata( 'user', 0, $table_prefix . 'capabilities', null, true ); // delete all
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
5.1.0 This function has been deprecated.
MU (3.0.0) Introduced.

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/ms-network.php: get_network()

Retrieves network data given a network ID or network object.
wp-admin/includes/schema.php: populate_roles()

Execute WordPress role creation for the various WordPress versions.
wp-admin/includes/schema.php: populate_options()

Create WordPress options and set the default values.
wp-admin/includes/upgrade.php: make_db_current_silent()

Updates the database tables to a new schema, but without displaying results.
wp-includes/class-wp-roles.php: WP_Roles::__construct()

Constructor
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/formatting.php: wp_unslash()

Remove slashes from a string or array of strings.
wp-includes/formatting.php: untrailingslashit()

Removes trailing forward slashes and backslashes if they exist.
wp-includes/functions.php: _deprecated_function()

Mark a function as deprecated and inform when it has been used.
wp-includes/link-template.php: set_url_scheme()

Sets the scheme for a URL.
wp-includes/link-template.php: get_home_url()

Retrieves the URL for a given site where the front end is accessible.
wp-includes/option.php: get_site_option()

Retrieve an option value for the current network based on name of option.
wp-includes/option.php: update_option()

Update the value of an option that was already added.
wp-includes/ms-load.php: is_subdomain_install()

Whether a subdomain configuration is enabled.
wp-includes/ms-blogs.php: get_blog_option()

Retrieve option value for a given blog id based on name of option.
wp-includes/ms-blogs.php: get_blogaddress_by_id()

Get a full blog URL, given a blog id.
wp-includes/wp-db.php: wpdb::get_results()

Retrieve an entire SQL result set from the database (i.e., many rows)
wp-includes/wp-db.php: wpdb::suppress_errors()

Whether to suppress database errors.
wp-includes/wp-db.php: wpdb::get_blog_prefix()

Gets blog prefix.
wp-includes/meta.php: delete_metadata()

Delete metadata for the specified object.
Show 15 more uses Hide more uses

Top ↑

User Contributed Notes User Contributed Notes

You must log in before being able to contribute a note or feedback.