Adds friendly permalink support, template files, and a conditional for public, non-hierarchical custom post types.<\/p>\n\n
WordPress 3.0 opens the door for entirely new content management possibilities with custom post types. As awesome as it is, the first version to implement custom post types is missing a few things. This plug-in patches one of those holes: templates and friendly permalinks that enable \"archives\" for custom post types, much the like the \"blog home\" is an archive for all \"post\" post types.<\/p>\n\n
This plug-in will only add custom post type archives for non-hierarchical (post-like), public custom post types with a \"slug\" or permalink.<\/p>\n\n
For example, suppose you have a custom post type \"Movies\". WordPress 3.0 takes care of permalinks for individual movie content, for example, http:\/\/yourblog.com\/movies\/casa-blanca\/. You might think you could get an archive of all recently added movies (just like the blog home is an archive of all recently added posts) by going to http:\/\/yourblog.com\/movies\/, but this isn't supported out of the gate. You can do it without permalinks by going to http:\/\/yourblog.com\/?post_type=movies, but even then, you're forced to use the index.php template file in your theme. This plug-in enables archive permalinks (yourblog.com\/movies), adds two new template files in the hierarchy (i.e. type-movies.php and type.php), and adds a new \"is_custom_post_type_archive\" conditional you can use in your theme!<\/p>\n\n
yourblog.com\/(custom-post-type-name)<\/code> - including paging (\/page\/2\/) and feedS (\/feed\/)<\/li>\n- Adds two new template files to the hierarchy,
type-(custom-post-type-name).php<\/code> (or post type slug) and type.php<\/code><\/li>\n- Adds new body classes to custom post type archives,
custom-post-type-archive<\/code> and custom-post-type-(post-type-name)-archive<\/code><\/li>\n- Fixes the
is_home<\/code> conditional check on custom post type archives (incorrectly reports true by default)<\/li>\n- Adds a new conditional,
is_custom_post_type_archive<\/code> for use in your themes: can optionally be passed name of post type<\/li>\n- Fixes the wp_title output on custom post type archives to show the custom type's label<\/li>\n
- Automatically adds feed links for custom post type archives when on a custom archive or singular custom post type if \"automatic feed links\" is enabled in your theme<\/li>\n<\/ol>\n\n
What didn't<\/em> make it in this pre-1.0 release:<\/p>\n\n\n- New navigation menu widget for easily adding custom post type archives to navigation<\/li>\n<\/ol>\n\n\n
\n- Install easily with the WordPress plugin control panel or manually download the plugin and upload the extracted\nfolder to the
\/wp-content\/plugins\/<\/code> directory<\/li>\n- Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n
- Create new
type-(custom-post-type-name).php<\/code> (may also use slug) and \/ or type.php<\/code> template files in theme, if desired<\/li>\n<\/ol>\n\n\n\n- Why aren't my new custom post type archive permalinks working?<\/dt>\n
First, make certain the custom post type is supported by the plug-in. This plug-in will only add archive permalink for non-hierarchical, public custom post types that have a \"slug.\" There's plenty of documentation on register_post_type if you need help verifying that.<\/p>\n\n
If you're certain it's a supported post type archive, try going to Settings > Permalinks, and just hit \"save\" to refresh the permalink settings and cache.<\/p>\n\n
If that doesn't work, try getting in touch on our support page.<\/p><\/dd>\n
- How do I add a navigation element for my custom post type archive?<\/dt>\n
Manually. Any number of ways, like a \"Custom Links\" menu item using the new nav menus, manually adding a link in your theme, or (if you're clever) even fetching the post type objects that meet the requirements using some API jujitsu.<\/p>\n\n
I'm going to try and add a new meta box to the \"Menus\" manager that allows easy adding of custom post types. I got about 75% of the way there already, but there's a lot going on in that API that I still have to wrap my head around!<\/p>\n\n
In the mean time, consider using the body class as a work around.<\/p><\/dd>\n\n<\/dl>\n\n\n
0.9.3<\/h4>\n\n\n- Support for post queries with multiple post types (fixes illegal offset error)<\/li>\n
- Allows passing post type via array in a custom query (another potential illegal offset cause)<\/li>\n
- Better protection against passing invalid post types into functions<\/li>\n
- Special filters and post query properties now properly registered upon query, not template redirection<\/li>\n
- Fewer redundant checks in code \/ general optimizations<\/li>\n<\/ul>\n\n
0.9.2<\/h4>\n\n\n- Automatically outputs custom post type archive feed links if \"automatic feed links\" is enabled in your theme<\/li>\n
- Further improved validation \/ conditional checks to avoid very rare warnings in debug mode<\/li>\n<\/ul>\n\n
0.9<\/h4>\n\n\n- Full feed (rss \/ rss2 \/ etc) support for custom post types via permalink, i.e.
\/(post-type-name)\/feed\/<\/code><\/li>\n- Better validation in code - no more warnings when debug is turned on<\/li>\n
- Supports
type-(slug).php<\/code> in addition to type-(name).php<\/code> template files (confused many users)<\/li>\nis_custom_post_type_archive<\/code> function can now be passed a name of a post type to check against<\/li>\n<\/ul>\n\n0.8.5<\/h4>\n\n\n- Enhancement: full support for child themes (proper calling of new template files via
locate_template<\/code> function)<\/li>\n- Bug fix: looser conditional matching of custom post type properties (should fix many \"just doesn't work\" cases)<\/li>\n
- Bug fix: proper filtering \/ handling of wp_title override (respects separator, separator location)<\/li>\n<\/ul>","raw_excerpt":"Adds friendly permalink support, template files, and a new conditional for public, non-hierarchical custom post types.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/9586","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=9586"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/jakemgold"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=9586"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=9586"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=9586"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=9586"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=9586"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=9586"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}