get_the_post_thumbnail

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

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

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: