image_size_names_choose
Filters the names and labels of the default image sizes.
Usage
add_filter( 'image_size_names_choose', 'wp_kama_image_size_names_choose_filter' ); /** * Function for `image_size_names_choose` filter-hook. * * @param string[] $size_names Array of image size labels keyed by their name. * * @return string[] */ function wp_kama_image_size_names_choose_filter( $size_names ){ // filter... return $size_names; }
- $size_names(string[])
- Array of image size labels keyed by their name.
Default: values include 'Thumbnail', 'Medium', 'Large', and 'Full Size'
Changelog
Since 3.3.0 | Introduced. |
Where the hook is called
image_size_names_choose
image_size_names_choose
image_size_names_choose
image_size_names_choose
wp-admin/includes/media.php 1200-1208
$size_names = apply_filters( 'image_size_names_choose', array( 'thumbnail' => __( 'Thumbnail' ), 'medium' => __( 'Medium' ), 'large' => __( 'Large' ), 'full' => __( 'Full Size' ), ) );
wp-includes/block-editor.php 168-176
$image_size_names = apply_filters( 'image_size_names_choose', array( 'thumbnail' => __( 'Thumbnail' ), 'medium' => __( 'Medium' ), 'large' => __( 'Large' ), 'full' => __( 'Full Size' ), ) );
wp-includes/media-template.php 908-916
$sizes = apply_filters( 'image_size_names_choose', array( 'thumbnail' => __( 'Thumbnail' ), 'medium' => __( 'Medium' ), 'large' => __( 'Large' ), 'full' => __( 'Full Size' ), ) );
wp-includes/media-template.php 988-996
$size_names = apply_filters( 'image_size_names_choose', array( 'thumbnail' => __( 'Thumbnail' ), 'medium' => __( 'Medium' ), 'large' => __( 'Large' ), 'full' => __( 'Full Size' ), ) );
wp-includes/media-template.php 1179-1187
$sizes = apply_filters( 'image_size_names_choose', array( 'thumbnail' => __( 'Thumbnail' ), 'medium' => __( 'Medium' ), 'large' => __( 'Large' ), 'full' => __( 'Full Size' ), ) );
wp-includes/media.php 4414-4422
$possible_sizes = apply_filters( 'image_size_names_choose', array( 'thumbnail' => __( 'Thumbnail' ), 'medium' => __( 'Medium' ), 'large' => __( 'Large' ), 'full' => __( 'Full Size' ), ) );
wp-admin/includes/class-custom-background.php 645-653
apply_filters( 'image_size_names_choose', array( 'thumbnail' => __( 'Thumbnail' ), 'medium' => __( 'Medium' ), 'large' => __( 'Large' ), 'full' => __( 'Full Size' ), ) )
Where the hook is used in WordPress
wp-admin/includes/ajax-actions.php 4033
add_filter( 'image_size_names_choose', array( $wp_site_icon, 'additional_sizes' ) );
wp-admin/includes/ajax-actions.php 4049
add_filter( 'image_size_names_choose', array( $wp_site_icon, 'additional_sizes' ) );