Changeset 38936

Timestamp:

10/25/2016 11:43:01 PM (10 years ago)

Author:

jeremyfelt

Message:

Multisite: Deprecate the blog_details filter.

get_site() has replaced get_blog_details() throughout core and is the recommended way to retrieve a current or single site object.

The blog_details filter is applied when full details are requested from get_blog_details().

To ensure backwards compatibility in the switch to get_site(), this blog_details filter is now applied in WP_Site::get_details() and marked as deprecated with a note to rely instead on the site_details filter introduced in 4.6.

Props flixos90.
See #37102.
Fixes #38491.

Location:

trunk/src/wp-includes

Files:

• class-wp-site.php (modified) (1 diff)
• ms-blogs.php (modified) (1 diff)

trunk/src/wp-includes/class-wp-site.php

@@ -347 +347 @@
                 }
 
+                /** This filter is documented in wp-includes/ms-blogs.php */
+                $details = apply_filters_deprecated( 'blog_details', array( $details ), '4.7.0', 'site_details' );
+
                 /**
                  * Filters a site's extended properties.

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

@@ -241 +241 @@
          *
          * @since MU
+         * @deprecated 4.7.0 Use site_details
          *
          * @param object $details The blog details.
          */
-        $details = apply_filters( 'blog_details', $details );
+        $details = apply_filters_deprecated( 'blog_details', array( $details ), '4.7.0', 'site_details' );
 
         wp_cache_set( $blog_id . $all, $details, 'blog-details' );