WordPress.org网站
获取WordPress
WordPress.org网站

WordPress开发人员资源

get_the_post_thumbnail_url（）

获取网址(int | WP_发布 $帖子 = 无效的,字符串|int[] $大小 = '后缩略图' ):字符串|假

在本文中

返回页首

返回帖子缩略图URL。

参数

$帖子整数|WP_支柱可选择的
邮政ID或WP_支柱对象。默认值为全局$帖子.

违约：无效的

$大小一串|整数[]可选择的
用于检索源的注册图像大小或高度和宽度维度的平面数组。违约'后缩略图'.

违约：'后缩略图'

返回

字符串|假张贴缩略图URL，如果没有可用的图像，则为false。如果$大小与任何注册的图像大小都不匹配，将返回原始图像URL。

来源

函数get_the_post_thumbnail_url（$post=null，$size='post-thumbnal'）{$post_thumbnail_id=获取post_thambnail_ id（$post）；if（！$post_thumbnail_id）{返回false；}$thumbnail_url=wp_get_attachment_image_url（$post_thumbnal_id，$size）；/***过滤帖子缩略图URL。**@自5.9.0起**@param string | false$thumbnail_url发布缩略图url或false（如果帖子不存在）。*@param int|WP_Post|null$Post Post ID或WP_Post对象。默认值为全局`$post`。*@param string | int[]$size注册图像大小以检索平面数组的源*高度和宽度尺寸。默认“后缩略图”。*/return apply_filters（'post_thumbnail_url'，$thumbnal_url，$post，$size）；}

查看所有引用 在Trac上查看 在GitHub上查看

挂钩

应用筛选器（'post_thumbnail_url'，字符串|假 $thumbnail_url,int|WP_Post|null $帖子,字符串|int[] $大小 )

过滤帖子缩略图URL。

使用描述
wp_get_attachment_image_url（）wp-includes/media.php

获取图像附件的URL。

获取post_thumbnail_id（）wp-includes/post-thumbnail模板.php

检索帖子缩略图ID。

应用过滤器（）wp-includes/plugin.php

调用已添加到过滤器挂钩的回调函数。

再显示1个显示较少
使用者描述
post_thumbnail_url（）wp-includes/post-thumbnail模板.php

显示帖子缩略图URL。

变更日志

版本描述
4.4.0介绍。

用户贡献的笔记

  1. 跳到注释5内容
    地下代码
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：17你必须登录才能对这个便条的帮助进行投票

    不要忽略第一个参数。
    正确使用`get_the_post_thumbnail_url（）`在循环中：

    if（have_posts（））{while（have_posts（））{post（）；/*获取全尺寸特色图像的url*/$featured_img_url=get_the_post_thumbnail_url（get_the_ID（），'full'）；/*将缩略图链接到用于lightbox的全尺寸图像*/echo'<a href=“'.esc_url（$featured_img_url）.'”rel=“lightbox”>'；_柱_缩略图（“缩略图”）；echo“</a>”；endwhile；endif；
  2. 跳到注释6内容
    劳尔·P。
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：4你必须登录才能对这个便条的帮助进行投票

    值得注意的是，如果你上传一个较小的图像（比如600px宽），并用它来获取一个特定的较大图像（比如1920px宽的封面），它将返回原始图像（比你需要的要小），而不是返回false。

    如果您需要回退到另一个图像，以防指定的文件不存在，那么可以查看wp_get_attachment_image_src，并检查图像的宽度或高度。

  3. 跳到注释7内容
    林赛麦克
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：2你必须登录才能对这个便条的帮助进行投票

    对发布自的示例投了反对票@内皮细胞编码器因为这个函数的用法不正确。

    正确使用`get_the_post_thumbnail_url（）`里面循环：

    if（have_posts（））{while（have_posts（））{post（）；/*获取全尺寸特色图像的url*/$featured_img_url=get_the_post_thumbnail_url（'full'）；/*将缩略图链接到用于lightbox的全尺寸图像*/echo'<a href=“'.$featured_img_url.'”rel=“lightbox”>'；post_thumbnail（“umbnail”）；echo“</a>”；endwhile；endif；

    正确使用`get_the_post_thumbnail_url（）`外部循环：

    /*通过ID*/获取特定的post对象$post=获取post（2）；/*获取全尺寸特色图像的url*/$featured_img_url=get_the_post_thumbnail_url（$post->ID，'full'）；/*将缩略图链接到用于灯箱的全尺寸图像*/echo'<a href=“'.$featured_img_url.'”rel=“lightbox”>'；_柱_缩略图（“缩略图”）；echo“</a>”；
  4. 跳到注释8内容
    玫瑰色
    你必须登录才能对这个便条的帮助进行投票本附注的投票结果：-14你必须登录才能对这个便条的帮助进行投票

    要显示带有alt标记的特色图像，请使用如下操作

    $缩略图=get_the_post_thumbnail_url（）；if（$缩略图）{$alt_text=get_post_meta（$缩略图->ID，'_wp_attachment_image_alt'，true）；if（！空（$缩略图））{if（！空（$alt_text））{$alt_text=$alt_txt；}其他{$alt_text=__（'无alt文本集'，'文本域'）；}echo“”；}}

你必须登录在能够发表注释或反馈之前。