WordPress，set_post_thumbnail_size 函数解析

描述 设置特色图像的默认尺寸。给特色图像注册不同的尺寸请使用 add_image_size() 函数。 注意：若启用特色图像，当前主题必须在其 functions.php 文件中包含 add_theme_support( 'post-thumbnails' ); 用法 <?php set_post_thumbna…

描述

设置特色图像的默认尺寸。给特色图像注册不同的尺寸请使用 add_image_size() 函数。

注意：若启用特色图像，当前主题必须在其 functions.php 文件中包含 add_theme_support( 'post-thumbnails' );

用法

<?php set_post_thumbnail_size( $width, $height, $crop ); ?>

参数

$width

(int) (optional) 日志特色图像的宽度。

Default: 0

$height

(int) (optional) 日志特色图像的高度。

Default: 0

$crop

(boolean or array) (optional) 是否裁剪图片，False – 按照比例缩放；True – 按照尺寸裁剪。或者可以是一个数组，表示裁减位置。比如：array(‘top’,’left’)。

Default: false

返回值

无

基本用法

添加至主题文件的 functions.php 文件中：

add_theme_support( 'post-thumbnails' );
set_post_thumbnail_size( 150, 150 );

裁剪模式

按照比例缩放图片来设置特色图像大小，即生成的特色图像不扭曲。

set_post_thumbnail_size( 50, 50 ); // 50 像素宽和 50 像素高，按比例缩放模式。

通过裁剪图片来设置特色图像大小：

set_post_thumbnail_size( 50, 50, true ); // 50 像素宽和 50 像素高，裁剪模式

从左上角裁减图像，以调整特色图像大小：

set_post_thumbnail_size( 50, 50, array( 'top', 'left')  ); // 50 像素宽和 50像素高，从左上角裁减图像

源文件

wp-includes/media.php

相关函数

add_image_size(), get_post_thumbnail_id(), get_the_post_thumbnail(), has_post_thumbnail(), set_post_thumbnail_size(), the_post_thumbnail(),