当前浏览:首页 / WordPress函数 / set_post_thumbnail_size()

set_post_thumbnail_size( int $width, int $height, bool|array $crop = false )

为文章缩略图注册图片尺寸

postmore...

setmore...

size

thumbnail 缩略图


描述

另见


参数

$width

(int) (必填) 图像宽度(像素)

$height

(int) (必填) 图像高度(像素)

$crop

(bool|array) (可选) 是将图像裁剪到指定的宽度和高度还是调整大小。可以指定裁剪区域位置的数组。

默认值: false


说明

  • 要为特色图片注册额外的图片尺寸,请使用:add_image_size()
  • 要启用特色图像,在当前主题的 functions.php 文件 中添加 add_theme_support( 'post-thumbnails' );,另见 文章缩略图
  • 这个函数不会调整你现有的特色图片的尺寸,要以新的尺寸重新生成现有图像,请使用 Regenerate Thumbnails 插件


源码

查看源码 官方文档


更新日志

版本描述
2.9.0开始引入

使用示例

  • 示例1

    在当前主题的functions.php文件中使用的默认用法。

    function wpdocs_setup_theme() {
    	add_theme_support( 'post-thumbnails' );
    	set_post_thumbnail_size( 150, 150 );
    }
    add_action( 'after_setup_theme', 'wpdocs_setup_theme' );
    
  • 示例2

    裁剪模式
    通过按比例调整图像大小(即不扭曲图像)来设置默认的文章缩略图尺寸:

    set_post_thumbnail_size( 50, 50 ); // 50 pixels wide by 50 pixels tall, resize mode
    

    通过裁剪图像(从侧面或从顶部和底部)来设置默认的文章缩略图尺寸:

    set_post_thumbnail_size( 50, 50, true ); // 50 pixels wide by 50 pixels tall, crop mode
    

    通过从左上角裁剪图像来设置默认的文章缩略图尺寸:

    set_post_thumbnail_size( 50, 50, array( 'top', 'left')  ); // 50 pixels wide by 50 pixels tall, crop from the top left corner
    

    通过从中心裁剪图像来设置默认的我缩略图尺寸:

    set_post_thumbnail_size( 50, 50, array( 'center', 'center')  ); // 50 pixels wide by 50 pixels tall, crop from the center
    

    注意:此功能不会调整现有特色图像的尺寸。要以新大小重新生成现有图像,请使用“Regenerate Thumbnails”插件。