Ticket #21389: 21389.diff

src/wp-includes/theme.php

@@ -994 +994 @@
 }
 
 /**
+ * Create image markup for a custom header image.
+ *
+ * @since 4.4.0
+ *
+ * @param array $attr Optional. Attributes for the image markup. Default empty.
+ * @return string|bool HTML element or false on failure.
+ */
+function get_header_image_tag( $attr = array() ) {
+        if ( ! $header = get_custom_header() ) {
+                return false;
+        }
+
+        /**
+         * Filter the markup of header images.
+         *
+         * @since 4.4.0
+         *
+         * @param string $html   The HTML markup being filtered.
+         * @param object $header The custom header object returned by 'get_custom_header()'
+         * @param array  $attr   An array of attributes for the image markup.
+         */
+        return apply_filters( 'get_header_image_tag',  wp_get_attachment_image( $header->attachment_id, 'full', false, $attr ), $header, $attr );
+}
+
+/**
+ * Display the image markup for a custom header image.
+ *
+ * @since 4.4.0
+ *
+ * @param array $attr Optional. Attributes for the image markup. Default empty.
+ */
+function the_header_image_tag( $attr = array() ) {
+        echo get_header_image_tag( $attr );
+}
+
+/**
  * Get random header image data from registered images in theme.
  *
  * @since 3.4.0