Question

get_post_thumbnail_id( int|WP_Post $post = null )

Retrieve post thumbnail ID.

---

description

---

参数

$post

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

Default value: null

---

返回值

(string|int) Post thumbnail ID or empty string.

---

源代码

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

function get_post_thumbnail_id( $post = null ) {
	$post = get_post( $post );
	if ( ! $post ) {
		return '';
	}
	return get_post_meta( $post->ID, '_thumbnail_id', true );
}

---

更新日志

Version	description
4.4.0	$post can be a post ID or WP_Post object.
2.9.0	Introduced.

---

相关函数

Uses

• wp-includes/post.php: get_post_meta()
• wp-includes/post.php: get_post()

---

Used By

• wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::prepare_links()
• wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::prepare_item_for_response()
• wp-includes/post-thumbnail-template.php: get_the_post_thumbnail_caption()
• wp-includes/embed.php: get_oembed_response_data_rich()
• wp-includes/post-thumbnail-template.php: get_the_post_thumbnail_url()
• wp-admin/includes/media.php: edit_form_image_editor()
• wp-admin/includes/media.php: get_media_item()
• wp-includes/post-thumbnail-template.php: has_post_thumbnail()
• wp-includes/post-thumbnail-template.php: update_post_thumbnail_cache()
• wp-includes/post-thumbnail-template.php: get_the_post_thumbnail()
• wp-includes/post-template.php: prepend_attachment()
• wp-includes/media.php: wp_prepare_attachment_for_js()
• wp-includes/media.php: wp_playlist_shortcode()
• wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_getPost()
• wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::mw_getRecentPosts()
• wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::_prepare_post()
Show 11 more used by Hide more used by

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note Contributed by Codex

   Show all attachments for the current post except the Featured Image
   To get all post attachments except the Featured Image, you can use this function with something like get_posts().

   Do this inside The_Loop (where $post->IDis available).

   
   $args = array(
   	'post_type'   => 'attachment',
   	'numberposts' => -1,
   	'post_status' => 'any',
   	'post_parent' => $post->ID,
   	'exclude'     => get_post_thumbnail_id(),
   );
   
   $attachments = get_posts( $args );
   
   if ( $attachments ) {
   	foreach ( $attachments as $attachment ) {
   		echo apply_filters( 'the_title', $attachment->post_title );
   		the_attachment_link( $attachment->ID, false );
   	}
   }