Changeset 53741 for trunk/src/wp-includes/theme.php

Timestamp:

07/20/2022 09:11:30 PM (4 years ago)

Author:

audrasjb

Message:

Themes: Add a hook to filter theme header image URL.

This changeset introduces the get_header_image filter, which can be used to modify header image URL returned by get_header_image(), in themes that support the Header Image feature.

Props hztyfoon, audrasjb, mukesh27, SergeyBiryukov, costdev.
Fixes #56180.

File:

• trunk/src/wp-includes/theme.php (modified) (1 diff)

trunk/src/wp-includes/theme.php

@@ -1180 +1180 @@
         }
 
+        /**
+         * Filters the header image URL.
+         *
+         * @since 6.1.0
+         *
+         * @param string $url Header image URL.
+         */
+        $url = apply_filters( 'get_header_image', $url );
+
+        if ( ! is_string( $url ) ) {
+                return false;
+        }
+
+        $url = trim( $url );
         return sanitize_url( set_url_scheme( $url ) );
 }