W3cubDocs

/WordPress

create_empty_blog( string $domain, string $path, string $weblog_title, int $site_id = 1 )

This function has been deprecated.

Create an empty blog.

Parameters

$domain

(string) (Required) The new blog's domain.

$path

(string) (Required) The new blog's path.

$weblog_title

(string) (Required) The new blog's title.

$site_id

(int) (Optional) Defaults to 1.

Default value: 1

Return

(string|int) The ID of the newly created blog

Source

File: wp-includes/ms-deprecated.php 

function create_empty_blog( $domain, $path, $weblog_title, $site_id = 1 ) {
	_deprecated_function( __FUNCTION__, '4.4.0' );

	if ( empty($path) )
		$path = '/';

	// Check if the domain has been used already. We should return an error message.
	if ( domain_exists($domain, $path, $site_id) )
		return __( '<strong>Error</strong>: Site URL you&#8217;ve entered is already taken.' );

	/*
	 * Need to back up wpdb table names, and create a new wp_blogs entry for new blog.
	 * Need to get blog_id from wp_blogs, and create new table names.
	 * Must restore table names at the end of function.
	 */

	if ( ! $blog_id = insert_blog($domain, $path, $site_id) )
		return __( '<strong>Error</strong>: There was a problem creating site entry.' );

	switch_to_blog($blog_id);
	install_blog($blog_id);
	restore_current_blog();

	return $blog_id;
}

Uses

Uses Description
wp-includes/l10n.php: __()

Retrieve the translation of $text.
wp-includes/functions.php: _deprecated_function()

Mark a function as deprecated and inform when it has been used.
wp-includes/ms-functions.php: domain_exists()

Checks whether a site name is already taken.
wp-includes/ms-deprecated.php: insert_blog()

Store basic site info in the blogs table.
wp-includes/ms-deprecated.php: install_blog()

Install an empty blog.
wp-includes/ms-blogs.php: switch_to_blog()

Switch the current blog.
wp-includes/ms-blogs.php: restore_current_blog()

Restore the current blog, after calling switch_to_blog().

Changelog

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

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/create_empty_blog