mirror of
https://github.com/WordPress/WordPress.git
synced 2024-07-03 10:14:54 +02:00
71ca314193
This changeset adds the capability for core media uploads to generate sub sized images in more than a single mime type. The output formats for each mime type can be controlled through a filter. WebP is used as an additional output format for JPEG images by default to improve front end performance. When generating additional mime types, only images which are smaller than the respective original are retained. By default, additional mime type images are only generated for the built-in core image sizes and any custom sizes that have opted in. Image meta is updated with a new 'sources' array containing file details for each mime type. Each image size in the 'sizes' array also gets a new 'sources' array that contains the image file details for each mime type. This change also increases image upload retries to accommodate additional image sizes. It also adds a `$mime_type` parameter to the `wp_get_missing_image_subsizes` function and filter. This change adds three new filters to enable full control of secondary mime image generation and output: * A new filter `wp_image_sizes_with_additional_mime_type_support` that filters the sizes that support secondary mime type output. Developers can use this to control the output of additional mime type sub-sized images on a per size basis. * A new filter `wp_upload_image_mime_transforms` that filters the output mime types for a given input mime type. Developers can use this to control generation of additional mime types for a given input mime type or even override the original mime type. * A new filter `wp_content_image_mimes` which controls image mime type output selection and order for frontend content. Developers can use this to control the mime type output preference order for content images. Content images inserted from the media library will use the available image versions based on the order from this filter. Thanks to the many contributors who helped develop, test and give feedback on this feature. A haiku to summarize: Upload a JPEG Images of all sizes Output as WebPs Props flixos90, MatthiasReinholz, studiolxv, markhowellsmead, eatingrules, pbiron, mukesh27, joegrainger, mehulkaklotar, tweetythierry, akshitsethi, peterwilsoncc, eugenemanuilov, mitogh, shetheliving, clarkeemily, codekraft, mikeschroder, clorith, kasparsd, spacedmonkey, trevorpfromsandee, jb510, scofennellgmailcom, seedsca, cagsmith, karinclimber, dainemawer, baxbridge, grapplerulrich, sobatkras, chynnabenton, tonylocalword, barneydavey, kwillmorth, garymatthews919, olliejones, imarkinteractive, jeffpaul, feastdesignco, webbeetle, masteradhoc. See #55443. Built from https://develop.svn.wordpress.org/trunk@53751 git-svn-id: http://core.svn.wordpress.org/trunk@53310 1a063a9b-81f0-0310-95a4-ce76da25c4cd
1539 lines
53 KiB
PHP
1539 lines
53 KiB
PHP
<?php
|
|
/**
|
|
* File contains all the administration image manipulation functions.
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Administration
|
|
*/
|
|
|
|
/**
|
|
* Crops an image to a given size.
|
|
*
|
|
* @since 2.1.0
|
|
*
|
|
* @param string|int $src The source file or Attachment ID.
|
|
* @param int $src_x The start x position to crop from.
|
|
* @param int $src_y The start y position to crop from.
|
|
* @param int $src_w The width to crop.
|
|
* @param int $src_h The height to crop.
|
|
* @param int $dst_w The destination width.
|
|
* @param int $dst_h The destination height.
|
|
* @param bool|false $src_abs Optional. If the source crop points are absolute.
|
|
* @param string|false $dst_file Optional. The destination file to write to.
|
|
* @return string|WP_Error New filepath on success, WP_Error on failure.
|
|
*/
|
|
function wp_crop_image( $src, $src_x, $src_y, $src_w, $src_h, $dst_w, $dst_h, $src_abs = false, $dst_file = false ) {
|
|
$src_file = $src;
|
|
if ( is_numeric( $src ) ) { // Handle int as attachment ID.
|
|
$src_file = get_attached_file( $src );
|
|
|
|
if ( ! file_exists( $src_file ) ) {
|
|
// If the file doesn't exist, attempt a URL fopen on the src link.
|
|
// This can occur with certain file replication plugins.
|
|
$src = _load_image_to_edit_path( $src, 'full' );
|
|
} else {
|
|
$src = $src_file;
|
|
}
|
|
}
|
|
|
|
$editor = wp_get_image_editor( $src );
|
|
if ( is_wp_error( $editor ) ) {
|
|
return $editor;
|
|
}
|
|
|
|
$src = $editor->crop( $src_x, $src_y, $src_w, $src_h, $dst_w, $dst_h, $src_abs );
|
|
if ( is_wp_error( $src ) ) {
|
|
return $src;
|
|
}
|
|
|
|
if ( ! $dst_file ) {
|
|
$dst_file = str_replace( wp_basename( $src_file ), 'cropped-' . wp_basename( $src_file ), $src_file );
|
|
}
|
|
|
|
/*
|
|
* The directory containing the original file may no longer exist when
|
|
* using a replication plugin.
|
|
*/
|
|
wp_mkdir_p( dirname( $dst_file ) );
|
|
|
|
$dst_file = dirname( $dst_file ) . '/' . wp_unique_filename( dirname( $dst_file ), wp_basename( $dst_file ) );
|
|
|
|
$result = $editor->save( $dst_file );
|
|
if ( is_wp_error( $result ) ) {
|
|
return $result;
|
|
}
|
|
|
|
if ( ! empty( $result['path'] ) ) {
|
|
return $result['path'];
|
|
}
|
|
|
|
return $dst_file;
|
|
}
|
|
|
|
/**
|
|
* Compare the existing image sub-sizes (as saved in the attachment meta)
|
|
* to the currently registered image sub-sizes, and return the difference.
|
|
*
|
|
* Registered sub-sizes that are larger than the image are skipped.
|
|
*
|
|
* @since 5.3.0
|
|
* @since 6.1.0 The $mime_type parameter was added.
|
|
*
|
|
* @param int $attachment_id The image attachment post ID.
|
|
* @param string $mime_type Optional. The mime type to check for missing sizes. Default is the primary image mime.
|
|
* @return array[] Associative array of arrays of image sub-size information for
|
|
* missing image sizes, keyed by image size name.
|
|
*/
|
|
function wp_get_missing_image_subsizes( $attachment_id, $mime_type = '' ) {
|
|
if ( ! wp_attachment_is_image( $attachment_id ) ) {
|
|
return array();
|
|
}
|
|
|
|
$primary_mime_type = get_post_mime_type( get_post( $attachment_id ) );
|
|
if ( ! $mime_type ) {
|
|
$mime_type = $primary_mime_type;
|
|
}
|
|
|
|
$registered_sizes = wp_get_registered_image_subsizes();
|
|
$image_meta = wp_get_attachment_metadata( $attachment_id );
|
|
|
|
// Meta error?
|
|
if ( empty( $image_meta ) ) {
|
|
return $registered_sizes;
|
|
}
|
|
|
|
// Use the originally uploaded image dimensions as full_width and full_height.
|
|
if ( ! empty( $image_meta['original_image'] ) ) {
|
|
$image_file = wp_get_original_image_path( $attachment_id );
|
|
$imagesize = wp_getimagesize( $image_file );
|
|
}
|
|
|
|
if ( ! empty( $imagesize ) ) {
|
|
$full_width = $imagesize[0];
|
|
$full_height = $imagesize[1];
|
|
} else {
|
|
$full_width = (int) $image_meta['width'];
|
|
$full_height = (int) $image_meta['height'];
|
|
}
|
|
|
|
$possible_sizes = array();
|
|
|
|
// Skip registered sizes that are too large for the uploaded image.
|
|
foreach ( $registered_sizes as $size_name => $size_data ) {
|
|
if ( image_resize_dimensions( $full_width, $full_height, $size_data['width'], $size_data['height'], $size_data['crop'] ) ) {
|
|
$possible_sizes[ $size_name ] = $size_data;
|
|
}
|
|
}
|
|
|
|
if ( empty( $image_meta['sizes'] ) ) {
|
|
$image_meta['sizes'] = array();
|
|
}
|
|
|
|
/*
|
|
* Remove sizes that already exist. Only checks for matching "size names".
|
|
* It is possible that the dimensions for a particular size name have changed.
|
|
* For example the user has changed the values on the Settings -> Media screen.
|
|
* However we keep the old sub-sizes with the previous dimensions
|
|
* as the image may have been used in an older post.
|
|
*/
|
|
$missing_sizes = array();
|
|
foreach ( $possible_sizes as $size_name => $size_data ) {
|
|
if ( ! isset( $image_meta['sizes'][ $size_name ] ) ) {
|
|
$missing_sizes[ $size_name ] = $size_data;
|
|
continue;
|
|
}
|
|
|
|
if ( ( isset( $size_data['mime-type'] ) && $size_data['mime-type'] === $mime_type ) || isset( $size_data['sources'][ $mime_type ] ) ) {
|
|
continue;
|
|
}
|
|
|
|
$missing_sizes[ $size_name ] = $size_data;
|
|
}
|
|
|
|
// Filter secondary mime types to those sizes that are enabled.
|
|
if ( $primary_mime_type !== $mime_type ) {
|
|
$missing_sizes = _wp_filter_image_sizes_additional_mime_type_support( $missing_sizes, $attachment_id );
|
|
}
|
|
|
|
/**
|
|
* Filters the array of missing image sub-sizes for an uploaded image.
|
|
*
|
|
* @since 5.3.0
|
|
* @since 6.1.0 The $mime_type filter parameter was added.
|
|
*
|
|
* @param array[] $missing_sizes Associative array of arrays of image sub-size information for
|
|
* missing image sizes, keyed by image size name.
|
|
* @param array $image_meta The image meta data.
|
|
* @param int $attachment_id The image attachment post ID.
|
|
* @param string $mime_type The image mime type to get missing sizes for.
|
|
*/
|
|
return apply_filters( 'wp_get_missing_image_subsizes', $missing_sizes, $image_meta, $attachment_id, $mime_type );
|
|
}
|
|
|
|
/**
|
|
* If any of the currently registered image sub-sizes are missing,
|
|
* create them and update the image meta data.
|
|
*
|
|
* @since 5.3.0
|
|
* @since 6.1.0 Now supports additional mime types, creating the additional sub-sizes and 'full' sized images.
|
|
*
|
|
* @param int $attachment_id The image attachment post ID.
|
|
* @return array|WP_Error The updated image meta data array or WP_Error object
|
|
* if both the image meta and the attached file are missing.
|
|
*/
|
|
function wp_update_image_subsizes( $attachment_id ) {
|
|
$image_meta = wp_get_attachment_metadata( $attachment_id );
|
|
$image_file = wp_get_original_image_path( $attachment_id );
|
|
|
|
if ( empty( $image_meta ) || ! is_array( $image_meta ) ) {
|
|
// Previously failed upload?
|
|
// If there is an uploaded file, make all sub-sizes and generate all of the attachment meta.
|
|
if ( ! empty( $image_file ) ) {
|
|
$image_meta = wp_create_image_subsizes( $image_file, $attachment_id );
|
|
} else {
|
|
return new WP_Error( 'invalid_attachment', __( 'The attached file cannot be found.' ) );
|
|
}
|
|
} else {
|
|
// Get the primary and additional mime types to generate.
|
|
list( $primary_mime_type, $additional_mime_types ) = _wp_get_primary_and_additional_mime_types( $image_file, $attachment_id );
|
|
|
|
// Generate missing 'full' image files for additional mime types.
|
|
if ( ! empty( $additional_mime_types ) ) {
|
|
if ( isset( $image_meta['sources'] ) ) {
|
|
$missing_mime_types = array_diff( $additional_mime_types, array_keys( $image_meta['sources'] ) );
|
|
} else {
|
|
$missing_mime_types = $additional_mime_types;
|
|
}
|
|
if ( ! empty( $missing_mime_types ) ) {
|
|
$image_meta = _wp_make_additional_mime_types( $missing_mime_types, $image_file, $image_meta, $attachment_id );
|
|
}
|
|
}
|
|
|
|
// Generate missing image sub-sizes for each mime type.
|
|
$all_mime_types = array_merge( array( $primary_mime_type ), $additional_mime_types );
|
|
foreach ( $all_mime_types as $mime_type ) {
|
|
$missing_sizes = wp_get_missing_image_subsizes( $attachment_id, $mime_type );
|
|
|
|
if ( empty( $missing_sizes ) ) {
|
|
continue;
|
|
}
|
|
|
|
// This also updates the image meta.
|
|
$image_meta = _wp_make_subsizes( $missing_sizes, $image_file, $image_meta, $attachment_id, $mime_type );
|
|
}
|
|
}
|
|
|
|
/** This filter is documented in wp-admin/includes/image.php */
|
|
$image_meta = apply_filters( 'wp_generate_attachment_metadata', $image_meta, $attachment_id, 'update' );
|
|
|
|
// Save the updated metadata.
|
|
wp_update_attachment_metadata( $attachment_id, $image_meta );
|
|
|
|
return $image_meta;
|
|
}
|
|
|
|
/**
|
|
* Updates the attached file and image meta data when the original image was edited.
|
|
*
|
|
* @since 5.3.0
|
|
* @since 6.0.0 The `$filesize` value was added to the returned array.
|
|
* @access private
|
|
*
|
|
* @param array $saved_data The data returned from WP_Image_Editor after successfully saving an image.
|
|
* @param string $original_file Path to the original file.
|
|
* @param array $image_meta The image meta data.
|
|
* @param int $attachment_id The attachment post ID.
|
|
* @return array The updated image meta data.
|
|
*/
|
|
function _wp_image_meta_replace_original( $saved_data, $original_file, $image_meta, $attachment_id ) {
|
|
$new_file = $saved_data['path'];
|
|
|
|
// Update the attached file meta.
|
|
update_attached_file( $attachment_id, $new_file );
|
|
|
|
// Width and height of the new image.
|
|
$image_meta['width'] = $saved_data['width'];
|
|
$image_meta['height'] = $saved_data['height'];
|
|
|
|
// Make the file path relative to the upload dir.
|
|
$image_meta['file'] = _wp_relative_upload_path( $new_file );
|
|
|
|
// Add image file size.
|
|
$image_meta['filesize'] = wp_filesize( $new_file );
|
|
|
|
// Store the original image file name in image_meta.
|
|
$image_meta['original_image'] = wp_basename( $original_file );
|
|
|
|
return $image_meta;
|
|
}
|
|
|
|
/**
|
|
* Creates image mime variations and sub-sizes, adds the new data to the image meta `sizes` array, and updates the image metadata.
|
|
*
|
|
* Intended for use after an image is uploaded. Saves/updates the image metadata after each
|
|
* sub-size is created. If there was an error, it is added to the returned image metadata array.
|
|
*
|
|
* @since 5.3.0
|
|
* @since 6.1.0 Generates sub-sizes in alternate mime types based on the `wp_image_mime_transforms` filter.
|
|
*
|
|
* @param string $file Full path to the image file.
|
|
* @param int $attachment_id Attachment ID to process.
|
|
* @return array The image attachment meta data.
|
|
*/
|
|
function wp_create_image_subsizes( $file, $attachment_id ) {
|
|
$imagesize = wp_getimagesize( $file );
|
|
|
|
if ( empty( $imagesize ) ) {
|
|
// File is not an image.
|
|
return array();
|
|
}
|
|
|
|
// Default image meta.
|
|
$image_meta = array(
|
|
'width' => $imagesize[0],
|
|
'height' => $imagesize[1],
|
|
'file' => _wp_relative_upload_path( $file ),
|
|
'filesize' => wp_filesize( $file ),
|
|
'sizes' => array(),
|
|
'sources' => array(),
|
|
);
|
|
|
|
// Fetch additional metadata from EXIF/IPTC.
|
|
$exif_meta = wp_read_image_metadata( $file );
|
|
|
|
if ( $exif_meta ) {
|
|
$image_meta['image_meta'] = $exif_meta;
|
|
}
|
|
|
|
// Get the primary and additional mime types to generate.
|
|
list( $primary_mime_type, $additional_mime_types ) = _wp_get_primary_and_additional_mime_types( $file, $attachment_id );
|
|
|
|
list( $editor, $resized, $rotated ) = _wp_maybe_scale_and_rotate_image( $file, $attachment_id, $imagesize, $exif_meta, $primary_mime_type );
|
|
if ( is_wp_error( $editor ) ) {
|
|
return $image_meta;
|
|
}
|
|
$suffix = _wp_get_image_suffix( $resized, $rotated );
|
|
|
|
// Save image only if either it was modified or if the primary mime type is different from the original.
|
|
if ( ! empty( $suffix ) || $primary_mime_type !== $imagesize['mime'] ) {
|
|
$saved = $editor->save( $editor->generate_filename( $suffix ) );
|
|
|
|
if ( ! is_wp_error( $saved ) ) {
|
|
$image_meta = _wp_image_meta_replace_original( $saved, $file, $image_meta, $attachment_id );
|
|
|
|
// If the image was rotated update the stored EXIF data.
|
|
if ( true === $rotated && ! empty( $image_meta['image_meta']['orientation'] ) ) {
|
|
$image_meta['image_meta']['orientation'] = 1;
|
|
}
|
|
} else {
|
|
// TODO: Log errors.
|
|
}
|
|
}
|
|
|
|
// Set 'sources' for the primary mime type.
|
|
$image_meta['sources'][ $primary_mime_type ] = _wp_get_sources_from_meta( $image_meta );
|
|
|
|
/*
|
|
* Initial save of the new metadata.
|
|
* At this point the file was uploaded and moved to the uploads directory
|
|
* but the image sub-sizes haven't been created yet and the `sizes` array is empty.
|
|
*/
|
|
wp_update_attachment_metadata( $attachment_id, $image_meta );
|
|
|
|
if ( ! empty( $additional_mime_types ) ) {
|
|
// Use the original file's exif_meta orientation information for secondary mime generation.
|
|
$saved_orientation = $image_meta['image_meta']['orientation'];
|
|
$image_meta['image_meta']['orientation'] = $exif_meta['orientation'];
|
|
$image_meta = _wp_make_additional_mime_types( $additional_mime_types, $file, $image_meta, $attachment_id );
|
|
$image_meta['image_meta']['orientation'] = $saved_orientation;
|
|
|
|
}
|
|
|
|
$new_sizes = wp_get_registered_image_subsizes();
|
|
|
|
/**
|
|
* Filters the image sizes automatically generated when uploading an image.
|
|
*
|
|
* @since 2.9.0
|
|
* @since 4.4.0 Added the `$image_meta` argument.
|
|
* @since 5.3.0 Added the `$attachment_id` argument.
|
|
*
|
|
* @param array $new_sizes Associative array of image sizes to be created.
|
|
* @param array $image_meta The image meta data: width, height, file, sizes, etc.
|
|
* @param int $attachment_id The attachment post ID for the image.
|
|
*/
|
|
$new_sizes = apply_filters( 'intermediate_image_sizes_advanced', $new_sizes, $image_meta, $attachment_id );
|
|
|
|
$image_meta = _wp_make_subsizes( $new_sizes, $file, $image_meta, $attachment_id, $primary_mime_type );
|
|
|
|
// Filter secondary mime types to those sizes that are enabled.
|
|
$new_sizes = _wp_filter_image_sizes_additional_mime_type_support( $new_sizes, $attachment_id );
|
|
|
|
foreach ( $additional_mime_types as $additional_mime_type ) {
|
|
$image_meta = _wp_make_subsizes( $new_sizes, $file, $image_meta, $attachment_id, $additional_mime_type );
|
|
}
|
|
|
|
return $image_meta;
|
|
}
|
|
|
|
/**
|
|
* Returns a WP_Image_Editor instance where the image file has been scaled and rotated as necessary.
|
|
*
|
|
* @since 6.1.0
|
|
* @access private
|
|
*
|
|
* @param string $file Full path to the image file.
|
|
* @param int $attachment_id Attachment ID.
|
|
* @param array $imagesize {
|
|
* Indexed array of the image width and height in pixels.
|
|
*
|
|
* @type int $0 The image width.
|
|
* @type int $1 The image height.
|
|
* }
|
|
* @param array|null $exif_meta EXIF metadata if extracted from the image file.
|
|
* @param string $mime_type Output mime type.
|
|
* @return array Array with three entries: The WP_Image_Editor instance, whether the image was resized, and whether the
|
|
* image was rotated (booleans). Each entry can alternatively be a WP_Error in case something went wrong.
|
|
*/
|
|
function _wp_maybe_scale_and_rotate_image( $file, $attachment_id, $imagesize, $exif_meta, $mime_type ) {
|
|
$resized = false;
|
|
$rotated = false;
|
|
|
|
$editor = wp_get_image_editor( $file, array( 'mime_type' => $mime_type ) );
|
|
if ( is_wp_error( $editor ) ) {
|
|
// This image cannot be edited.
|
|
return array( $editor, $resized, $rotated );
|
|
}
|
|
|
|
if ( ! empty( $mime_type ) ) {
|
|
$editor->set_output_mime_type( $mime_type );
|
|
}
|
|
|
|
// Do not scale (large) PNG images. May result in sub-sizes that have greater file size than the original. See #48736.
|
|
if ( 'image/png' !== $mime_type ) {
|
|
/**
|
|
* Filters the "BIG image" threshold value.
|
|
*
|
|
* If the original image width or height is above the threshold, it will be scaled down. The threshold is
|
|
* used as max width and max height. The scaled down image will be used as the largest available size, including
|
|
* the `_wp_attached_file` post meta value.
|
|
*
|
|
* Returning `false` from the filter callback will disable the scaling.
|
|
*
|
|
* @since 5.3.0
|
|
*
|
|
* @param int $threshold The threshold value in pixels. Default 2560.
|
|
* @param array $imagesize {
|
|
* Indexed array of the image width and height in pixels.
|
|
*
|
|
* @type int $0 The image width.
|
|
* @type int $1 The image height.
|
|
* }
|
|
* @param string $file Full path to the uploaded image file.
|
|
* @param int $attachment_id Attachment post ID.
|
|
*/
|
|
$threshold = (int) apply_filters( 'big_image_size_threshold', 2560, $imagesize, $file, $attachment_id );
|
|
|
|
// If the original image's dimensions are over the threshold,
|
|
// scale the image and use it as the "full" size.
|
|
if ( $threshold && ( $imagesize[0] > $threshold || $imagesize[1] > $threshold ) ) {
|
|
// Resize the image.
|
|
$resized = $editor->resize( $threshold, $threshold );
|
|
|
|
// If there is EXIF data, rotate according to EXIF Orientation.
|
|
if ( ! is_wp_error( $resized ) && is_array( $exif_meta ) ) {
|
|
$rotated = $editor->maybe_exif_rotate();
|
|
}
|
|
} elseif ( ! empty( $exif_meta['orientation'] ) && 1 !== (int) $exif_meta['orientation'] ) {
|
|
// Rotate the whole original image if there is EXIF data and "orientation" is not 1.
|
|
$rotated = $editor->maybe_exif_rotate();
|
|
}
|
|
}
|
|
|
|
return array( $editor, $resized, $rotated );
|
|
}
|
|
|
|
/**
|
|
* Gets the suffix to use for image files based on resizing and rotating.
|
|
*
|
|
* @since 6.1.0
|
|
* @access private
|
|
*
|
|
* @param bool|WP_Error Whether the image was resized, or an error if resizing failed.
|
|
* @param bool|WP_Error Whether the image was rotated, or an error if rotating failed.
|
|
* @return string The suffix to use for the file name, or empty string if none.
|
|
*/
|
|
function _wp_get_image_suffix( $resized, $rotated ) {
|
|
if ( $resized && ! is_wp_error( $resized ) ) {
|
|
// Append "-scaled" to the image file name. It will look like "my_image-scaled.jpg".
|
|
// This doesn't affect the sub-sizes names as they are generated from the original image (for best quality).
|
|
return 'scaled';
|
|
}
|
|
|
|
if ( true === $rotated ) {
|
|
// Append `-rotated` to the image file name.
|
|
return 'rotated';
|
|
}
|
|
|
|
if ( is_wp_error( $resized ) || is_wp_error( $rotated ) ) {
|
|
// TODO: Log errors.
|
|
}
|
|
return '';
|
|
}
|
|
|
|
/**
|
|
* Gets a sources array element from a meta.
|
|
*
|
|
* @since 6.1.0
|
|
* @access private
|
|
*
|
|
* @param array $meta The meta to get the source from.
|
|
* @return array The source array element.
|
|
*/
|
|
function _wp_get_sources_from_meta( $meta ) {
|
|
return array(
|
|
'file' => isset( $meta['file'] ) ? wp_basename( $meta['file'] ) : '',
|
|
'filesize' => isset( $meta['filesize'] ) ? $meta['filesize'] : wp_filesize( $meta['path'] ),
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Low-level function to create image sub-sizes.
|
|
*
|
|
* Updates the image meta after each sub-size is created.
|
|
* Errors are stored in the returned image metadata array.
|
|
*
|
|
* @since 5.3.0
|
|
* @since 6.1.0 The $mime_type parameter was added.
|
|
* @access private
|
|
*
|
|
* @param array $new_sizes Array defining what sizes to create.
|
|
* @param string $file Full path to the image file.
|
|
* @param array $image_meta The attachment meta data array.
|
|
* @param int $attachment_id Attachment ID to process.
|
|
* @param string $mime_type Optional. The mime type to check for missing sizes. Default is the image mime of $file.
|
|
* @return array The attachment meta data with updated `sizes` array. Includes an array of errors encountered while resizing.
|
|
*/
|
|
function _wp_make_subsizes( $new_sizes, $file, $image_meta, $attachment_id, $mime_type = '' ) {
|
|
if ( empty( $image_meta ) || ! is_array( $image_meta ) ) {
|
|
// Not an image attachment.
|
|
return array();
|
|
}
|
|
|
|
if ( ! $mime_type ) {
|
|
$mime_type = wp_get_image_mime( $file );
|
|
}
|
|
|
|
// Check if any of the new sizes already exist.
|
|
if ( isset( $image_meta['sizes'] ) && is_array( $image_meta['sizes'] ) ) {
|
|
foreach ( $image_meta['sizes'] as $size_name => $size_meta ) {
|
|
/*
|
|
* Only checks "size name" so we don't override existing images even if the dimensions
|
|
* don't match the currently defined size with the same name.
|
|
* To change the behavior, unset changed/mismatched sizes in the `sizes` array in image meta.
|
|
*/
|
|
if ( array_key_exists( $size_name, $new_sizes ) ) {
|
|
// Unset the size if it is either the required mime type already exists either as main mime type or
|
|
// within sources.
|
|
if ( $size_meta['mime-type'] === $mime_type || isset( $size_meta['sources'][ $mime_type ] ) ) {
|
|
unset( $new_sizes[ $size_name ] );
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
$image_meta['sizes'] = array();
|
|
}
|
|
|
|
if ( empty( $new_sizes ) ) {
|
|
// Nothing to do...
|
|
return $image_meta;
|
|
}
|
|
|
|
/*
|
|
* Sort the image sub-sizes in order of priority when creating them.
|
|
* This ensures there is an appropriate sub-size the user can access immediately
|
|
* even when there was an error and not all sub-sizes were created.
|
|
*/
|
|
$priority = array(
|
|
'medium' => null,
|
|
'large' => null,
|
|
'thumbnail' => null,
|
|
'medium_large' => null,
|
|
);
|
|
|
|
$new_sizes = array_filter( array_merge( $priority, $new_sizes ) );
|
|
|
|
$editor = wp_get_image_editor( $file, array( 'mime_type' => $mime_type ) );
|
|
|
|
if ( is_wp_error( $editor ) ) {
|
|
// The image cannot be edited.
|
|
return $image_meta;
|
|
}
|
|
|
|
$editor->set_output_mime_type( $mime_type );
|
|
|
|
// If stored EXIF data exists, rotate the source image before creating sub-sizes.
|
|
if ( ! empty( $image_meta['image_meta'] ) ) {
|
|
$rotated = $editor->maybe_exif_rotate();
|
|
|
|
if ( is_wp_error( $rotated ) ) {
|
|
// TODO: Log errors.
|
|
}
|
|
}
|
|
|
|
if ( method_exists( $editor, 'make_subsize' ) ) {
|
|
foreach ( $new_sizes as $new_size_name => $new_size_data ) {
|
|
$new_size_meta = $editor->make_subsize( $new_size_data );
|
|
|
|
if ( is_wp_error( $new_size_meta ) ) {
|
|
// TODO: Log errors.
|
|
} else {
|
|
// Save the size meta value.
|
|
if ( ! isset( $image_meta['sizes'][ $new_size_name ] ) ) {
|
|
$image_meta['sizes'][ $new_size_name ] = $new_size_meta;
|
|
} else {
|
|
// Remove any newly generated images that are larger than the primary mime type.
|
|
$new_size = isset( $new_size_meta['filesize'] ) ? $new_size_meta['filesize'] : 0;
|
|
$primary_size = isset( $image_meta['sizes'][ $new_size_name ]['filesize'] ) ? $image_meta['sizes'][ $new_size_name ]['filesize'] : 0;
|
|
|
|
if ( $new_size && $primary_size && $new_size >= $primary_size ) {
|
|
wp_delete_file( dirname( $file ) . '/' . $new_size_meta['file'] );
|
|
continue;
|
|
}
|
|
}
|
|
if ( ! isset( $image_meta['sizes'][ $new_size_name ]['sources'] ) ) {
|
|
$image_meta['sizes'][ $new_size_name ]['sources'] = array();
|
|
}
|
|
$image_meta['sizes'][ $new_size_name ]['sources'][ $mime_type ] = _wp_get_sources_from_meta( $new_size_meta );
|
|
wp_update_attachment_metadata( $attachment_id, $image_meta );
|
|
}
|
|
}
|
|
} else {
|
|
// Fall back to `$editor->multi_resize()`.
|
|
$created_sizes = $editor->multi_resize( $new_sizes );
|
|
|
|
if ( ! empty( $created_sizes ) ) {
|
|
foreach ( $created_sizes as $created_size_name => $created_size_meta ) {
|
|
|
|
// Primary mime type is set in 'sizes' array.
|
|
if ( ! isset( $image_meta['sizes'][ $created_size_name ] ) ) {
|
|
$image_meta['sizes'][ $created_size_name ] = $created_size_meta;
|
|
} else {
|
|
// Remove any newly generated images that are larger than the primary mime type.
|
|
$new_size = isset( $created_size_meta['filesize'] ) ? $created_size_meta['filesize'] : 0;
|
|
$primary_size = isset( $image_meta['sizes'][ $created_size_name ]['filesize'] ) ? $image_meta['sizes'][ $created_size_name ]['filesize'] : 0;
|
|
|
|
if ( $new_size && $primary_size && $new_size >= $primary_size ) {
|
|
wp_delete_file( dirname( $file ) . '/' . $created_size_meta['file'] );
|
|
continue;
|
|
}
|
|
}
|
|
if ( ! isset( $image_meta['sizes'][ $created_size_name ]['sources'] ) ) {
|
|
$image_meta['sizes'][ $created_size_name ]['sources'] = array();
|
|
}
|
|
$image_meta['sizes'][ $created_size_name ]['sources'][ $mime_type ] = _wp_get_sources_from_meta( $new_size_meta );
|
|
}
|
|
wp_update_attachment_metadata( $attachment_id, $image_meta );
|
|
}
|
|
}
|
|
|
|
return $image_meta;
|
|
}
|
|
|
|
/**
|
|
* Filters the list of image size objects that support secondary mime type output.
|
|
*
|
|
* @since 6.1.0
|
|
*
|
|
* @param array $sizes Associative array of image sizes.
|
|
* @param int $attachment_id Attachment ID.
|
|
* @return array $sizes Filtered $sizes with only those that support secondary mime type output.
|
|
*/
|
|
function _wp_filter_image_sizes_additional_mime_type_support( $sizes, $attachment_id ) {
|
|
|
|
// Include only the core sizes that do not rely on add_image_size(). Additional image sizes are opt-in.
|
|
$enabled_sizes = array(
|
|
'thumbnail' => true,
|
|
'medium' => true,
|
|
'medium_large' => true,
|
|
'large' => true,
|
|
'post-thumbnail' => true,
|
|
);
|
|
|
|
/**
|
|
* Filter the sizes that support secondary mime type output. Developers can use this
|
|
* to control the output of additional mime type sub-sized images.
|
|
*
|
|
* @since 6.1.0
|
|
*
|
|
* @param array $enabled_sizes Map of size names and whether they support secondary mime type output.
|
|
* @param int $attachment_id Attachment ID.
|
|
*/
|
|
$enabled_sizes = apply_filters( 'wp_image_sizes_with_additional_mime_type_support', $enabled_sizes, $attachment_id );
|
|
|
|
// Filter supported sizes to only include enabled sizes.
|
|
return array_intersect_key( $sizes, array_filter( $enabled_sizes ) );
|
|
}
|
|
|
|
/**
|
|
* Low-level function to create full-size images in additional mime types.
|
|
*
|
|
* Updates the image meta after each mime type image is created.
|
|
*
|
|
* @since 6.1.0
|
|
* @access private
|
|
*
|
|
* @param array $new_mime_types Array defining what mime types to create.
|
|
* @param string $file Full path to the image file.
|
|
* @param array $image_meta The attachment meta data array.
|
|
* @param int $attachment_id Attachment ID to process.
|
|
* @return array The attachment meta data with updated `sizes` array. Includes an array of errors encountered while resizing.
|
|
*/
|
|
function _wp_make_additional_mime_types( $new_mime_types, $file, $image_meta, $attachment_id ) {
|
|
$imagesize = array(
|
|
$image_meta['width'],
|
|
$image_meta['height'],
|
|
);
|
|
$exif_meta = isset( $image_meta['image_meta'] ) ? $image_meta['image_meta'] : null;
|
|
$original_file_size = isset( $image_meta['filesize'] ) ? $image_meta['filesize'] : wp_filesize( $file );
|
|
|
|
foreach ( $new_mime_types as $mime_type ) {
|
|
list( $editor, $resized, $rotated ) = _wp_maybe_scale_and_rotate_image( $file, $attachment_id, $imagesize, $exif_meta, $mime_type );
|
|
if ( is_wp_error( $editor ) ) {
|
|
// The image cannot be edited.
|
|
continue;
|
|
}
|
|
|
|
$suffix = _wp_get_image_suffix( $resized, $rotated );
|
|
$extension = wp_get_default_extension_for_mime_type( $mime_type );
|
|
|
|
$saved = $editor->save( $editor->generate_filename( $suffix, null, $extension ) );
|
|
|
|
if ( is_wp_error( $saved ) ) {
|
|
// TODO: Log errors.
|
|
} else {
|
|
// If the saved image is larger than the original, discard it.
|
|
$filesize = isset( $saved['filesize'] ) ? $saved['filesize'] : wp_filesize( $saved['path'] );
|
|
if ( $filesize && $original_file_size && $filesize > $original_file_size ) {
|
|
wp_delete_file( $saved['path'] );
|
|
continue;
|
|
}
|
|
$image_meta['sources'][ $mime_type ] = _wp_get_sources_from_meta( $saved );
|
|
wp_update_attachment_metadata( $attachment_id, $image_meta );
|
|
}
|
|
}
|
|
|
|
return $image_meta;
|
|
}
|
|
|
|
|
|
/**
|
|
* Check if an image belongs to an attachment.
|
|
*
|
|
* @since 6.1.0
|
|
* @access private
|
|
*
|
|
* @param string $filename Full path to the image file.
|
|
* @param int $attachment_id Attachment ID to check.
|
|
* @return bool True if the image belongs to the attachment, false otherwise.
|
|
*/
|
|
function _wp_image_belongs_to_attachment( $filename, $attachment_id ) {
|
|
$meta_data = wp_get_attachment_metadata( $attachment_id );
|
|
|
|
if ( ! isset( $image_meta['sizes'] ) ) {
|
|
return false;
|
|
}
|
|
$sizes = $image_meta['sizes'];
|
|
foreach ( $sizes as $size ) {
|
|
if ( $size['file'] === $filename ) {
|
|
return true;
|
|
}
|
|
if ( isset( $size['sources'] ) && is_array( $size['sources'] ) ) {
|
|
foreach ( $size['sources'] as $source ) {
|
|
if ( $source['file'] === $filename ) {
|
|
return true;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Generate attachment meta data and create image sub-sizes for images.
|
|
*
|
|
* @since 2.1.0
|
|
* @since 6.0.0 The `$filesize` value was added to the returned array.
|
|
*
|
|
* @param int $attachment_id Attachment ID to process.
|
|
* @param string $file Filepath of the attached image.
|
|
* @return array Metadata for attachment.
|
|
*/
|
|
function wp_generate_attachment_metadata( $attachment_id, $file ) {
|
|
$attachment = get_post( $attachment_id );
|
|
|
|
$metadata = array();
|
|
$support = false;
|
|
$mime_type = get_post_mime_type( $attachment );
|
|
|
|
if ( preg_match( '!^image/!', $mime_type ) && file_is_displayable_image( $file ) ) {
|
|
// Make thumbnails and other intermediate sizes.
|
|
$metadata = wp_create_image_subsizes( $file, $attachment_id );
|
|
} elseif ( wp_attachment_is( 'video', $attachment ) ) {
|
|
$metadata = wp_read_video_metadata( $file );
|
|
$support = current_theme_supports( 'post-thumbnails', 'attachment:video' ) || post_type_supports( 'attachment:video', 'thumbnail' );
|
|
} elseif ( wp_attachment_is( 'audio', $attachment ) ) {
|
|
$metadata = wp_read_audio_metadata( $file );
|
|
$support = current_theme_supports( 'post-thumbnails', 'attachment:audio' ) || post_type_supports( 'attachment:audio', 'thumbnail' );
|
|
}
|
|
|
|
/*
|
|
* wp_read_video_metadata() and wp_read_audio_metadata() return `false`
|
|
* if the attachment does not exist in the local filesystem,
|
|
* so make sure to convert the value to an array.
|
|
*/
|
|
if ( ! is_array( $metadata ) ) {
|
|
$metadata = array();
|
|
}
|
|
|
|
if ( $support && ! empty( $metadata['image']['data'] ) ) {
|
|
// Check for existing cover.
|
|
$hash = md5( $metadata['image']['data'] );
|
|
$posts = get_posts(
|
|
array(
|
|
'fields' => 'ids',
|
|
'post_type' => 'attachment',
|
|
'post_mime_type' => $metadata['image']['mime'],
|
|
'post_status' => 'inherit',
|
|
'posts_per_page' => 1,
|
|
'meta_key' => '_cover_hash',
|
|
'meta_value' => $hash,
|
|
)
|
|
);
|
|
$exists = reset( $posts );
|
|
|
|
if ( ! empty( $exists ) ) {
|
|
update_post_meta( $attachment_id, '_thumbnail_id', $exists );
|
|
} else {
|
|
$ext = '.jpg';
|
|
switch ( $metadata['image']['mime'] ) {
|
|
case 'image/gif':
|
|
$ext = '.gif';
|
|
break;
|
|
case 'image/png':
|
|
$ext = '.png';
|
|
break;
|
|
case 'image/webp':
|
|
$ext = '.webp';
|
|
break;
|
|
}
|
|
$basename = str_replace( '.', '-', wp_basename( $file ) ) . '-image' . $ext;
|
|
$uploaded = wp_upload_bits( $basename, '', $metadata['image']['data'] );
|
|
if ( false === $uploaded['error'] ) {
|
|
$image_attachment = array(
|
|
'post_mime_type' => $metadata['image']['mime'],
|
|
'post_type' => 'attachment',
|
|
'post_content' => '',
|
|
);
|
|
/**
|
|
* Filters the parameters for the attachment thumbnail creation.
|
|
*
|
|
* @since 3.9.0
|
|
*
|
|
* @param array $image_attachment An array of parameters to create the thumbnail.
|
|
* @param array $metadata Current attachment metadata.
|
|
* @param array $uploaded {
|
|
* Information about the newly-uploaded file.
|
|
*
|
|
* @type string $file Filename of the newly-uploaded file.
|
|
* @type string $url URL of the uploaded file.
|
|
* @type string $type File type.
|
|
* }
|
|
*/
|
|
$image_attachment = apply_filters( 'attachment_thumbnail_args', $image_attachment, $metadata, $uploaded );
|
|
|
|
$sub_attachment_id = wp_insert_attachment( $image_attachment, $uploaded['file'] );
|
|
add_post_meta( $sub_attachment_id, '_cover_hash', $hash );
|
|
$attach_data = wp_generate_attachment_metadata( $sub_attachment_id, $uploaded['file'] );
|
|
wp_update_attachment_metadata( $sub_attachment_id, $attach_data );
|
|
update_post_meta( $attachment_id, '_thumbnail_id', $sub_attachment_id );
|
|
}
|
|
}
|
|
} elseif ( 'application/pdf' === $mime_type ) {
|
|
// Try to create image thumbnails for PDFs.
|
|
|
|
$fallback_sizes = array(
|
|
'thumbnail',
|
|
'medium',
|
|
'large',
|
|
);
|
|
|
|
/**
|
|
* Filters the image sizes generated for non-image mime types.
|
|
*
|
|
* @since 4.7.0
|
|
*
|
|
* @param string[] $fallback_sizes An array of image size names.
|
|
* @param array $metadata Current attachment metadata.
|
|
*/
|
|
$fallback_sizes = apply_filters( 'fallback_intermediate_image_sizes', $fallback_sizes, $metadata );
|
|
|
|
$registered_sizes = wp_get_registered_image_subsizes();
|
|
$merged_sizes = array_intersect_key( $registered_sizes, array_flip( $fallback_sizes ) );
|
|
|
|
// Force thumbnails to be soft crops.
|
|
if ( isset( $merged_sizes['thumbnail'] ) && is_array( $merged_sizes['thumbnail'] ) ) {
|
|
$merged_sizes['thumbnail']['crop'] = false;
|
|
}
|
|
|
|
// Only load PDFs in an image editor if we're processing sizes.
|
|
if ( ! empty( $merged_sizes ) ) {
|
|
$editor = wp_get_image_editor( $file );
|
|
|
|
if ( ! is_wp_error( $editor ) ) { // No support for this type of file.
|
|
/*
|
|
* PDFs may have the same file filename as JPEGs.
|
|
* Ensure the PDF preview image does not overwrite any JPEG images that already exist.
|
|
*/
|
|
$dirname = dirname( $file ) . '/';
|
|
$ext = '.' . pathinfo( $file, PATHINFO_EXTENSION );
|
|
$preview_file = $dirname . wp_unique_filename( $dirname, wp_basename( $file, $ext ) . '-pdf.jpg' );
|
|
|
|
$uploaded = $editor->save( $preview_file, 'image/jpeg' );
|
|
unset( $editor );
|
|
|
|
// Resize based on the full size image, rather than the source.
|
|
if ( ! is_wp_error( $uploaded ) ) {
|
|
$image_file = $uploaded['path'];
|
|
unset( $uploaded['path'] );
|
|
|
|
$metadata['sizes'] = array(
|
|
'full' => $uploaded,
|
|
);
|
|
|
|
// Save the meta data before any image post-processing errors could happen.
|
|
wp_update_attachment_metadata( $attachment_id, $metadata );
|
|
|
|
// Create sub-sizes saving the image meta after each.
|
|
$metadata = _wp_make_subsizes( $merged_sizes, $image_file, $metadata, $attachment_id, '' );
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
// Remove the blob of binary data from the array.
|
|
unset( $metadata['image']['data'] );
|
|
|
|
// Capture file size for cases where it has not been captured yet, such as PDFs.
|
|
if ( ! isset( $metadata['filesize'] ) && file_exists( $file ) ) {
|
|
$metadata['filesize'] = wp_filesize( $file );
|
|
}
|
|
|
|
/**
|
|
* Filters the generated attachment meta data.
|
|
*
|
|
* @since 2.1.0
|
|
* @since 5.3.0 The `$context` parameter was added.
|
|
*
|
|
* @param array $metadata An array of attachment meta data.
|
|
* @param int $attachment_id Current attachment ID.
|
|
* @param string $context Additional context. Can be 'create' when metadata was initially created for new attachment
|
|
* or 'update' when the metadata was updated.
|
|
*/
|
|
return apply_filters( 'wp_generate_attachment_metadata', $metadata, $attachment_id, 'create' );
|
|
}
|
|
|
|
/**
|
|
* Convert a fraction string to a decimal.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param string $str Fraction string.
|
|
* @return int|float Returns calculated fraction or integer 0 on invalid input.
|
|
*/
|
|
function wp_exif_frac2dec( $str ) {
|
|
if ( ! is_scalar( $str ) || is_bool( $str ) ) {
|
|
return 0;
|
|
}
|
|
|
|
if ( ! is_string( $str ) ) {
|
|
return $str; // This can only be an integer or float, so this is fine.
|
|
}
|
|
|
|
// Fractions passed as a string must contain a single `/`.
|
|
if ( substr_count( $str, '/' ) !== 1 ) {
|
|
if ( is_numeric( $str ) ) {
|
|
return (float) $str;
|
|
}
|
|
|
|
return 0;
|
|
}
|
|
|
|
list( $numerator, $denominator ) = explode( '/', $str );
|
|
|
|
// Both the numerator and the denominator must be numbers.
|
|
if ( ! is_numeric( $numerator ) || ! is_numeric( $denominator ) ) {
|
|
return 0;
|
|
}
|
|
|
|
// The denominator must not be zero.
|
|
if ( 0 == $denominator ) { // phpcs:ignore WordPress.PHP.StrictComparisons.LooseComparison -- Deliberate loose comparison.
|
|
return 0;
|
|
}
|
|
|
|
return $numerator / $denominator;
|
|
}
|
|
|
|
/**
|
|
* Convert the exif date format to a unix timestamp.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param string $str A date string expected to be in Exif format (Y:m:d H:i:s).
|
|
* @return int|false The unix timestamp, or false on failure.
|
|
*/
|
|
function wp_exif_date2ts( $str ) {
|
|
list( $date, $time ) = explode( ' ', trim( $str ) );
|
|
list( $y, $m, $d ) = explode( ':', $date );
|
|
|
|
return strtotime( "{$y}-{$m}-{$d} {$time}" );
|
|
}
|
|
|
|
/**
|
|
* Get extended image metadata, exif or iptc as available.
|
|
*
|
|
* Retrieves the EXIF metadata aperture, credit, camera, caption, copyright, iso
|
|
* created_timestamp, focal_length, shutter_speed, and title.
|
|
*
|
|
* The IPTC metadata that is retrieved is APP13, credit, byline, created date
|
|
* and time, caption, copyright, and title. Also includes FNumber, Model,
|
|
* DateTimeDigitized, FocalLength, ISOSpeedRatings, and ExposureTime.
|
|
*
|
|
* @todo Try other exif libraries if available.
|
|
* @since 2.5.0
|
|
*
|
|
* @param string $file
|
|
* @return array|false Image metadata array on success, false on failure.
|
|
*/
|
|
function wp_read_image_metadata( $file ) {
|
|
if ( ! file_exists( $file ) ) {
|
|
return false;
|
|
}
|
|
|
|
list( , , $image_type ) = wp_getimagesize( $file );
|
|
|
|
/*
|
|
* EXIF contains a bunch of data we'll probably never need formatted in ways
|
|
* that are difficult to use. We'll normalize it and just extract the fields
|
|
* that are likely to be useful. Fractions and numbers are converted to
|
|
* floats, dates to unix timestamps, and everything else to strings.
|
|
*/
|
|
$meta = array(
|
|
'aperture' => 0,
|
|
'credit' => '',
|
|
'camera' => '',
|
|
'caption' => '',
|
|
'created_timestamp' => 0,
|
|
'copyright' => '',
|
|
'focal_length' => 0,
|
|
'iso' => 0,
|
|
'shutter_speed' => 0,
|
|
'title' => '',
|
|
'orientation' => 0,
|
|
'keywords' => array(),
|
|
);
|
|
|
|
$iptc = array();
|
|
$info = array();
|
|
/*
|
|
* Read IPTC first, since it might contain data not available in exif such
|
|
* as caption, description etc.
|
|
*/
|
|
if ( is_callable( 'iptcparse' ) ) {
|
|
wp_getimagesize( $file, $info );
|
|
|
|
if ( ! empty( $info['APP13'] ) ) {
|
|
// Don't silence errors when in debug mode, unless running unit tests.
|
|
if ( defined( 'WP_DEBUG' ) && WP_DEBUG
|
|
&& ! defined( 'WP_RUN_CORE_TESTS' )
|
|
) {
|
|
$iptc = iptcparse( $info['APP13'] );
|
|
} else {
|
|
// phpcs:ignore WordPress.PHP.NoSilencedErrors -- Silencing notice and warning is intentional. See https://core.trac.wordpress.org/ticket/42480
|
|
$iptc = @iptcparse( $info['APP13'] );
|
|
}
|
|
|
|
if ( ! is_array( $iptc ) ) {
|
|
$iptc = array();
|
|
}
|
|
|
|
// Headline, "A brief synopsis of the caption".
|
|
if ( ! empty( $iptc['2#105'][0] ) ) {
|
|
$meta['title'] = trim( $iptc['2#105'][0] );
|
|
/*
|
|
* Title, "Many use the Title field to store the filename of the image,
|
|
* though the field may be used in many ways".
|
|
*/
|
|
} elseif ( ! empty( $iptc['2#005'][0] ) ) {
|
|
$meta['title'] = trim( $iptc['2#005'][0] );
|
|
}
|
|
|
|
if ( ! empty( $iptc['2#120'][0] ) ) { // Description / legacy caption.
|
|
$caption = trim( $iptc['2#120'][0] );
|
|
|
|
mbstring_binary_safe_encoding();
|
|
$caption_length = strlen( $caption );
|
|
reset_mbstring_encoding();
|
|
|
|
if ( empty( $meta['title'] ) && $caption_length < 80 ) {
|
|
// Assume the title is stored in 2:120 if it's short.
|
|
$meta['title'] = $caption;
|
|
}
|
|
|
|
$meta['caption'] = $caption;
|
|
}
|
|
|
|
if ( ! empty( $iptc['2#110'][0] ) ) { // Credit.
|
|
$meta['credit'] = trim( $iptc['2#110'][0] );
|
|
} elseif ( ! empty( $iptc['2#080'][0] ) ) { // Creator / legacy byline.
|
|
$meta['credit'] = trim( $iptc['2#080'][0] );
|
|
}
|
|
|
|
if ( ! empty( $iptc['2#055'][0] ) && ! empty( $iptc['2#060'][0] ) ) { // Created date and time.
|
|
$meta['created_timestamp'] = strtotime( $iptc['2#055'][0] . ' ' . $iptc['2#060'][0] );
|
|
}
|
|
|
|
if ( ! empty( $iptc['2#116'][0] ) ) { // Copyright.
|
|
$meta['copyright'] = trim( $iptc['2#116'][0] );
|
|
}
|
|
|
|
if ( ! empty( $iptc['2#025'][0] ) ) { // Keywords array.
|
|
$meta['keywords'] = array_values( $iptc['2#025'] );
|
|
}
|
|
}
|
|
}
|
|
|
|
$exif = array();
|
|
|
|
/**
|
|
* Filters the image types to check for exif data.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param int[] $image_types Array of image types to check for exif data. Each value
|
|
* is usually one of the `IMAGETYPE_*` constants.
|
|
*/
|
|
$exif_image_types = apply_filters( 'wp_read_image_metadata_types', array( IMAGETYPE_JPEG, IMAGETYPE_TIFF_II, IMAGETYPE_TIFF_MM ) );
|
|
|
|
if ( is_callable( 'exif_read_data' ) && in_array( $image_type, $exif_image_types, true ) ) {
|
|
// Don't silence errors when in debug mode, unless running unit tests.
|
|
if ( defined( 'WP_DEBUG' ) && WP_DEBUG
|
|
&& ! defined( 'WP_RUN_CORE_TESTS' )
|
|
) {
|
|
$exif = exif_read_data( $file );
|
|
} else {
|
|
// phpcs:ignore WordPress.PHP.NoSilencedErrors -- Silencing notice and warning is intentional. See https://core.trac.wordpress.org/ticket/42480
|
|
$exif = @exif_read_data( $file );
|
|
}
|
|
|
|
if ( ! is_array( $exif ) ) {
|
|
$exif = array();
|
|
}
|
|
|
|
if ( ! empty( $exif['ImageDescription'] ) ) {
|
|
mbstring_binary_safe_encoding();
|
|
$description_length = strlen( $exif['ImageDescription'] );
|
|
reset_mbstring_encoding();
|
|
|
|
if ( empty( $meta['title'] ) && $description_length < 80 ) {
|
|
// Assume the title is stored in ImageDescription.
|
|
$meta['title'] = trim( $exif['ImageDescription'] );
|
|
}
|
|
|
|
if ( empty( $meta['caption'] ) && ! empty( $exif['COMPUTED']['UserComment'] ) ) {
|
|
$meta['caption'] = trim( $exif['COMPUTED']['UserComment'] );
|
|
}
|
|
|
|
if ( empty( $meta['caption'] ) ) {
|
|
$meta['caption'] = trim( $exif['ImageDescription'] );
|
|
}
|
|
} elseif ( empty( $meta['caption'] ) && ! empty( $exif['Comments'] ) ) {
|
|
$meta['caption'] = trim( $exif['Comments'] );
|
|
}
|
|
|
|
if ( empty( $meta['credit'] ) ) {
|
|
if ( ! empty( $exif['Artist'] ) ) {
|
|
$meta['credit'] = trim( $exif['Artist'] );
|
|
} elseif ( ! empty( $exif['Author'] ) ) {
|
|
$meta['credit'] = trim( $exif['Author'] );
|
|
}
|
|
}
|
|
|
|
if ( empty( $meta['copyright'] ) && ! empty( $exif['Copyright'] ) ) {
|
|
$meta['copyright'] = trim( $exif['Copyright'] );
|
|
}
|
|
if ( ! empty( $exif['FNumber'] ) && is_scalar( $exif['FNumber'] ) ) {
|
|
$meta['aperture'] = round( wp_exif_frac2dec( $exif['FNumber'] ), 2 );
|
|
}
|
|
if ( ! empty( $exif['Model'] ) ) {
|
|
$meta['camera'] = trim( $exif['Model'] );
|
|
}
|
|
if ( empty( $meta['created_timestamp'] ) && ! empty( $exif['DateTimeDigitized'] ) ) {
|
|
$meta['created_timestamp'] = wp_exif_date2ts( $exif['DateTimeDigitized'] );
|
|
}
|
|
if ( ! empty( $exif['FocalLength'] ) ) {
|
|
$meta['focal_length'] = (string) $exif['FocalLength'];
|
|
if ( is_scalar( $exif['FocalLength'] ) ) {
|
|
$meta['focal_length'] = (string) wp_exif_frac2dec( $exif['FocalLength'] );
|
|
}
|
|
}
|
|
if ( ! empty( $exif['ISOSpeedRatings'] ) ) {
|
|
$meta['iso'] = is_array( $exif['ISOSpeedRatings'] ) ? reset( $exif['ISOSpeedRatings'] ) : $exif['ISOSpeedRatings'];
|
|
$meta['iso'] = trim( $meta['iso'] );
|
|
}
|
|
if ( ! empty( $exif['ExposureTime'] ) ) {
|
|
$meta['shutter_speed'] = (string) $exif['ExposureTime'];
|
|
if ( is_scalar( $exif['ExposureTime'] ) ) {
|
|
$meta['shutter_speed'] = (string) wp_exif_frac2dec( $exif['ExposureTime'] );
|
|
}
|
|
}
|
|
if ( ! empty( $exif['Orientation'] ) ) {
|
|
$meta['orientation'] = $exif['Orientation'];
|
|
}
|
|
}
|
|
|
|
foreach ( array( 'title', 'caption', 'credit', 'copyright', 'camera', 'iso' ) as $key ) {
|
|
if ( $meta[ $key ] && ! seems_utf8( $meta[ $key ] ) ) {
|
|
$meta[ $key ] = utf8_encode( $meta[ $key ] );
|
|
}
|
|
}
|
|
|
|
foreach ( $meta['keywords'] as $key => $keyword ) {
|
|
if ( ! seems_utf8( $keyword ) ) {
|
|
$meta['keywords'][ $key ] = utf8_encode( $keyword );
|
|
}
|
|
}
|
|
|
|
$meta = wp_kses_post_deep( $meta );
|
|
|
|
/**
|
|
* Filters the array of meta data read from an image's exif data.
|
|
*
|
|
* @since 2.5.0
|
|
* @since 4.4.0 The `$iptc` parameter was added.
|
|
* @since 5.0.0 The `$exif` parameter was added.
|
|
*
|
|
* @param array $meta Image meta data.
|
|
* @param string $file Path to image file.
|
|
* @param int $image_type Type of image, one of the `IMAGETYPE_XXX` constants.
|
|
* @param array $iptc IPTC data.
|
|
* @param array $exif EXIF data.
|
|
*/
|
|
return apply_filters( 'wp_read_image_metadata', $meta, $file, $image_type, $iptc, $exif );
|
|
|
|
}
|
|
|
|
/**
|
|
* Validate that file is an image.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param string $path File path to test if valid image.
|
|
* @return bool True if valid image, false if not valid image.
|
|
*/
|
|
function file_is_valid_image( $path ) {
|
|
$size = wp_getimagesize( $path );
|
|
return ! empty( $size );
|
|
}
|
|
|
|
/**
|
|
* Validate that file is suitable for displaying within a web page.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param string $path File path to test.
|
|
* @return bool True if suitable, false if not suitable.
|
|
*/
|
|
function file_is_displayable_image( $path ) {
|
|
$displayable_image_types = array( IMAGETYPE_GIF, IMAGETYPE_JPEG, IMAGETYPE_PNG, IMAGETYPE_BMP, IMAGETYPE_ICO, IMAGETYPE_WEBP );
|
|
|
|
$info = wp_getimagesize( $path );
|
|
if ( empty( $info ) ) {
|
|
$result = false;
|
|
} elseif ( ! in_array( $info[2], $displayable_image_types, true ) ) {
|
|
$result = false;
|
|
} else {
|
|
$result = true;
|
|
}
|
|
|
|
/**
|
|
* Filters whether the current image is displayable in the browser.
|
|
*
|
|
* @since 2.5.0
|
|
*
|
|
* @param bool $result Whether the image can be displayed. Default true.
|
|
* @param string $path Path to the image.
|
|
*/
|
|
return apply_filters( 'file_is_displayable_image', $result, $path );
|
|
}
|
|
|
|
/**
|
|
* Load an image resource for editing.
|
|
*
|
|
* @since 2.9.0
|
|
*
|
|
* @param int $attachment_id Attachment ID.
|
|
* @param string $mime_type Image mime type.
|
|
* @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array
|
|
* of width and height values in pixels (in that order). Default 'full'.
|
|
* @return resource|GdImage|false The resulting image resource or GdImage instance on success,
|
|
* false on failure.
|
|
*/
|
|
function load_image_to_edit( $attachment_id, $mime_type, $size = 'full' ) {
|
|
$filepath = _load_image_to_edit_path( $attachment_id, $size );
|
|
if ( empty( $filepath ) ) {
|
|
return false;
|
|
}
|
|
|
|
switch ( $mime_type ) {
|
|
case 'image/jpeg':
|
|
$image = imagecreatefromjpeg( $filepath );
|
|
break;
|
|
case 'image/png':
|
|
$image = imagecreatefrompng( $filepath );
|
|
break;
|
|
case 'image/gif':
|
|
$image = imagecreatefromgif( $filepath );
|
|
break;
|
|
case 'image/webp':
|
|
$image = false;
|
|
if ( function_exists( 'imagecreatefromwebp' ) ) {
|
|
$image = imagecreatefromwebp( $filepath );
|
|
}
|
|
break;
|
|
default:
|
|
$image = false;
|
|
break;
|
|
}
|
|
|
|
if ( is_gd_image( $image ) ) {
|
|
/**
|
|
* Filters the current image being loaded for editing.
|
|
*
|
|
* @since 2.9.0
|
|
*
|
|
* @param resource|GdImage $image Current image.
|
|
* @param int $attachment_id Attachment ID.
|
|
* @param string|int[] $size Requested image size. Can be any registered image size name, or
|
|
* an array of width and height values in pixels (in that order).
|
|
*/
|
|
$image = apply_filters( 'load_image_to_edit', $image, $attachment_id, $size );
|
|
|
|
if ( function_exists( 'imagealphablending' ) && function_exists( 'imagesavealpha' ) ) {
|
|
imagealphablending( $image, false );
|
|
imagesavealpha( $image, true );
|
|
}
|
|
}
|
|
|
|
return $image;
|
|
}
|
|
|
|
/**
|
|
* Retrieve the path or URL of an attachment's attached file.
|
|
*
|
|
* If the attached file is not present on the local filesystem (usually due to replication plugins),
|
|
* then the URL of the file is returned if `allow_url_fopen` is supported.
|
|
*
|
|
* @since 3.4.0
|
|
* @access private
|
|
*
|
|
* @param int $attachment_id Attachment ID.
|
|
* @param string|int[] $size Optional. Image size. Accepts any registered image size name, or an array
|
|
* of width and height values in pixels (in that order). Default 'full'.
|
|
* @return string|false File path or URL on success, false on failure.
|
|
*/
|
|
function _load_image_to_edit_path( $attachment_id, $size = 'full' ) {
|
|
$filepath = get_attached_file( $attachment_id );
|
|
|
|
if ( $filepath && file_exists( $filepath ) ) {
|
|
if ( 'full' !== $size ) {
|
|
$data = image_get_intermediate_size( $attachment_id, $size );
|
|
|
|
if ( $data ) {
|
|
$filepath = path_join( dirname( $filepath ), $data['file'] );
|
|
|
|
/**
|
|
* Filters the path to an attachment's file when editing the image.
|
|
*
|
|
* The filter is evaluated for all image sizes except 'full'.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string $path Path to the current image.
|
|
* @param int $attachment_id Attachment ID.
|
|
* @param string|int[] $size Requested image size. Can be any registered image size name, or
|
|
* an array of width and height values in pixels (in that order).
|
|
*/
|
|
$filepath = apply_filters( 'load_image_to_edit_filesystempath', $filepath, $attachment_id, $size );
|
|
}
|
|
}
|
|
} elseif ( function_exists( 'fopen' ) && ini_get( 'allow_url_fopen' ) ) {
|
|
/**
|
|
* Filters the path to an attachment's URL when editing the image.
|
|
*
|
|
* The filter is only evaluated if the file isn't stored locally and `allow_url_fopen` is enabled on the server.
|
|
*
|
|
* @since 3.1.0
|
|
*
|
|
* @param string|false $image_url Current image URL.
|
|
* @param int $attachment_id Attachment ID.
|
|
* @param string|int[] $size Requested image size. Can be any registered image size name, or
|
|
* an array of width and height values in pixels (in that order).
|
|
*/
|
|
$filepath = apply_filters( 'load_image_to_edit_attachmenturl', wp_get_attachment_url( $attachment_id ), $attachment_id, $size );
|
|
}
|
|
|
|
/**
|
|
* Filters the returned path or URL of the current image.
|
|
*
|
|
* @since 2.9.0
|
|
*
|
|
* @param string|false $filepath File path or URL to current image, or false.
|
|
* @param int $attachment_id Attachment ID.
|
|
* @param string|int[] $size Requested image size. Can be any registered image size name, or
|
|
* an array of width and height values in pixels (in that order).
|
|
*/
|
|
return apply_filters( 'load_image_to_edit_path', $filepath, $attachment_id, $size );
|
|
}
|
|
|
|
/**
|
|
* Copy an existing image file.
|
|
*
|
|
* @since 3.4.0
|
|
* @access private
|
|
*
|
|
* @param int $attachment_id Attachment ID.
|
|
* @return string|false New file path on success, false on failure.
|
|
*/
|
|
function _copy_image_file( $attachment_id ) {
|
|
$dst_file = get_attached_file( $attachment_id );
|
|
$src_file = $dst_file;
|
|
|
|
if ( ! file_exists( $src_file ) ) {
|
|
$src_file = _load_image_to_edit_path( $attachment_id );
|
|
}
|
|
|
|
if ( $src_file ) {
|
|
$dst_file = str_replace( wp_basename( $dst_file ), 'copy-' . wp_basename( $dst_file ), $dst_file );
|
|
$dst_file = dirname( $dst_file ) . '/' . wp_unique_filename( dirname( $dst_file ), wp_basename( $dst_file ) );
|
|
|
|
/*
|
|
* The directory containing the original file may no longer
|
|
* exist when using a replication plugin.
|
|
*/
|
|
wp_mkdir_p( dirname( $dst_file ) );
|
|
|
|
if ( ! copy( $src_file, $dst_file ) ) {
|
|
$dst_file = false;
|
|
}
|
|
} else {
|
|
$dst_file = false;
|
|
}
|
|
|
|
return $dst_file;
|
|
}
|
|
|
|
/**
|
|
* Returns an array with the list of valid mime types that a specific mime type should be converted into.
|
|
* For example an `image/jpeg` should be converted into an `image/jpeg` and `image/webp`. The first type
|
|
* is considered the primary output type for this image.
|
|
*
|
|
* Called for each uploaded image to determine the list of mime types that should be converted into. Then,
|
|
* called again for each image size as they are generated to check if the image should be converted into the mime type
|
|
* for that size.
|
|
*
|
|
* @since 6.1.0
|
|
*
|
|
* @param int $attachment_id The attachment ID.
|
|
* @return array An array of valid mime types, where the key is the source file mime type and the list of mime types to
|
|
* generate.
|
|
*/
|
|
function wp_upload_image_mime_transforms( $attachment_id ) {
|
|
$default_image_mime_transforms = array(
|
|
'image/jpeg' => array( 'image/jpeg', 'image/webp' ),
|
|
'image/webp' => array( 'image/webp', 'image/jpeg' ),
|
|
);
|
|
$image_mime_transforms = $default_image_mime_transforms;
|
|
|
|
/**
|
|
* Filter the output mime types for a given input mime type and image size.
|
|
*
|
|
* @since 6.1.0
|
|
*
|
|
* @param array $image_mime_transforms A map with the valid mime transforms where the key is the source file mime type
|
|
* and the value is one or more mime file types to generate.
|
|
* @param int $attachment_id The ID of the attachment where the hook was dispatched.
|
|
*/
|
|
$image_mime_transforms = apply_filters( 'wp_upload_image_mime_transforms', $image_mime_transforms, $attachment_id );
|
|
|
|
if ( ! is_array( $image_mime_transforms ) ) {
|
|
return $default_image_mime_transforms;
|
|
}
|
|
|
|
return array_map(
|
|
function( $transforms_list ) {
|
|
return (array) $transforms_list;
|
|
},
|
|
$image_mime_transforms
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Extract the primary and additional mime output types for an image from the $image_mime_transforms.
|
|
*
|
|
* @since 6.1.0
|
|
* @access private
|
|
*
|
|
* @param string $file Full path to the image file.
|
|
* @param int $attachment_id Attachment ID to process.
|
|
* @return array An array with two entries, the primary mime type and the list of additional mime types.
|
|
*/
|
|
function _wp_get_primary_and_additional_mime_types( $file, $attachment_id ) {
|
|
$image_mime_transforms = wp_upload_image_mime_transforms( $attachment_id );
|
|
$original_mime_type = wp_get_image_mime( $file );
|
|
$output_mime_types = isset( $image_mime_transforms[ $original_mime_type ] ) ? $image_mime_transforms[ $original_mime_type ] : array( $original_mime_type );
|
|
|
|
// Exclude any output mime types that the system doesn't support.
|
|
$output_mime_types = array_values(
|
|
array_filter(
|
|
$output_mime_types,
|
|
function( $mime_type ) {
|
|
return wp_image_editor_supports(
|
|
array(
|
|
'mime_type' => $mime_type,
|
|
)
|
|
);
|
|
}
|
|
)
|
|
);
|
|
|
|
// Handle an empty value for $output_mime_types: only output the original type.
|
|
if ( empty( $output_mime_types ) ) {
|
|
return array( $original_mime_type, array() );
|
|
}
|
|
|
|
// Use original mime type as primary mime type, or alternatively the first one.
|
|
$primary_mime_type_key = array_search( $original_mime_type, $output_mime_types, true );
|
|
if ( false === $primary_mime_type_key ) {
|
|
$primary_mime_type_key = 0;
|
|
}
|
|
// Split output mime types into primary mime type and additional mime types.
|
|
$additional_mime_types = $output_mime_types;
|
|
list( $primary_mime_type ) = array_splice( $additional_mime_types, $primary_mime_type_key, 1 );
|
|
|
|
return array(
|
|
$primary_mime_type,
|
|
$additional_mime_types,
|
|
);
|
|
}
|