Changeset 44469

Timestamp:

01/08/2019 08:57:32 AM (6 years ago)

Author:

flixos90

Message:

Multisite: Update @since tags for site management APIs.

Fixes #40364. Fixes #41333.

Location:

trunk/src

Files:

• wp-admin/includes/ms.php (modified) (3 diffs)
• wp-includes/ms-blogs.php (modified) (27 diffs)
• wp-includes/ms-deprecated.php (modified) (4 diffs)
• wp-includes/ms-functions.php (modified) (2 diffs)

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

@@ -57 +57 @@
  *
  * @since 3.0.0
- * @since 5.0.0 Use wp_delete_site() internally to delete the site row from the database.
+ * @since 5.1.0 Use wp_delete_site() internally to delete the site row from the database.
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -98 +98 @@
     } else {
         /** This action is documented in wp-includes/ms-blogs.php */
-        do_action_deprecated( 'delete_blog', array( $blog_id, false ), '5.0.0' );
+        do_action_deprecated( 'delete_blog', array( $blog_id, false ), '5.1.0' );
 
         $users = get_users(
@@ -117 +117 @@
 
         /** This action is documented in wp-includes/ms-blogs.php */
-        do_action_deprecated( 'deleted_blog', array( $blog_id, false ), '5.0.0' );
+        do_action_deprecated( 'deleted_blog', array( $blog_id, false ), '5.1.0' );
     }
 

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

@@ -401 +401 @@
  * Inserts a new site into the database.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -465 +465 @@
      * Fires once a site has been inserted into the database.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param WP_Site $new_site New site object.
@@ -474 +474 @@
      * Fires when a site's initialization routine should be executed.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param WP_Site $new_site New site object.
@@ -490 +490 @@
          *
          * @since MU (3.0.0)
-         * @deprecated 5.0.0 Use wp_insert_site
+         * @deprecated 5.1.0 Use wp_insert_site
          *
          * @param int    $site_id    Site ID.
@@ -499 +499 @@
          * @param array  $meta       Meta data. Used to set initial site options.
          */
-        do_action_deprecated( 'wpmu_new_blog', array( $new_site->id, $user_id, $new_site->domain, $new_site->path, $new_site->network_id, $meta ), '5.0.0', 'wp_insert_site' );
+        do_action_deprecated( 'wpmu_new_blog', array( $new_site->id, $user_id, $new_site->domain, $new_site->path, $new_site->network_id, $meta ), '5.1.0', 'wp_insert_site' );
     }
 
@@ -508 +508 @@
  * Updates a site in the database.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -549 +549 @@
      * Fires once a site has been updated in the database.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param WP_Site $new_site New site object.
@@ -562 +562 @@
  * Deletes a site from the database.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -589 +589 @@
      * are present, the site will not be deleted.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param WP_Error $errors   Error object to add validation errors to.
@@ -604 +604 @@
      *
      * @since MU (3.0.0)
-     * @deprecated 5.0.0
+     * @deprecated 5.1.0
      *
      * @param int  $site_id The site ID.
      * @param bool $drop    True if site's table should be dropped. Default is false.
      */
-    do_action_deprecated( 'delete_blog', array( $old_site->id, true ), '5.0.0' );
+    do_action_deprecated( 'delete_blog', array( $old_site->id, true ), '5.1.0' );
 
     /**
      * Fires when a site's uninitialization routine should be executed.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param WP_Site $old_site Deleted site object.
@@ -636 +636 @@
      * Fires once a site has been deleted from the database.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param WP_Site $old_site Deleted site object.
@@ -646 +646 @@
      *
      * @since 4.8.0
-     * @deprecated 5.0.0
+     * @deprecated 5.1.0
      *
      * @param int  $site_id The site ID.
      * @param bool $drop    True if site's tables should be dropped. Default is false.
      */
-    do_action_deprecated( 'deleted_blog', array( $old_site->id, true ), '5.0.0' );
+    do_action_deprecated( 'deleted_blog', array( $old_site->id, true ), '5.1.0' );
 
     return $old_site;
@@ -825 +825 @@
  * Prepares site data for insertion or update in the database.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param array        $data     Associative array of site data passed to the respective function.
@@ -848 +848 @@
      * Filters passed site data in order to normalize it.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param array $data Associative array of site data passed to the respective function.
@@ -865 +865 @@
      * Plugins should amend the `$errors` object via its `WP_Error::add()` method.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param WP_Error     $errors   Error object to add validation errors to.
@@ -889 +889 @@
  * Normalizes data for a site prior to inserting or updating in the database.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param array $data Associative array of site data passed to the respective function.
@@ -941 +941 @@
  * Validates data for a site prior to inserting or updating in the database.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param WP_Error     $errors   Error object, passed by reference. Will contain validation errors if
@@ -1009 +1009 @@
  * populating them with defaults.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @global wpdb     $wpdb     WordPress database abstraction object.
@@ -1063 +1063 @@
      * Filters the arguments for initializing a site.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param array      $args    Arguments to modify the initialization behavior.
@@ -1149 +1149 @@
  * This process includes dropping the site's database tables and deleting its uploads directory.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -1271 +1271 @@
  * A site is considered initialized when its database tables are present.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -1292 +1292 @@
      * that value instead.
      *
-     * @since 5.0.0
+     * @since 5.1.0
      *
      * @param bool|null $pre     The value to return, if not null.
@@ -1764 +1764 @@
  *
  * @since MU (3.0.0)
- * @since 5.0.0 Use wp_update_site() internally.
+ * @since 5.1.0 Use wp_update_site() internally.
  *
  * @global wpdb $wpdb WordPress database abstraction object.
@@ -2067 +2067 @@
  * Updates the count of sites for a network based on a changed site.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param WP_Site      $new_site The site object that has been inserted, updated or deleted.
@@ -2088 +2088 @@
  * Triggers actions on site status updates.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param WP_Site      $new_site The site object after the update.
@@ -2215 +2215 @@
  * Cleans the necessary caches after specific site data has been updated.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param WP_Site $new_site The site object after the update.
@@ -2229 +2229 @@
  * Updates the `blog_public` option for a given site ID.
  *
- * @since 5.0.0
+ * @since 5.1.0
  *
  * @param int    $site_id Site ID.

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

@@ -560 +560 @@
  *
  * @since MU (3.0.0)
- * @deprecated 5.0.0 Use `wp_insert_site()`
+ * @deprecated 5.1.0 Use `wp_insert_site()`
  * @see wp_insert_site()
  *
@@ -569 +569 @@
  */
 function insert_blog($domain, $path, $site_id) {
-    _deprecated_function( __FUNCTION__, '5.0.0', 'wp_insert_site()' );
+    _deprecated_function( __FUNCTION__, '5.1.0', 'wp_insert_site()' );
 
     $data = array(
@@ -595 +595 @@
  *
  * @since MU (3.0.0)
- * @deprecated 5.0.0
+ * @deprecated 5.1.0
  *
  * @global wpdb     $wpdb
@@ -606 +606 @@
     global $wpdb, $wp_roles;
 
-    _deprecated_function( __FUNCTION__, '5.0.0' );
+    _deprecated_function( __FUNCTION__, '5.1.0' );
 
     // Cast for security

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

@@ -1348 +1348 @@
  *
  * @since MU (3.0.0)
- * @since 5.0.0 $blog_id now supports input from the {@see 'wp_initialize_site'} action.
+ * @since 5.1.0 $blog_id now supports input from the {@see 'wp_initialize_site'} action.
  *
  * @param WP_Site|int $blog_id    The new site's object or ID.
@@ -1900 +1900 @@
  *
  * @since MU (3.0.0)
- * @since 5.0.0 Parameters now support input from the {@see 'wp_initialize_site'} action.
+ * @since 5.1.0 Parameters now support input from the {@see 'wp_initialize_site'} action.
  *
  * @global wpdb $wpdb WordPress database abstraction object.