WordPress函数set_post_thumbnail()用于设置文章的特色图片(即特色图像、缩略图)。以下是其详细用法教程解析:
1. 语法
set_post_thumbnail( int $post, mixed $thumbnail )
2. 参数
- $post(必需):文章的ID或文章对象。
- $thumbnail(必需):要设置为特色图片的图像ID或图像URL。
3. 返回值
此函数没有返回值。
4. 示例用法
以下是使用set_post_thumbnail()函数的示例代码:
// 获取文章对象
$post = get_post( $post_id );
// 设置特色图像
set_post_thumbnail( $post, $thumbnail_id );
或
// 设置特色图像
set_post_thumbnail( $post_id, $thumbnail_id );
或
// 使用图像URL设置特色图像
set_post_thumbnail( $post_id, $thumbnail_url );
5. 注意事项
- 需要将特色图像功能添加到主题中才能使用set_post_thumbnail()函数。可以在主题的functions.php文件中添加以下代码:
add_theme_support( 'post-thumbnails' );
- $thumbnail参数可以是图像的ID或图像的URL。如果使用图像URL,则必须确保URL是有效的,并且图像也必须存在。
- 如果文章已经有特色图像,使用set_post_thumbnail()函数将替换原有的特色图像。
- 如果要从文章中删除特色图像,可以将$thumbnail参数设置为false或0。
以上就是set_post_thumbnail()函数的详细用法教程解析。使用这个函数可以方便地设置和更改文章的特色图片。
0 个评论