钩子文档

has_post_thumbnail

💡 云策文档标注

概述

has_post_thumbnail 是一个 WordPress 过滤器,用于控制文章是否具有特色图像。它允许开发者基于自定义逻辑修改默认的检测结果。

关键要点

  • 过滤器名称:has_post_thumbnail
  • 参数:$has_thumbnail(布尔值,表示文章是否有特色图像)、$post(文章 ID 或 WP_Post 对象)、$thumbnail_id(特色图像 ID 或 false)
  • 返回值:布尔值,表示文章是否有特色图像
  • 相关函数:has_post_thumbnail(),用于检测文章是否有特色图像
  • 引入版本:WordPress 5.1.0

📄 原文内容

Filters whether a post has a post thumbnail.

Parameters

$has_thumbnailbool
true if the post has a post thumbnail, otherwise false.
$postint|WP_Post|null
Post ID or WP_Post object. Default is global $post.
$thumbnail_idint|false
Post thumbnail ID or false if the post does not exist.

Source

return (bool) apply_filters( 'has_post_thumbnail', $has_thumbnail, $post, $thumbnail_id );

Changelog

Version Description
5.1.0 Introduced.