2009-12-10 07:14:36 +01:00
< ? php
/**
* WordPress Post Thumbnail Template Functions .
*
* Support for post thumbnails
* Themes function . php must call add_theme_support ( 'post-thumbnails' ) to use these .
*
* @ package WordPress
* @ subpackage Template
*/
/**
* Check if post has an image attached .
2010-01-15 23:11:12 +01:00
*
2009-12-10 07:14:36 +01:00
* @ since 2.9 . 0
*
* @ param int $post_id Optional . Post ID .
2010-02-24 21:13:23 +01:00
* @ return bool Whether post has an image attached .
2009-12-10 07:14:36 +01:00
*/
function has_post_thumbnail ( $post_id = NULL ) {
2010-08-28 13:57:28 +02:00
$post_id = ( NULL === $post_id ) ? get_the_ID () : $post_id ;
2009-12-10 07:14:36 +01:00
return !! get_post_thumbnail_id ( $post_id );
}
/**
* Retrieve Post Thumbnail ID .
2010-01-15 23:11:12 +01:00
*
2009-12-10 07:14:36 +01:00
* @ since 2.9 . 0
*
* @ param int $post_id Optional . Post ID .
* @ return int
*/
function get_post_thumbnail_id ( $post_id = NULL ) {
2010-08-28 13:57:28 +02:00
$post_id = ( NULL === $post_id ) ? get_the_ID () : $post_id ;
2009-12-10 07:14:36 +01:00
return get_post_meta ( $post_id , '_thumbnail_id' , true );
}
/**
* Display Post Thumbnail .
2010-01-15 23:11:12 +01:00
*
2009-12-10 07:14:36 +01:00
* @ since 2.9 . 0
*
* @ param int $size Optional . Image size . Defaults to 'post-thumbnail' , which theme sets using set_post_thumbnail_size ( $width , $height , $crop_flag ); .
* @ param string | array $attr Optional . Query string or array of attributes .
*/
function the_post_thumbnail ( $size = 'post-thumbnail' , $attr = '' ) {
echo get_the_post_thumbnail ( NULL , $size , $attr );
}
/**
* Retrieve Post Thumbnail .
2010-01-15 23:11:12 +01:00
*
2009-12-10 07:14:36 +01:00
* @ since 2.9 . 0
*
* @ param int $post_id Optional . Post ID .
* @ param string $size Optional . Image size . Defaults to 'thumbnail' .
* @ param string | array $attr Optional . Query string or array of attributes .
2010-06-30 02:05:18 +02:00
*/
2009-12-10 07:14:36 +01:00
function get_the_post_thumbnail ( $post_id = NULL , $size = 'post-thumbnail' , $attr = '' ) {
2010-08-28 13:57:28 +02:00
$post_id = ( NULL === $post_id ) ? get_the_ID () : $post_id ;
2009-12-10 07:14:36 +01:00
$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
$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 );
}
2010-08-28 13:57:28 +02:00
?>