Changeset 34753

Timestamp:

10/01/2015 10:09:18 PM (6 years ago)

Author:

johnbillion

Message:

Deprecate create_empty_blog(). This function has never been used in core.

Fixes #34120

Location:

trunk/src/wp-includes

Files:

• ms-deprecated.php (modified) (1 diff)
• ms-functions.php (modified) (1 diff)

trunk/src/wp-includes/ms-deprecated.php

@@ -357 +357 @@
     return esc_url_raw( $url );
 }
+
+/**
+ * Create an empty blog.
+ *
+ * @since MU 1.0
+ * @deprecated 4.4.0
+ *
+ * @param string $domain       The new blog's domain.
+ * @param string $path         The new blog's path.
+ * @param string $weblog_title The new blog's title.
+ * @param int    $site_id      Optional. Defaults to 1.
+ * @return string|int The ID of the newly created blog
+ */
+function create_empty_blog( $domain, $path, $weblog_title, $site_id = 1 ) {
+    _deprecated_function( __FUNCTION__, '4.4' );
+
+    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 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>: problem creating site entry.' );
+
+    switch_to_blog($blog_id);
+    install_blog($blog_id);
+    restore_current_blog();
+
+    return $blog_id;
+}

trunk/src/wp-includes/ms-functions.php

@@ -295 +295 @@
 
     return true;
-}
-
-/**
- * Create an empty blog.
- *
- * @since MU 1.0
- *
- * @param string $domain       The new blog's domain.
- * @param string $path         The new blog's path.
- * @param string $weblog_title The new blog's title.
- * @param int    $site_id      Optional. Defaults to 1.
- * @return string|int The ID of the newly created blog
- */
-function create_empty_blog( $domain, $path, $weblog_title, $site_id = 1 ) {
-    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 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>: problem creating site entry.' );
-
-    switch_to_blog($blog_id);
-    install_blog($blog_id);
-    restore_current_blog();
-
-    return $blog_id;
 }