Ticket #38738: 38738.4.diff

src/wp-includes/theme.php

@@ -1400 +1400 @@
  * @return bool True if a custom header is set. False if not.
  */
 function has_custom_header() {
-        if ( has_header_image() || ( is_front_page() && has_header_video() ) ) {
+        if ( has_header_image() || ( has_header_video() && is_header_video_active() ) ) {
                 return true;
         }
 
@@ -1408 +1408 @@
 }
 
 /**
+ * Checks whether the custom header video is eligible to show on the current page.
+ *
+ * @since 4.7.0
+ *
+ * @return bool True if the custom header video should be shown. False if not.
+ */
+function is_header_video_active() {
+        if ( ! get_theme_support( 'custom-header', 'video' ) ) {
+                return false;
+        }
+
+        $video_active_cb = get_theme_support( 'custom-header', 'video-active-callback' );
+
+        if ( empty( $video_active_cb ) || ! is_callable( $video_active_cb ) ) {
+                $show_video = true;
+        } else {
+                $show_video = call_user_func( $video_active_cb );
+        }
+
+        /**
+         * Modify whether the custom header video is eligible to show on the current page.
+         *
+         * @since 4.7.0
+         *
+         * @param bool $show_video Whether the custom header video should be shown. Defaults to the value of the theme setting for the `custom-header`'s `video-active-callback`. If no callback is set, the default value is that of `is_front_page()`.
+         */
+        return apply_filters( 'is_header_video_active', $show_video );
+}
+
+/**
  * Retrieve the markup for a custom header.
  *
  * The container div will always be returned in the Customizer preview.
@@ -1442 +1472 @@
 
         echo $custom_header;
 
-        if ( is_front_page() && ( has_header_video() || is_customize_preview() ) ) {
+        if ( is_header_video_active() && ( has_header_video() || is_customize_preview() ) ) {
                 wp_enqueue_script( 'wp-custom-header' );
                 wp_localize_script( 'wp-custom-header', '_wpCustomHeaderSettings', get_header_video_settings() );
         }
@@ -2058 +2088 @@
                                 'admin-head-callback' => '',
                                 'admin-preview-callback' => '',
                                 'video' => false,
+                                'video-active-callback' => 'is_front_page',
                         );
 
                         $jit = isset( $args[0]['__jit'] );

tests/phpunit/tests/theme/support.php

@@ -191 +191 @@
                 $this->assertEmpty( get_registered_nav_menus() );
                 $this->assertFalse( current_theme_supports( 'menus' ) );
         }
+
+        /**
+         * @ticket 38738
+         */
+        function test_video_header_callback() {
+                // Back up theme features global to avoid poisoning later tests.
+                global $_wp_theme_features;
+                $_wp_theme_features_backup = $_wp_theme_features;
+
+                add_theme_support( 'custom-header', array(
+                        'video' => true,
+                        '__jit' => true, // Force refresh.
+                ) );
+
+                $p = self::factory()->post->create( array(
+                        'post_status' => 'publish',
+                ) );
+
+                $this->go_to( home_url() );
+                $this->assertTrue( is_header_video_active() );
+
+                $this->go_to( get_permalink( $p ) );
+                $this->assertSame( false, is_header_video_active() );
+
+                /*
+                 * Change callback to __return_true().
+                 *
+                 * Support must be removed first, otherwise the previously set
+                 * values will override the new values.
+                 */
+                remove_theme_support( 'custom-header' );
+                add_theme_support( 'custom-header', array(
+                        'video' => true,
+                        'video-active-callback' => '__return_true',
+                        '__jit' => true, // Force refresh.
+                ) );
+
+                $this->assertTrue( is_header_video_active() );
+
+                // Now check the filter works as expected.
+                add_filter( 'is_header_video_active', '__return_false' );
+                $this->assertSame( false, is_header_video_active() );
+                remove_filter( 'is_header_video_active', '__return_false' );
+
+                // Restore theme features global to initial state.
+                $_wp_theme_features = $_wp_theme_features_backup;
+        }
 }