Definition:
function get_the_post_thumbnail( $post_id = null, $size = 'post-thumbnail', $attr = '' ) {}
Retrieve Post Thumbnail.
Parameters
- int $post_id: Optional. Post ID.
- string $size: Optional. Image size. Defaults to ‘thumbnail’.
- string|array $attr: Optional. Query string or array of attributes.
Defined filters
- post_thumbnail_size
apply_filters( 'post_thumbnail_size', $size ) - post_thumbnail_html
apply_filters( 'post_thumbnail_html', $html, $post_id, $post_thumbnail_id, $size, $attr )
Defined actions
- begin_fetch_post_thumbnail_html
do_action( 'begin_fetch_post_thumbnail_html', $post_id, $post_thumbnail_id, $size ); - end_fetch_post_thumbnail_html
do_action( 'end_fetch_post_thumbnail_html', $post_id, $post_thumbnail_id, $size );
Source code
function get_the_post_thumbnail( $post_id = null, $size = 'post-thumbnail', $attr = '' ) {
$post_id = ( null === $post_id ) ? get_the_ID() : $post_id;
$post_thumbnail_id = get_post_thumbnail_id( $post_id );
$size = apply_filters( 'post_thumbnail_size', $size );
if ( $post_thumbnail_id ) {
do_action( 'begin_fetch_post_thumbnail_html', $post_id, $post_thumbnail_id, $size ); // for "Just In Time" filtering of all of wp_get_attachment_image()'s filters
if ( in_the_loop() )
update_post_thumbnail_cache();
$html = wp_get_attachment_image( $post_thumbnail_id, $size, false, $attr );
do_action( 'end_fetch_post_thumbnail_html', $post_id, $post_thumbnail_id, $size );
} else {
$html = '';
}
return apply_filters( 'post_thumbnail_html', $html, $post_id, $post_thumbnail_id, $size, $attr );
}
1845

February 12, 2011 


No comments yet... Be the first to leave a reply!