author | hurons@caf4f556-3d62-0410-8435-a86758001935 |
Tue, 02 Feb 2010 15:44:16 +0000 | |
branch | wordpress |
changeset 132 | 4d4862461b8d |
child 194 | 32102edaa81b |
permissions | -rw-r--r-- |
132
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
1 |
<?php |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
2 |
/** |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
3 |
* WordPress Post Thumbnail Template Functions. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
4 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
5 |
* Support for post thumbnails |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
6 |
* Themes function.php must call add_theme_support( 'post-thumbnails' ) to use these. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
7 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
8 |
* @package WordPress |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
9 |
* @subpackage Template |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
10 |
*/ |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
11 |
|
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
12 |
/** |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
13 |
* Check if post has an image attached. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
14 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
15 |
* @since 2.9.0 |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
16 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
17 |
* @param int $post_id Optional. Post ID. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
18 |
* @return bool Whether post has an image attached (true) or not (false). |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
19 |
*/ |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
20 |
function has_post_thumbnail( $post_id = NULL ) { |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
21 |
global $id; |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
22 |
$post_id = ( NULL === $post_id ) ? $id : $post_id; |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
23 |
return !! get_post_thumbnail_id( $post_id ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
24 |
} |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
25 |
|
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
26 |
/** |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
27 |
* Retrieve Post Thumbnail ID. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
28 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
29 |
* @since 2.9.0 |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
30 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
31 |
* @param int $post_id Optional. Post ID. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
32 |
* @return int |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
33 |
*/ |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
34 |
function get_post_thumbnail_id( $post_id = NULL ) { |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
35 |
global $id; |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
36 |
$post_id = ( NULL === $post_id ) ? $id : $post_id; |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
37 |
return get_post_meta( $post_id, '_thumbnail_id', true ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
38 |
} |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
39 |
|
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
40 |
/** |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
41 |
* Display Post Thumbnail. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
42 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
43 |
* @since 2.9.0 |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
44 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
45 |
* @param int $size Optional. Image size. Defaults to 'post-thumbnail', which theme sets using set_post_thumbnail_size( $width, $height, $crop_flag );. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
46 |
* @param string|array $attr Optional. Query string or array of attributes. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
47 |
*/ |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
48 |
function the_post_thumbnail( $size = 'post-thumbnail', $attr = '' ) { |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
49 |
echo get_the_post_thumbnail( NULL, $size, $attr ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
50 |
} |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
51 |
|
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
52 |
/** |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
53 |
* Retrieve Post Thumbnail. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
54 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
55 |
* @since 2.9.0 |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
56 |
* |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
57 |
* @param int $post_id Optional. Post ID. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
58 |
* @param string $size Optional. Image size. Defaults to 'thumbnail'. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
59 |
* @param string|array $attr Optional. Query string or array of attributes. |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
60 |
*/ |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
61 |
function get_the_post_thumbnail( $post_id = NULL, $size = 'post-thumbnail', $attr = '' ) { |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
62 |
global $id; |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
63 |
$post_id = ( NULL === $post_id ) ? $id : $post_id; |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
64 |
$post_thumbnail_id = get_post_thumbnail_id( $post_id ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
65 |
$size = apply_filters( 'post_thumbnail_size', $size ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
66 |
if ( $post_thumbnail_id ) { |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
67 |
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 |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
68 |
$html = wp_get_attachment_image( $post_thumbnail_id, $size, false, $attr ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
69 |
do_action( 'end_fetch_post_thumbnail_html', $post_id, $post_thumbnail_id, $size ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
70 |
} else { |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
71 |
$html = ''; |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
72 |
} |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
73 |
return apply_filters( 'post_thumbnail_html', $html, $post_id, $post_thumbnail_id, $size, $attr ); |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
74 |
} |
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
75 |
|
4d4862461b8d
Update Wordpress 2.9.1
hurons@caf4f556-3d62-0410-8435-a86758001935
parents:
diff
changeset
|
76 |
?> |