Array ( ) Array ( [page_type] => post_type [sub_type] => function_reference [page_id] => 6263 [time] => 1760434182 [os] => unknown [device] => [app] => [browser] => gecko [os_version] => 0 [browser_version] => 0 [app_version] => 0 [user_agent] => Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com) [ip] => 216.73.216.27 [country] => 美国 [region] => 美国 [city] => [nickname] => [email] => ) get_the_post_thumbnail_url / WordPress 常用函数

WordPress 常用函数 / get_the_post_thumbnail_url

简介

获取文章缩略图链接

用法

<?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