Changeset 56583 for trunk/src/wp-content/themes/twentyeleven/functions.php

Timestamp:

09/14/2023 11:23:59 AM (15 months ago)

Author:

spacedmonkey

Message:

Bundled Theme: Implement the_header_image_tag function for enhanced compatibility for older core themes.

The the_header_image_tag function was introduced in WordPress 4.4 as part of [35594]. It is used in all themes created post WordPress 4.4 that supported header images. The function get_header_image_tag continues to get updated with new image features, like lazy loading, async decoding and fetch priority. To ensure our core themes maintain compatibility and benefit from these enhancements, a backward compatibility shim has been applied, integrating the the_header_image_tag function into the following core themes:

• Twenty Ten
• Twenty Eleven
• Twenty Twelve
• Twenty Fourteen
• Twenty Sixteen

This change ensures future compatibility and modern image features are applied for header images to these older themes.

Props spacedmonkey, flixos90, mukesh27.
Fixes #58675.

File:

• trunk/src/wp-content/themes/twentyeleven/functions.php (modified) (1 diff)

trunk/src/wp-content/themes/twentyeleven/functions.php

@@ -441 +441 @@
 endif; // twentyeleven_admin_header_image()
 
+
+if ( ! function_exists( 'twentyeleven_header_image' ) ) :
+    /**
+     * Custom header image markup displayed.
+     *
+     * @since Twenty Eleven 4.5
+     */
+    function twentyeleven_header_image() {
+        $attrs = array(
+            'alt' => get_bloginfo( 'name', 'display' ),
+        );
+
+        // Compatibility with versions of WordPress prior to 3.4.
+        if ( function_exists( 'get_custom_header' ) ) {
+            $custom_header   = get_custom_header();
+            $attrs['width']  = $custom_header->width;
+            $attrs['height'] = $custom_header->height;
+        } else {
+            $attrs['width']  = HEADER_IMAGE_WIDTH;
+            $attrs['height'] = HEADER_IMAGE_HEIGHT;
+        }
+
+        if ( function_exists( 'the_header_image_tag' ) ) {
+            the_header_image_tag( $attrs );
+            return;
+        }
+
+        ?>
+        <img src="<?php header_image(); ?>" width="<?php echo esc_attr( $attrs['width'] ); ?>" height="<?php echo esc_attr( $attrs['height'] ); ?>" alt="<?php echo esc_attr( $attrs['alt'] ); ?>" />
+        <?php
+    }
+endif; // twentyeleven_header_image()
+
 /**
  * Set the post excerpt length to 40 words.