Before the_post_thumbnail was available, here is how I would fetch an array of images that were attached to a post in wordpress:
<?php $images = &get_children('post_type=attachment&post_mime_type=image&orderby=menu_order&order=ASC&post_parent='.$post->ID); if ($images): $image = current($images); $imageData = wp_get_attachment_image_src($image->ID); ?> <img src="<?php echo $imageData[0] ?>" alt="<?php the_title() ?>" /> <?php endif ?> <!-- image title: $image->post_title, caption: $image->post_excerpt, description: $image->post_content --> |
Usually we’d use this just to pull out the first image attachment to a post and use this in a special place in our template. Now that there is built-in post thumbnail support, we wanted to use this feature but also still have the ability to display the selected thumbnail’s caption information. the_post_thumbnail only returns the image tag, so here is our custom filter (inside our template’s functions.php file) that adds our caption:
function monahans_thumbnail_caption($html, $post_id, $post_thumbnail_id, $size, $attr) { $attachment =& get_post($post_thumbnail_id); // post_title => image title // post_excerpt => image caption // post_content => image description if ($attachment->post_excerpt || $attachment->post_content) { $html .= '<p class="thumbcaption">'; if ($attachment->post_excerpt) { $html .= '<span class="captitle">'.$attachment->post_excerpt.'</span> '; } $html .= $attachment->post_content.'</p>'; } return $html; } add_action('post_thumbnail_html', 'monahans_thumbnail_caption', null, 5); |
The result of this filter is now anytime we call the_post_thumbnail in our template, the html will come back with our image caption, too.
Hello,
Wonderful plugin, thanks. I spent a while looking for some way of displaying my captions.
I also wanted to use the caption as a rollover state of a clickable thumbnail. I think this requires some code tweaks. Do you think this would even be possible?
I could send the code in my functions file for my loop if that helps.
Cheers
Rob
Hey great function, but when I use it, the more tag no longer functions on the page, also my first article without a feature image gets no title displaying. Any ideas?
Thanks for the code. In principle it works, but the caption is shown inside the a-tags and therefore it smashes the design.
Any hints for me, how to put the caption outside the a-tags just below the thumbnail with the same css tags used in the single article?