Changeset 58849 for trunk/src/wp-includes/media.php

Timestamp:

08/05/2024 04:11:40 AM (15 months ago)

Author:

noisysocks

Message:

Media: Automatically convert HEIC images to JPEG

Automatically create a JPEG version of uploaded HEIC images if the server has
a version of Imagick that supports HEIC. Conversion is done silently through
the existing WP_Image_Editor infrastructure that creates multiple sizes of
uploaded images.

This allows users to view HEIC images in WP Admin and use them in their posts
and pages regardless of whether their browser supports HEIC. Browser support
for HEIC is relatively low (only Safari) while the occurrence of HEIC images is
relatively common. The original HEIC image can be downloaded via a link on
the attachment page.

Props adamsilverstein, noisysocks, swissspidy, spacedmonkey, peterwilsoncc.
Fixes #53645.

File:

• trunk/src/wp-includes/media.php (modified) (6 diffs)

trunk/src/wp-includes/media.php

@@ -4065 +4065 @@
     // Check and set the output mime type mapped to the input type.
     if ( isset( $args['mime_type'] ) ) {
-        /** This filter is documented in wp-includes/class-wp-image-editor.php */
-        $output_format = apply_filters( 'image_editor_output_format', array(), $path, $args['mime_type'] );
+        $output_format = wp_get_image_editor_output_format( $path, $args['mime_type'] );
         if ( isset( $output_format[ $args['mime_type'] ] ) ) {
             $args['output_mime_type'] = $output_format[ $args['mime_type'] ];
@@ -4223 +4222 @@
     if ( ! wp_image_editor_supports( array( 'mime_type' => 'image/avif' ) ) ) {
         $defaults['avif_upload_error'] = true;
+    }
+
+    // Check if HEIC images can be edited.
+    if ( ! wp_image_editor_supports( array( 'mime_type' => 'image/heic' ) ) ) {
+        $defaults['heic_upload_error'] = true;
     }
 
@@ -5484 +5488 @@
  *
  * @since 5.5.0
+ * @since 6.7.0 The default behavior is to enable heic uplooads as long as the server
+ *              supports the format. The uploads are converted to JPEG's by default.
  *
  * @param array[] $plupload_settings The settings for Plupload.js.
@@ -5489 +5495 @@
  */
 function wp_show_heic_upload_error( $plupload_settings ) {
-    $plupload_settings['heic_upload_error'] = true;
+    // Check if HEIC images can be edited.
+    if ( ! wp_image_editor_supports( array( 'mime_type' => 'image/heic' ) ) ) {
+        $plupload_init['heic_upload_error'] = true;
+    }
     return $plupload_settings;
 }
@@ -5583 +5592 @@
                 ),
                 'mime' => 'image/avif',
+            );
+        }
+    }
+
+    // For PHP versions that don't support HEIC images, extract the size info using Imagick when available.
+    if ( 'image/heic' === wp_get_image_mime( $filename ) ) {
+        $editor = wp_get_image_editor( $filename );
+        if ( is_wp_error( $editor ) ) {
+            return false;
+        }
+        // If the editor for HEICs is Imagick, use it to get the image size.
+        if ( $editor instanceof WP_Image_Editor_Imagick ) {
+            $size = $editor->get_size();
+            return array(
+                $size['width'],
+                $size['height'],
+                IMAGETYPE_HEIC,
+                sprintf(
+                    'width="%d" height="%d"',
+                    $size['width'],
+                    $size['height']
+                ),
+                'mime' => 'image/heic',
             );
         }
@@ -6070 +6102 @@
     return $high_priority_element;
 }
+
+/**
+ * Determines the output format for the image editor.
+ *
+ * @since 6.7.0
+ * @access private
+ *
+ * @param string $filename  Path to the image.
+ * @param string $mime_type The source image mime type.
+ * @return string[] An array of mime type mappings.
+ */
+function wp_get_image_editor_output_format( $filename, $mime_type ) {
+    /**
+     * Filters the image editor output format mapping.
+     *
+     * Enables filtering the mime type used to save images. By default,
+     * the mapping array is empty, so the mime type matches the source image.
+     *
+     * @see WP_Image_Editor::get_output_format()
+     *
+     * @since 5.8.0
+     * @since 6.7.0 The default was changed from array() to array( 'image/heic' => 'image/jpeg' ).
+     *
+     * @param string[] $output_format {
+     *     An array of mime type mappings. Maps a source mime type to a new
+     *     destination mime type. Default maps uploaded HEIC images to JPEG output.
+     *
+     *     @type string ...$0 The new mime type.
+     * }
+     * @param string $filename  Path to the image.
+     * @param string $mime_type The source image mime type.
+     */
+    return apply_filters( 'image_editor_output_format', array( 'image/heic' => 'image/jpeg' ), $filename, $mime_type );
+}