WordPress filters and actions remains one of my favorite features. There is so much that you can easily manipulate without modifying a theme’s files.
For example: on my front page I like the latest published post to show the whole content with a featured image if there is one. For the rest of the articles I want to display the excerpt and no featured image. This is the same on the front page and subsequent pages.
One way to do this is to create a child theme and modify the PHP to get the effect you like. There’s a few reasons why I don’t like that option.
- Child themes are fun and I always recommend users create them. But I’m bad at maintaining them when the parent theme is updated.
- My CSS is just awful and I’m pretty sure I’d break the responsiveness of my site.
- Filters are cool! I can use this code in a plugin.
Filter the_content
I took a shot at making my own filter but a quick search found that Justin Tadlock had written a really good post on the topic already in 2008. I use that code in my function but added a few lines.
// Get the ID of the last published post
$mh_last_id = wp_get_recent_posts( array( 'numberposts' => '1' ,
'post_status' => 'publish' ) )['0']['ID'];
// Get the post format. If the post is a standard format then the value will be false
$mh_post_type = get_post_format();
I do not want to show an excerpt for the latest post and only want to modify standard post formats. Anything else I want to skip. The reason I only want to play with standard format posts is that other post types break horribly when I force the excerpt this way.
Except for adding to the conditional statement, the whole function is copied from Justin’s post. He writes great code and explains it much better than I do.
// If is the home page, an archive, or search results and not the last post and is a standard format if((is_front_page() || is_archive() || is_search()) and $mh_last_id != get_the_ID() and !$mh_post_type )
That’s a little ugly to look at but it does the job.
What about the featured image?
In the past when I wanted to hide the featured image in a child theme I would use CSS like so.
.ryu-featured-thumbnail, .attachment-ryu-featured-thumbnail, .wp-post-image {
display: none;
}
Which works but is a little heavy handed. My WordPress installation still sends the HTML for the featured image and the browser still pulls that image. The end user just doesn’t see it because it’s not being displayed.
I don’t want to remove featured image support from the theme and I don’t want to send that HTML either. Thanks to the post_thumbnail_html filter I don’t have to.
add_filter( 'post_thumbnail_html', 'mh_post_image_html', 10, 3 );
function mh_post_image_html( $html, $post_id, $post_image_id ) {
// Get the ID of the last published post
$mh_last_id = wp_get_recent_posts( array( 'numberposts' => '1' ,
'post_status' => 'publish' ) )['0']['ID'];
if ( (is_front_page() || is_archive() || is_search()) and $mh_last_id != get_the_ID() ) {
$html = '<!-- Featured image not displayed in excerpt -->';
}
return $html;
}
This code checks if we’re the first post and replaces the post_thumbnail_html with a simple HTML comment.
Child theme or plugin?
This code works either way. At the moment I am using this in a plugin but the whole thing can be implemented in my child theme’s function.php file.
It belongs in the child theme because I’m playing with the presentation and that is theme territory. Editing a copy of content.php in the child theme directory would be more theme’ish but I like filters. Filters are cool.
I’m not good at keeping my child theme changes in sync with the parent theme so using a filter lets me just play with the results and not mess with theme files. In a plugin or the child theme’s functions.php file the filters still work the same.
