Changeset 34753

Timestamp:

10/01/2015 10:09:18 PM (11 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;
 }