当前浏览:首页 / WordPress钩子 / image_size_names_choose

apply_filters( 'image_size_names_choose', string[] $size_names )

过滤默认图片尺寸的名称和标签(label)

imagemore...

name

size


参数

$size_names

(string[]) 图像尺寸标签的数组,以其名称为键。默认值包括'Thumbnail'、'Medium'、'Large'和'Full Size'。


更多信息

image_size_names_choose”过滤器允许修改WordPress后端管理媒体库中可用的图像尺寸列表。

这最常用于使custom image sizes在WordPress管理中可供选择。



源码

查看源码 官方文档


更新日志

版本描述
3.3.0开始引入

使用示例

  • 示例1

    将新图像尺寸添加到媒体库

    // Add images sizes.
    function custom_theme_setup() {
    	add_image_size( 'custom-size-1', 1200, 300, true );
    	add_image_size( 'custom-size-2', 1000, 333, true );
    }
    add_action( 'after_setup_theme', 'custom_theme_setup' );
    
    // Make custom sizes selectable from WordPress admin.
    function custom_image_sizes( $size_names ) {
    	$new_sizes = array(
    		'custom-size-1' => __( 'Custom Size #1', 'generatewp.com' ),
    		'custom-size-2' => __( 'Custom Size #2', 'generatewp.com' ),
    	);
    	return array_merge( $size_names, $new_sizes );
    }
    add_filter( 'image_size_names_choose', 'custom_image_sizes' );
    
  • 示例2

    从Codex迁移的示例:

    下面将向媒体库中的可选尺寸列表中添加一个新的图片尺寸选项。

    add_filter( 'image_size_names_choose', 'my_custom_sizes' );
    
    function my_custom_sizes( $sizes ) {
        return array_merge( $sizes, array(
            'your-custom-size' => __('Your Custom Size Name'),
        ) );
    }