Changeset 46066

Timestamp:

09/05/2019 10:26:50 PM (5 years ago)

Author:

azaozz

Message:

Media: Add two new intermediate image sizes, 1536px and 2048px. They are meant to enhance the way WordPress displays images on the front-end on larger, high-density devices. They make it possible to generate more suitable srcset and sizes attributes, and not use the original, often non-optimized image.

Also change the default max_srcset_image_width value to match the new max size.

Props pierlo, azaozz.
See #43524.

Location:

trunk/src/wp-includes

Files:

• default-filters.php (modified) (1 diff)
• media.php (modified) (2 diffs)

trunk/src/wp-includes/default-filters.php

@@ -520 +520 @@
 add_action( 'wp_playlist_scripts', 'wp_playlist_scripts' );
 add_action( 'customize_controls_enqueue_scripts', 'wp_plupload_default_settings' );
+add_action( 'plugins_loaded', '_wp_add_additional_image_sizes', 0 );
 
 // Nav menu

trunk/src/wp-includes/media.php

@@ -1201 +1201 @@
      * @since 4.4.0
      *
-     * @param int   $max_width  The maximum image width to be included in the 'srcset'. Default '1600'.
+     * @param int   $max_width  The maximum image width to be included in the 'srcset'. Default '2048'.
      * @param array $size_array Array of width and height values in pixels (in that order).
      */
-    $max_srcset_image_width = apply_filters( 'max_srcset_image_width', 1600, $size_array );
+    $max_srcset_image_width = apply_filters( 'max_srcset_image_width', 2048, $size_array );
 
     // Array to hold URL candidates.
@@ -4330 +4330 @@
     );
 }
+
+/**
+ * Add additional default image sub-sizes.
+ *
+ * These sizes are meant to enhance the way WordPress displays images on the front-end on larger,
+ * high-density devices. They make it possible to generate more suitable `srcset` and `sizes` attributes
+ * when the users upload large images.
+ *
+ * The sizes can be changed or removed by themes and plugins but that is not recommended.
+ * The size "names" reflect the image dimensions, so changing the sizes would be quite misleading.
+ *
+ * @since 5.3.0
+ * @access private
+ */
+function _wp_add_additional_image_sizes() {
+    // 2x medium_large size
+    add_image_size( '1536x1536', 1536, 1536 );
+    // 2x large size
+    add_image_size( '2048x2048', 2048, 2048 );
+}