apply_filters( 'image_sideload_extensions', string[] $allowed_extensions, string $file )
- Since
- 5.6.0, 5.8.0
Filters the list of allowed file extensions when sideloading an image from a URL.
Description
The default allowed extensions are:
jpgjpegjpepnggifwebp
Compatibility
- WordPress
- since 5.8.0
- 6.7.7
- 6.8.8
- 6.9.7
- 7.0.4
- 7.1.0
Present in every tracked release (6.7.7 to 7.1.0).
Parameters
$allowed_extensionsstring[]- Array of allowed file extensions.
$filestring- The URL of the image to download.
Where this hook fires · 1
wp-admin/includes/media.php:1038media_sideload_image()
Source code
* @since 5.6.0 * @since 5.8.0 Added 'webp' to the default list of allowed file extensions. * * @param string[] $allowed_extensions Array of allowed file extensions. * @param string $file The URL of the image to download. */ $allowed_extensions = apply_filters( 'image_sideload_extensions', $allowed_extensions, $file ); $allowed_extensions = array_map( 'preg_quote', $allowed_extensions ); // Set variables for storage, fix file filename for query strings. preg_match( '/[^\?]+\.(' . implode( '|', $allowed_extensions ) . ')\b/i', $file, $matches ); if ( ! $matches ) {Changelog
Introduced in 5.6.0. Unchanged from 6.7.7 through 7.1.0.
Signature, return type and hooks compared across 5 parsed releases.
5.8.0
Added 'webp' to the default list of allowed file extensions.from the docblock
5.6.0
Introduced.from the docblock
About this page
- Parsed data
- Generated from the wordpress-develop 6.7.7 tag, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.
- Corrections
- Something wrong on this page? Report it and it gets fixed in the next regeneration.