Changeset 36366 for trunk/src/wp-includes/class-wp-theme.php

Timestamp:

01/20/2016 06:28:33 PM (9 years ago)

Author:

jeremyfelt

Message:

Themes: Enhance filtering options for allowed themes on a network.

• Move the legacy allowed_themes filter to WP_Theme::get_allowed_on_network(), where it will continue to filter themes allowed on the network.
• Add network_allowed_themes filter to WP_Theme::get_allowed() and pass $blog_id to provide context.
• Add site_allowed_themes filter to WP_Theme::get_allowed_on_site() and pass $blog_id to provide context.

Props pauldewouters, lamosty, michalzuber, dmsnell, johnnypea, rob.
Fixes #28436.

File:

• trunk/src/wp-includes/class-wp-theme.php (modified) (5 diffs)

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

@@ -1178 +1178 @@
      * @access public
      *
-     * @param int $blog_id Optional. Defaults to current blog.
+     * @param int $blog_id Optional. ID of the site. Defaults to the current site.
      * @return array Array of stylesheet names.
      */
     public static function get_allowed( $blog_id = null ) {
         /**
-         * Filter the array of themes allowed on the site or network.
+         * Filter the array of themes allowed on the network.
+         *
+         * Site is provided as context so that a list of network allowed themes can
+         * be filtered further.
+         *
+         * @since 4.5.0
+         *
+         * @param array $allowed_themes An array of theme stylesheet names.
+         * @param int   $blog_id        ID of the site.
+         */
+        $network = (array) apply_filters( 'network_allowed_themes', self::get_allowed_on_network(), $blog_id );
+        return $network + self::get_allowed_on_site( $blog_id );
+    }
+
+    /**
+     * Returns array of stylesheet names of themes allowed on the network.
+     *
+     * @since 3.4.0
+     *
+     * @static
+     * @access public
+     *
+     * @staticvar array $allowed_themes
+     *
+     * @return array Array of stylesheet names.
+     */
+    public static function get_allowed_on_network() {
+        static $allowed_themes;
+        if ( ! isset( $allowed_themes ) ) {
+            $allowed_themes = (array) get_site_option( 'allowedthemes' );
+        }
+
+        /**
+         * Filter the array of themes allowed on the network.
          *
          * @since MU
@@ -1189 +1222 @@
          * @param array $allowed_themes An array of theme stylesheet names.
          */
-        $network = (array) apply_filters( 'allowed_themes', self::get_allowed_on_network() );
-        return $network + self::get_allowed_on_site( $blog_id );
-    }
-
-    /**
-     * Returns array of stylesheet names of themes allowed on the network.
+        $allowed_themes = apply_filters( 'allowed_themes', $allowed_themes );
+
+        return $allowed_themes;
+    }
+
+    /**
+     * Returns array of stylesheet names of themes allowed on the site.
      *
      * @since 3.4.0
@@ -1203 +1237 @@
      * @staticvar array $allowed_themes
      *
-     * @return array Array of stylesheet names.
-     */
-    public static function get_allowed_on_network() {
-        static $allowed_themes;
-        if ( ! isset( $allowed_themes ) )
-            $allowed_themes = (array) get_site_option( 'allowedthemes' );
-        return $allowed_themes;
-    }
-
-    /**
-     * Returns array of stylesheet names of themes allowed on the site.
-     *
-     * @since 3.4.0
-     *
-     * @static
-     * @access public
-     *
-     * @staticvar array $allowed_themes
-     *
-     * @param int $blog_id Optional. Defaults to current blog.
+     * @param int $blog_id Optional. ID of the site. Defaults to the current site.
      * @return array Array of stylesheet names.
      */
@@ -1231 +1246 @@
             $blog_id = get_current_blog_id();
 
-        if ( isset( $allowed_themes[ $blog_id ] ) )
-            return $allowed_themes[ $blog_id ];
+        if ( isset( $allowed_themes[ $blog_id ] ) ) {
+            /**
+             * Filter the array of themes allowed on the site.
+             *
+             * @since 4.5.0
+             *
+             * @param array $allowed_themes An array of theme stylesheet names.
+             * @param int   $blog_id        ID of the site. Defaults to current site.
+             */
+            return (array) apply_filters( 'site_allowed_themes', $allowed_themes[ $blog_id ], $blog_id );
+        }
 
         $current = $blog_id == get_current_blog_id();
@@ -1280 +1304 @@
         }
 
-        return (array) $allowed_themes[ $blog_id ];
+        /** This filter is documented in wp-includes/class-wp-theme.php */
+        return (array) apply_filters( 'site_allowed_themes', $allowed_themes[ $blog_id ], $blog_id );
     }