WordPress 日志缩略图功能

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

从 WordPress 2.9 开始，WordPress 开始内置了日志缩略图的功能，并且提供了详细的接口让主题的作者设置和调用日志的缩略图。



WordPress 日志缩略图功能

开启 WordPress 日志缩略图功能

在当前 WordPress 主题的 

functions.php

 添加以下函数，这个函数会在 WordPress 后台编辑日志的界面开启设置日志缩略图的窗体。

add_theme_support( 'post-thumbnails' );

上面的代码会同时给日志和页面开启缩略图功能，如果你想单独开启该功能，使用以下代码：

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

设置日志缩略图大小

开启了 WordPress 日志缩略图功能之后，我们应该缩略图的大小，这里有两种方式：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( 'post-thumbnail' )

— 默认的日志缩略图“handle”（处理函数）。但是我们可以通过调用 

add_image_size( $handle, $width, $height, {$hard_crop_switch} );

 来增加额外的日志缩略图处理函数，然后通过传递 handle 给 

the_post_thumbnail( $handle );

 来使用新的缩略图尺寸。

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

获取日志缩略图 ID

有时候你想自定义脚本，这个时候你可能获取缩略图的 ID，日志缩略图的 ID 是存在 meta key 为

_thumbnail_id

 的值中，但是我们只需要使用下面简单的函数就可以获取日志的缩略图 ID：

$image_id = get_post_thumbnail_id();

获取日志缩略图而不是输出它

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

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