$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.
+ // 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 {
*
* @since 2.1.0
*
+ * @global array $_wp_additional_image_sizes
+ *
* @param int $attachment_id Attachment Id to process.
* @param string $file Filepath of the Attached image.
* @return mixed Metadata for attachment.
}
/**
- * Filter the image sizes automatically generated when uploading an image.
+ * Filters the image sizes automatically generated when uploading an image.
*
* @since 2.9.0
+ * @since 4.4.0 Added the `$metadata` argument.
*
- * @param array $sizes An associative array of image sizes.
+ * @param array $sizes An associative array of image sizes.
+ * @param array $metadata An associative array of image metadata: width, height, file.
*/
- $sizes = apply_filters( 'intermediate_image_sizes_advanced', $sizes );
+ $sizes = apply_filters( 'intermediate_image_sizes_advanced', $sizes, $metadata );
if ( $sizes ) {
$editor = wp_get_image_editor( $file );
'post_content' => '',
);
/**
- * Filter the parameters for the attachment thumbnail creation.
+ * Filters the parameters for the attachment thumbnail creation.
*
* @since 3.9.0
*
}
// Remove the blob of binary data from the array.
- if ( isset( $metadata['image']['data'] ) )
+ if ( $metadata ) {
unset( $metadata['image']['data'] );
+ }
/**
- * Filter the generated attachment meta data.
+ * Filters the generated attachment meta data.
*
* @since 2.1.0
*
'shutter_speed' => 0,
'title' => '',
'orientation' => 0,
+ 'keywords' => array(),
);
+ $iptc = array();
/*
* Read IPTC first, since it might contain data not available in exif such
* as caption, description etc.
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'] );
+ }
}
}
/**
- * Filter the image types to check for exif data.
+ * Filters the image types to check for exif data.
*
* @since 2.5.0
*
}
}
- foreach ( $meta as &$value ) {
- if ( is_string( $value ) ) {
- $value = wp_kses_post( $value );
+ foreach ( $meta['keywords'] as $key => $keyword ) {
+ if ( ! seems_utf8( $keyword ) ) {
+ $meta['keywords'][ $key ] = utf8_encode( $keyword );
}
}
+ $meta = wp_kses_post_deep( $meta );
+
/**
- * Filter the array of meta data read from an image's exif data.
+ * 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.
*
* @param array $meta Image meta data.
* @param string $file Path to image file.
* @param int $sourceImageType Type of image.
+ * @param array $iptc IPTC data.
*/
- return apply_filters( 'wp_read_image_metadata', $meta, $file, $sourceImageType );
+ return apply_filters( 'wp_read_image_metadata', $meta, $file, $sourceImageType, $iptc );
}
}
/**
- * Filter whether the current image is displayable in the browser.
+ * Filters whether the current image is displayable in the browser.
*
* @since 2.5.0
*
}
if ( is_resource($image) ) {
/**
- * Filter the current image being loaded for editing.
+ * Filters the current image being loaded for editing.
*
* @since 2.9.0
*
if ( $filepath && file_exists( $filepath ) ) {
if ( 'full' != $size && ( $data = image_get_intermediate_size( $attachment_id, $size ) ) ) {
/**
- * Filter the path to the current image.
+ * Filters the path to the current image.
*
* The filter is evaluated for all image sizes except 'full'.
*
}
} elseif ( function_exists( 'fopen' ) && function_exists( 'ini_get' ) && true == ini_get( 'allow_url_fopen' ) ) {
/**
- * Filter the image URL if not in the local filesystem.
+ * Filters the image URL if not in the local filesystem.
*
* The filter is only evaluated if fopen is enabled on the server.
*
}
/**
- * Filter the returned path or URL of the current image.
+ * Filters the returned path or URL of the current image.
*
* @since 2.9.0
*