WordPress 常用函数 / get_the_post_thumbnail_url

Denis | 邓鸿华 函数参考 1673 2020年11月23日

简介

获取文章缩略图链接

用法

<?php get_the_post_thumbnail_url( $post = null, $size = 'post-thumbnail' ); ?>

参数

$post_id
(integer) (Optional) Post ID 或者 WP_Post 对象，在主循环中，不传则自动获取全局变量 $post。
Default: Null

$size
(string/array) (Optional) 图片大小，可以是以下几个关键字：thumbnail, medium, large, full，或者通过函数 add_image_size() 自定义尺寸的关键字。或者宽和高的一个大小，比如：(32,32).
Default: 'post-thumbnail'，当前主题通过函数 set_post_thumbnail_size 设置的。

返回值

(string|false)
文章缩略图链接，如无则返回 false

实例

<?php
if ( have_posts() ) {
    while ( have_posts() ) {
        the_post();
   
        /* 获取文章缩略图的大图 */
        $featured_img_url = get_the_post_thumbnail_url(get_the_ID(),'full'); 
  
        /* 使用 lightbox 效果打开大图 */
        echo '<a href="'.esc_url($featured_img_url).'" rel="lightbox">'; 
            the_post_thumbnail('thumbnail');
        echo '</a>';
    endwhile; 
endif;
?>

修改记录

Since 4.4.0

源文件

wp-includes/post-thumbnail-template.php