Question

get_the_post_thumbnail_caption( int|WP_Post $post = null )

Returns the post thumbnail caption.

---

description

---

参数

$post

(int|WP_Post) (Optional) Post ID or WP_Post object. Default is global $post.

Default value: null

---

返回值

(string) Post thumbnail caption.

---

源代码

File: wp-includes/post-thumbnail-template.php

function get_the_post_thumbnail_caption( $post = null ) {
	$post_thumbnail_id = get_post_thumbnail_id( $post );
	if ( ! $post_thumbnail_id ) {
		return '';
	}

	$caption = wp_get_attachment_caption( $post_thumbnail_id );

	if ( ! $caption ) {
		$caption = '';
	}

	return $caption;
}

---

更新日志

Version	description
4.6.0	Introduced.

---

相关函数

Uses

• wp-includes/post.php: wp_get_attachment_caption()
• wp-includes/post-thumbnail-template.php: get_post_thumbnail_id()

---

Used By

• wp-includes/post-thumbnail-template.php: the_post_thumbnail_caption()

---

User Contributed Notes