In the last few days, I’ve shown a few people a screenshot of something I’ve been working on for this site. The screenshot is of a home page displaying custom post types and not just the post post type. After numerous requests for the code to do this, I figured it’d be much easier to share it here.
WordPress version 3.0 will make creating custom post types extremely simple. But, the techniques I’ll point out in this tutorial can be used with previous versions of WordPress.
Changing the post type on the home page
By default, WordPress shows the post post type on your home page. Let’s suppose we want to show several post types in addition to posts:
page(yes, regular pages)albummoviequote
To add these, open your theme’s functions.php file and paste this PHP code into it:
add_filter( 'pre_get_posts', 'my_get_posts' );
function my_get_posts( $query ) {
if ( is_home() && false == $query->query_vars['suppress_filters'] )
$query->set( 'post_type', array( 'post', 'page', 'album', 'movie', 'quote', 'attachment' ) );
return $query;
}That’s all there is to it.
You may have noticed the addition of the attachment post type even though I didn’t mention adding it. This is something I highly recommend adding if you’ll be showing any attachment images on your home page For example, if you have a gallery on your home page, the images won’t appear without adding the attachment post type.
Showing the post types in your feed
Realizing that many of you might want to also add these post types to your feed to match your blog, a small change in the code is required. All you need to do is change this line:
if ( is_home() )We’ll use the is_feed() conditional tag:
if ( ( is_home() && false == $query->query_vars['suppress_filters'] ) || is_feed() )Now, you can have custom post types in your regular blog post rotation and your feed. Enjoy and look for more custom post type tutorials soon.
One thing I don’t really understand is how/where I select what post type I’m about to write in the backend. Particularly when we don’t have a UI for that yet.
I believe that the UI stuff is what’s coming in 3.0.
If you’re using the trunk version you can see the UI, but you have to register your post type first.
Just replace “movies” with whatever you want.
Ok. This makes sense. So there is no real way of using custom post types with 2.9.1
You can use them, but you’d have to do all the admin UI stuff and rewrite rules yourself. Basically, it’s too much of a pain to do.
I’ll be writing a complete tutorial on post types in 3.0 as soon as everything is ironed out with them in trunk.
Nice, can’t wait for your full tutorial when 3.0 is released.
I feel these will evolve into complete custom write panels, image the possibilities.
It’s difficult to be patient for all the features coming in 3.0! It’ll likely be the most revolutionary WordPress version yet and in all truth, it will subsequently become the defacto CMS throughout the world.
As Justin says, in addition to the code you still have to do the UI panel. Right now WP 3.0 trunk doesn’t display any UI even after registering post types.
I got this to work in the current trunk including the UI panel with a couple of simple additions to you code.
function post_type_movies()
{
register_post_type('movies', array('label'=>__('Movies'), 'public'=>true, 'show_ui'=>true, 'exclude_from_search'=>false));
register_taxonomy_for_object_type('post_tag', 'movies');
}
add_action('init', 'post_type_movies');
Wow.. great features, Can’t wait for WP 3.0
Great example! I’ve never used $query->set() before. I believe that you just opened up a whole new world for me. Thanks!
I actually end up using it a lot, at least in my support forums. So many people want to get rid of a category or just show a specific category on the home page. Of course, most tutorials around the Web tell them to use
query_posts()even though there’s a perfect filter hook for the job that keeps users out of theme templates.Can you talk more about how you use query set? I’m not sure I’m understanding how this keeps people out of the templates any more than query posts.
Hello! I am trying to make a three-column homepage, with a different category’s post displaying in each of the first two columns. I’m using your Query Posts plug-in, but can’t get the main content to disappear.
Is this ‘$query->set()’ the solution? I would so appreciate your advice. You’ve already helped me a ton with this, my infinite gratitude!
All my best
Kelly
Very useful information. Especially for a newbie like me. I will try to implement that on my blog. Thanks.
Wordpress 3.0 is coming? I don’t think I’ll upgrade that quickly when it comes out, maybe I’ll have to wait it out till 3.1 comes out.
It’ll be a while, but why would you wait? There’s some exciting things coming in 3.0.
Cool feature, but i think is better wait for the 3.0 version of WP, im not confident enough on messing on installation files.
I’m not sure if you misunderstood something from the post, but I’d never advocate changing installation files.
The tutorial deals with editing your theme’s
functions.php. The methods used above work in 2.9 and will be the same in 3.0.Hi, another use from this wordpress 3.0 . Very thankful to you for sharing.
I will try this one as soon as i get WP 3.0. A great stuff to help the bloggers. Really i need the code for that and you have provided it.
I can’t wait for Wordpress 3.0! I’ll be waiting for your tutorial.
[...] Justin had been playing with these types, we check out the possibilities of types for [...]
Am I correct to assume that 3.0 will introduce new admin panels for custom post_types?
So in 3.0 if I create a custom post type ‘movies’ I will then have a new ‘movies’ choice in the admin panel where the user could input the information relevant to ‘movies’ only?
Right now with 2.9 I basically create new meta field boxes for the admin to fill in while writing a post. The problem comes into effect when I have ‘movies’ as a type of post, and say ‘music’ as a second type.
Right now in 2.9 both the meta input boxes show up in the ‘add article’ admin section, which makes it really confusing to the user. They have the ability to input information both for movies and music on the same ‘add article’ admin page.
This would indeed go a long ways into turning wp into more of a cms, where the author has a much clearer path as to where to input the data for each type of post…. boy I sure hope I am right.
How do custom posts jive with traditional taxonomies, such as categories and tags? If I queried a category, would all posts and (musics, et al) that have that category display?
I’m interested in this, I heard that they were adding the Categories and Tags taxonomies to Pages so, at least in my mind, it makes sense that they would apply to both. And I’m assuming that custom-post types would also be applicable, as long as you made sure they were registered for those taxonomies.
Which, if that is true then it makes sense that any custom taxonomies could also be registered across multiple custom post-types, as well as your posts and pages, if you desired as well..
Very exciting stuff.
nice feature, this is very useful for me.
[...] qui permet d’attribuer un genre à un article. Cette fonction est reprise en détail par Justin Tadlock. Ensuite, WordPress 3.0 autorisera la personnalisation simplifiée des arrières-plans de nos sites [...]
[...] Showing custom post types on your home/blog page [...]
[...] goes to Justin Tadlock for this handy [...]
Hi,
As you wrote, if I remove the ‘attachment’ type I’ll get the posts without the images. I would like to get the images without the posts but when I omit the ‘post’ type’, and leave onle the ‘attachment’ type, I get nothing.
Any idea?
I’ve just been playing around with this in WP 3.0 svn and so far so good. I can easily create a new post type, assign the default post features and custom taxonomies and get it all in a custom write panel. It’s also easy to create custom meta boxes linked to the new post type.
What I’m wondering about is:
1. How will adding custom fields to the custom post type be managed (one could just use the post custom fields but what if it’s a more complex post type that warrants its own DB table.)
2. I’d like to see an interface to also be able to add arbitrary custom fields to the Quick Edit part on the post list.
I guess what I want to be able to do is create custom front end functionality depending on the post type. For example:
Event Post Type
- display additional fields like event date, duration, venue, contact, etc…
- change the post sorting to use event start date or venue or any other additional field.
So basically my front end template will have different functionality than the default post type of ‘post’…
I guess I’m jumping ahead a bit here but just wanted to voice my thoughts
.
wow great post thanks for sharing with us
nice feature!
[...] make sure to check out what Justin Tadlock has to say on this [...]
Totally helpful. Thanks a lot
I’ve problem..How do custom posts such as categories and tags?
[...] Showing custom post types on your home/blog page [...]
Awesome tutorial, but what would I have to do if I wanted to query only one specific type in the sidebar? I tried your Query Posts widget to query all the items from a non-hierarchical category “song” and it’s impossible.
And how can I assure that a custom post type will be page-like? I was trying to get rid of some things in the display on “song” post type and make it output values of certain custom fields by making it a custom template and I realised that it’s not possible, because it’s post-like, not page-like. Would creating a template file song.php result in anything by default? I thought this is what add_post_type_support() could do but I have not seen any references to that yet.
I guess that I can’t wait for the rest of this series, as so many things are left unsaid and your and WP Engineer’s posts on this both left everyone curious.
We are going to kick-off a blog for our company. And, I’m curious as to why you chose WordPress over say TypePad or Blogger. What’s the advantage?
[...] Showing custom post types on your home/blog page [...]
does this work with xampp? because i am using one i don’t if it will work.
Justin,
Nice post, thanks.
One thing though is that you example as written whacks out the new menu system since menu items are not custom post types. You should change it (I think) to
That works for me but there may be an even more robust way to handle it.
Thanks Mike. My menu vanished after a very long session and this was a life saver!
This solves it 100%
Actually this has now conflicted with something else. Is there a definative way of achieving this in WordPress 3.0 without loosing your custom menu?
Triying to achive this result, not on home but categories. im updating the code as i find out more, but still not working properly
now the wp_nav_menu only conflicts on the category page, everything else is showing normal
http://wordpress.org/support/topic/418330
Most usefull post, but still can’t wait for wp3.0
I also agree with Jason Pelker, WP will become defacto CMS and still be easy to host it anywhere.
This is very helpful. Thank you very much. Are you going to write a bit more about it?
One thing I noticed with using the Wordpress dev version is that the edit post/page title has changed. It probaby is constructed something like this: “Edit $post_type”.
This is bad, because it doesn’t take other more complex languages into account.
For example, both finnish and estonian have over a dozen of different cases, and this is one of the places where they are used.
For example, while editing a page, in estonian this would display “Muuda leht”, whereas it should be “Muuda lehte”.
What does it mean when you get: “Warning: Illegal offset type in isset or empty in /home/content/html/wordpress/wp-includes/query.php on line 1715″?
[...] Showing custom post types on your home/blog page WordPress 3.0 introduces custom post types, a new step to improve the CMS capabilities of WordPress. Here is a way to include them into your loop. (tags: 3.0 wordpress development) Leave a Reply Click here to cancel reply. [...]
the thing I don’t understand is from a theme creation perspective how do we call these in a specific way. It seems like you did that in your screen shot but didn’t speak to it in the post.
[...] Instructions on how to make custom post types show up is available, courtesy of Justin Tadlock (thanks to Brad Williams for sending me to Justin’s post). They involve edits to WordPress PHP files. At the time of writing, I haven’t made those edits to this install. This entry was posted in Uncategorized. Bookmark the permalink. Follow any comments here with the RSS feed for this post. ← Fuseki [...]
[...] Shared Showing custom post types on your home/blog page. [...]
[...] this site and this site if you want to learn more about the custom post [...]
Once again another solution, to save us a lot of extra editing…
Now if we could only sort out custom post_type archives that would be great.
Keep up the great work
I really need to create a new set of pages right now in a 2.92 site. But if I were on 3.0 already, I’d want to make them a custom post type instead. But I’m hearing this is 2 weeks out at least.
So…
In 3.0, can I convert a normal Page to a Custom Post Type? Likely not in Admin, so if it’s not, would I just be able to go into the database and change the post type field to the name of the custom post type, from “Page?”
Its ok, but WP 3.0 now in beta, on front page i see only 2,9,2?
nice. now how can I convince the Leviathan theme to show the byline before the post and the post-meta after the post for my custom post types just like it does for regular posts?
oh, just noticed that the settings for Hybrid recipe settings, recipe being my new custom post type, are not saved when saving a new recipe. any idea what could be wrong here?
Using wp 3.0 RC2 and your 0.8.1 beta hybrid theme + Leviathan
[...] Show Custom post Types on your Homepage by Justin Tadlock [...]
If I create a custom post, how can I filter my query to a specific category?
Let’s say a create a custom post type called ‘Music’ and I create 3 categories : ‘jazz’, ‘classical’ and rock. How can I only display the ‘jazz’ and ‘rock’ entries??
This’s not wok
query_posts('post_type=uslugi&cat=17,19'); ?[...] Showing custom post types on your home/blog page - Justin Tadlock A good post that shows how to add custom post types to your home page or in your feeds [...]
[...] was so stoked when I was reading a blog post on Justin Tadlock’s site about custom post types. He introduced me to a new way of hooking [...]
I think this will work really good with the new wordpress 3.0. What do you think?
Hi!
This doesn’t seem to work anymore with the final release of 3.0. I don’t know why, but I get a syntax error (in dreamweaver cs5) when I paste this code inside.
I would like to have my CPT’s displayed in the main loop, just like this code snippet does, but for some reason it just doesn’t work anymore…
Any ideas on why?
[...] from Subversion every 30 minutes. This will help people search for code references and resources.Showing custom post types on your home – Justin Tadlock – Working with custom post types, check out Justin’s article on how to bring those [...]
This works great, but I’m running into a problem. Let’s say you use this to show every post type on your homepage. But in the sidebar, you want to list the last five posts of one particular post type. So you set up a get_posts loop with the post_type specified. It doesn’t work. $query->set overrides your get_posts argument and shows the last five of all post types. What would be the best way to circumvent this problem?
I had to change the post query just before the post loop. This allowed me to do exactly what you are trying to do. This also doesn’t break the WordPress menus. You can check it out at http://think2loud.com/?p=763
It worked!
Although for some reason I had to make my post type plural in the code
[...] Showing custom post types on your home/blog page [...]
[...] ); } ?>if you want to read more about the first piece of code you can check it out on Justin Tadlock’s blog. Related PostsHarness the Power [...]
I entered the code in functions.php
under function editoptions() {
.But It doesn’t make any changes for any site in my multisite network. Am I missing anything?
Thank you !
[...] Justin Tadlock met avant la simplicité d'afficher les nouveaux types de modules d'articles sur la page d'accueil de votre blog WordPress, mais également dans flux d'informations. En effet, bien que cette fonctionnalité est très efficace elle reste néanmoins accessible qu'à une partie des utilisateurs du gestionnaire de contenu qu'est WordPress. Ces types de modules d'articles peuvent être créés et gérer directement depuis l'interface d'administration de votre blog via l"utilisation de l'extension "Custom Post Type UI" (déjà présenté). Il existe également une extension pour gérer, depuis votre interface de création de contenu, l'affichage de vos nouveaux modules d'articles. [...]
Just what I’ve been looking for but problem I have run in to a problem.
All my posts show on the home page page as I wish but I also have a gallery page which I would only like to display my gallery custom post types.
This is my code in page-gallery.php:
If I remove Justin’s code from my function.php then the only the gallery posts will be shown on the page but no on my home page.
Any idea’s? Or have I missed something?
Thanks
Where would you change
is_home()?Hi there Justin,
I have just started a new blog, and I am using a child theme for twentyten. I created two post types and noticed that they don’t show up at all. Even with a category assigned to them, they don’t show up in category page.
So I inserted the code you gave here in my function.php, and post types already show up in my homepage, but I get this error:
Warning: Illegal offset type in isset or empty in /home/magawork/public_html/criaturasblog/wp-includes/post.php on line 736
Warning: Illegal offset type in isset or empty in /home/magawork/public_html/criaturasblog/wp-includes/post.php on line 736
I have no idea what this means.
Can you help me please?
Hi Justin, thanks for this code. I don’t pretend to fully understand it, but I will try to implement this feature. I like the flexibility of adding post type to the blog page.
Im getting the same issue as Ivan.
I want to be able to show my custom Post types when i filter by category… Ivans code works but with nasty side effects
http://wordpress.org/support/topic/adding-custom-post-type-to-the-loop-wp-nav-menu-dissapears?replies=5#post-1645931
HELP!!!
I currently use this code, as per your example to show different custom post types on my home page.
can you help me change the code to exclude posts from a certain category from being displayed?