Warning: Trying to access array offset on false in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 216
set_post_thumbnail_size() - 为文章缩略图注册图片尺寸 - WordPress函数 - WordPress动力
当前浏览:首页 / WordPress函数 / set_post_thumbnail_size()

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

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


Warning: Undefined array key -1 in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/reference-cat.php on line 185

Warning: Undefined array key 4 in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/reference-cat.php on line 186

Warning: Undefined variable $searchand in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 154

Warning: Undefined array key "c662a3ca6b84e8f01cc3765430bbe052" in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 223

Warning: Undefined variable $searchand in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 154

Warning: Undefined array key "6f1a738255000cf2c8ba3882fd6e44da" in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 223

Warning: Undefined variable $searchand in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 154

Warning: Undefined array key "30ef97a520af4e616e53f400dd72bca4" in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 223

Warning: Undefined variable $searchand in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 154

Warning: Undefined array key "c7c70abb875e21877711d9b15410919e" in /www/wwwroot/www.wpdongli.com/wp-content/themes/WPdongli/functions/wp.php on line 223

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”插件。