WordPress 日志缩略图(Post Thumbnail)详细介绍和使用

很多 WordPress 主题,特别是那些杂志型的主题,会给每篇日志加上一张缩略图,这种展现方式一般用在首页,可能单独出现,或者和日志摘要一起。但是目前位置没有一个标准的方法去实现日志缩略图,很多主题是使用 WordPress 自定义字段来实现日志缩略图功能,这样的设置比较复杂,虽然我在制作的很多 WordPress 项目中都是用这个方法,并且设置了直接上传缩略图的方法,但是还是略显麻烦。

从 WordPress 2.9 开始,WordPress 开始内置了日志缩略图的功能,后面又改成了特色图片(Featured Image,这里为了统计叫法,还是使用日志缩略图的名称)并且提供了详细的接口让主题的作者设置和调用日志的缩略图。

WordPress 日志缩略图(Post Thumbnail)详细介绍和使用
WordPress 日志缩略图功能

开启 WordPress 日志缩略图功能

要使用日志缩略图功能,首先需要通过函数 add_theme_support() 来开启,具体是在当前 WordPress 主题的 functions.php 文件中添加以下代码:


add_theme_support( 'post-thumbnails' );

上面的代码会在 WordPress 后台编辑日志的界面开启设置日志缩略图的窗体,并且同时给日志和页面开启缩略图功能,如果想单独开启的话,使用以下代码:


add_theme_support( 'post-thumbnails', array( 'post' ) ); // 给日志启用日志缩略图
add_theme_support( 'post-thumbnails', array( 'page' ) ); // 给页面启用日志缩略图

设置日志缩略图大小

开启了 WordPress 日志缩略图功能之后,我们可以通过函数 set_post_thumbnail_size() 来设置缩略图的大小,这里有两种方式:box-resize(盒大小模式)和 hard-crop(裁剪模式)。

盒大小模式按照比例缩小图片直到适合指定的盒子,所以不会扭曲图片。盒大小模式可以指定长度和宽度,比如一张 100X50 的图片在指定的 50X50 的盒子中会被缩小为 50X25。

这种模式的好处是可以显示整张图片,缺点是生成的图片并不是一样大的,它是按照最长边来设置的,所以有时候是长度一样,有时候是高度一样。如果我们想限制缩略图到一定的宽度,而不在乎它的高度,这时候我们可以指定缩略图的宽度,然后设置它的高度为 9999 或者其他任何认为够大的一个数字。代码如下:


set_post_thumbnail_size( 50, 50 ); // 50 像素宽和 50 像素高,盒大小模式(box resize mode)。

第二种是硬裁剪模式(hard-crop),这种模式下,图片会被裁剪为指定的大小,这种方式的好处就是得到我们所希望的,比如我们希望的到一张 50X50 的缩略图,就会得到 50X50 的缩略图,缺点就是图片会被裁减,缩略图中只会显示图片的一部分。这种方式的代码是:


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

在主题中显示日志缩略图

现在我们要在主题中使用模板函数来显示日志缩略图,下面这些函数应该在 WordPress 的主循环中使用。

has_post_thumbnail():判断当前日志是否有缩略图,如果有返回 true,否则为 false:


<?php
if ( has_post_thumbnail() ) {
	//当前日志有缩略图
} else {
	//当前日志没有设置缩略图
}
?>

the_post_thumbnail():输出日志缩略图,如果缩略图存在的话。


<?php the_post_thumbnail(); ?>

WordPress 日志缩略图具体使用案例

假设我们想在首页使用一个比较小的 50X50 裁剪模式的缩略图,并且想在日志页面使用 400 像素宽(高度不限制)的图片?我们可以设置额外的自定义尺寸缩略图,代码如下:

functions.php 中添加如下代码:


add_theme_support( 'post-thumbnails' );
set_post_thumbnail_size( 50, 50, true ); // 普通的缩略图
add_image_size( 'single-post-thumbnail', 400, 9999 ); // 定义日志页面的缩略图大小

在当前主题的 index.php 或者 home.php(取决主题的结构)中的主循环添加如下代码:


<?php the_post_thumbnail(); ?>

在当前主题的 single.php (也是主循环中)添加如下代码:


<?php the_post_thumbnail( 'single-post-thumbnail' ); ?>

通过函数 set_post_thumbnail_size() 可以生成默认的日志缩略图。

除此之外,我们还可以通过调用 add_image_size(); 来增加额外的日志缩略图尺寸,然后在日志页面通过 the_post_thumbnail( ); 调用新的缩略图尺寸老显示新的缩略图。

其他 WordPress 日志缩略图相关的函数

get_post_thumbnail_id():获取日志缩略图 ID

有时候我们想获取缩略图的 ID,日志缩略图的 ID 是存在 meta_key 为 _thumbnail_id 的值中,但是我们只需要使用下面简单的函数就可以获取日志的缩略图 ID:


$image_id = get_post_thumbnail_id();

get_the_post_thumbnail():获取日志缩略图而不是输出它

有时候,我们可能在 PHP 代码中返回日志缩略图,而不是输出它,可以使用下面简单的代码:


$image = get_the_post_thumbnail( $post->ID, 'thumbnail' );