Custom Post Types and Taxonomies in WordPress

1.Custom Post Types and Taxonomies In WordPress Brad Williams WebDevStudios.com

2. Who Am I? 3. Brad Williams Co-Founder of WebDevStudios.com Organizer NJ WordPress Meetup Co-Host SitePoint Podcast Co-Author ofProfessional WordPress(http://bit.ly/pro-wp) Who Am I? 4.

Explain Custom Post Types and Taxonomies

Create Custom Post Types

Create Custom Taxonomies

Hooking into WordPress

Topics 5. So what areCustom Post Types? 6. So what areCustom Post Types? CODEX : Post type refers to the various structured data that is maintained in the WordPress posts table. Native (or built-in) post type are post , page , attachment , revision , and nav-menu-item . Custom post types are also supported in WordPress and can be defined with register_post_type() . 7. WTFrack? 8. So what areCustom Post Types Really? ENGLISH : Custom Post Types allow you to create different types of content in WordPress. 9. Default WordPress Post Types:

Attachments

Revisions

Nav Menus (WP 3.0)

10. Custom Post Type Ideas

Podcasts

Movies

Quotes

Videos

House Listings

Events

Ticket System

etc, etc, etc

The possibilities are endless! 11. Example Time! Tweet: @williamsba CAUTION ZOMBIES AHEAD! #wcraleigh Win a copy of Professional WordPress! 12. Example: Zombie Modeling Agency 13. Example: Zombie Modeling Agency Drop the below code in your themes functions.php file 14. Example: Zombie Modeling Agency Drop the below code in your themes functions.php file 15. Example: Zombie Modeling Agency Lets break it down: 1. Action hook to trigger our function 2. Execute the register_post_type function defining zombies as our custom post type 3. Set the labelto Zombies 4. Set public to true.By default public is false which will hide your post type 16. Additional Arguments:labels An array of strings that represent your post type in the WP admin name: The plural form of the name of your post type. singular_name: The singular form of the name of your post type. add_new: The menu item for adding a new post. add_new_item: The header shown when creating a new post. edit: The menu item for editing posts. edit_item: The header shown when editing a post. new_item: Shown in the favorites menu in the admin header. view: Used as text in a link to view the post. view_item: Shown alongside the permalink on the edit post screen. search_items: Button text for the search box on the edit posts screen. not_found: Text to display when no posts are found through search in the admin. not_found_in_trash: Text to display when no posts are in the trash. parent: Used as a label for a parent post on the edit posts screen. Only useful for hierarchical post types. Ref: http://justintadlock.com/archives/2010/04/29/custom-post-types-in-wordpress 17. Additional Arguments:labels register_post_type('zombies',array( 'labels' => array( 'name' => 'Zombies', 'singular_name' => 'Zombie', 'add_new' => 'Add New Zombie', 'add_new_item' => 'Add New Zombie', 'edit' => 'Edit Zombies', 'edit_item' => 'Edit Zombie', 'new_item' => 'New Zombie', 'view' => 'View Zombie', 'view_item' => 'View Zombie', 'search_items' => 'Search Zombies', 'not_found' => 'No zombies found', 'not_found_in_trash' => 'No zombies found in Trash', 'parent' => 'Parent Zombie', ), 'public' => true, )); An array of strings that represent your post type in the WP admin 18. Additional Arguments:labels The Result 19. Additional Arguments:supports Defines what meta boxes and other fields appear on the edit screen title: Text input field for the post title. editor: Main content meta box comments: Ability to turn comments on/off. trackbacks: Ability to turn trackbacks and pingbacks on/off. revisions: Allows revisions to be made of your post. author: Displays the post author select box. excerpt: A textarea for writing a custom excerpt. thumbnail: The post thumbnail (featured imaged) upload box. custom-fields: Custom fields input area. page-attributes: The attributes box shown for pages. Important for hierarchical post types, so you can select the parent post. 20. Additional Arguments:supports Defines what meta boxes and other fields appear on the edit screen register_post_type('zombies',array( 'labels' => array( 'name' => 'Zombies', 'singular_name' => 'Zombie', 'add_new' => 'Add New Zombie', 'add_new_item' => 'Add New Zombie', 'edit' => 'Edit Zombies', 'edit_item' => 'Edit Zombie', 'new_item' => 'New Zombie', 'view' => 'View Zombie', 'view_item' => 'View Zombie', 'search_items' => 'Search Zombies', 'not_found' => 'No zombies found', 'not_found_in_trash' => 'No zombies found in Trash', 'parent' => 'Parent Zombie', ), 'supports' => array('title'), 'public' => true, )); 21. Additional Arguments:supports Defines what meta boxes and other fields appear on the edit screen Only the Title and Publish meta boxes are displayed 22. Additional Arguments:supports Now lets activate all meta boxes register_post_type('zombies',array( 'labels' => array( 'name' => 'Zombies', 'singular_name' => 'Zombie', 'add_new' => 'Add New Zombie', 'add_new_item' => 'Add New Zombie', 'edit' => 'Edit Zombies', 'edit_item' => 'Edit Zombie', 'new_item' => 'New Zombie', 'view' => 'View Zombie', 'view_item' => 'View Zombie', 'search_items' => 'Search Zombies', 'not_found' => 'No zombies found', 'not_found_in_trash' => 'No zombies found in Trash', 'parent' => 'Parent Zombie', ), 'supports' => array('title,'editor,'excerpt, 'trackbacks,'custom-fields', 'comments,'revisions,'thumbnail,'author,'page-attributes'), 'public' => true, )); 23. Additional Arguments:supports Now all meta boxes are displayed on the Zombie edit screen 24. Additional Arguments:rewrite Defines the permalink structure of your custom post type posts slug: The slug to use in your permalink structure with_front: whether your post type should use the front base from your permalink settings (eg /blog) 'rewrite' => array('slug' => 'zombie') Example: BEFORE AFTER 25. Additional Arguments:taxonomies Add preexisting taxonomies to your custom post type 'taxonomies' => array( 'post_tag', 'category') Example: 26. Additional Arguments:misc Below are additional arguments for creating custom post types hierarchical: whether the post type is hierarchical description: a text description of your custom post type show_ui: whether to show the admin menus/screens menu_position: Set the position of the menu order where the post type should appear menu_icon: URL to the menu icon to be used exclude_from_search: whether post type content should appear in search results 27. Putting it all together register_post_type('zombies',array( 'description' => 'Zombie custom post type', 'show_ui' => true, 'menu_position' => 5, 'menu_icon' => get_stylesheet_directory_uri() . '/images/zombies.png', 'exclude_from_search' => false, 'labels' => array( 'name' => 'Zombies', 'singular_name' => 'Zombie', 'add_new' => 'Add New Zombie', 'add_new_item' => 'Add New Zombie', 'edit' => 'Edit Zombies', 'edit_item' => 'Edit Zombie', 'new_item' => 'New Zombie', 'view' => 'View Zombie', 'view_item' => 'View Zombie', 'search_items' => 'Search Zombies', 'not_found' => 'No zombies found', 'not_found_in_trash' => 'No zombies found in Trash', 'parent' => 'Parent Zombie', ), 'supports' => array('title','editor','excerpt', 'trackbacks','custom-fields', 'comments','revisions','thumbnail','author','page-attributes'), 'public' => true, 'rewrite' => array('slug' => 'zombie', 'with_front' => false), 'taxonomies' => array( 'post_tag', 'category') )); 28. So what are Taxonomies? 29. So what are Taxonomies? ENGLISH : Taxonomies are a way to group similar items together 30. Default WordPress Taxonomies:

Category

Link Category

31. Example Time! Tweet: @williamsba ZOMBIES IN AREA! RUN #wcraleigh Win a copy of Professional WordPress! 32. Example: Zombie Modeling Agency Drop the below code in your themes functions.php file Non-hierarchical Taxonomy 33. Example: Zombie Modeling Agency New custom taxonomy is automatically added to the Zombies post type menu The Freshness meta box is also automatically added to the Zombie edit screen automatically! 34. Example: Zombie Modeling Agency Drop the below code in your themes functions.php file Hierarchical Taxonomy 35. Example: Zombie Modeling Agency New custom taxonomy is automatically added to the Zombies post type menu The Freshness meta box is also automatically added to the Zombie edit screen automatically! 36. Example: Zombie Modeling Agency Lets break it down:

Action hook to trigger our function

Execute the register_taxonomy function defining freshness as our custom taxonomy

Set the name to freshness

Set the object type to zombies.Must be an existing post type

Set hierarchical to false

Set our taxonomy label to Freshness

37. Additional Arguments: labels An array of strings that represent your taxonomy in the WP admin name: The general name of your taxonomy singular_name: The singular form of the name of your taxonomy. search_items: The search items text popular_items: The popular items text all_items: The all items text parent_item: The parent item text.Only used on hierarchical taxonomies parent_item_colon: Same as parent_item, but with a colon edit_item: The edit item text update_item: The update item text add_new_item: The add new item text new_item_name: The new item name text 38. Additional Arguments: labels register_taxonomy('freshness','zombies', array('labels' => array( 'name' => 'Freshness', 'singular_name' => 'Freshness', 'search_items' =>'Search Freshness', 'popular_items' => 'Popular Freshness', 'all_items' => 'All Freshness', 'parent_item' => 'Parent Freshness', 'parent_item_colon' => 'Parent Freshness:', 'edit_item' => 'Edit Freshness','update_item' => 'Update Freshness', 'add_new_item' => 'Add New Freshness', 'new_item_name' => 'New Freshness Name' ),'hierarchical' => false,'label' => 'Freshness' )); An array of strings that represent your taxonomy in the WP admin 39. Additional Arguments: labels The Result 40. Additional Arguments: rewrite Defines the permalink structure for your custom taxonomy slug: The slug to use in your permalink structure with_front: whether your taxonomy should use the front base from your permalink settings (eg /blog) 'rewrite' => array('slug' => fresh') Example: BEFORE AFTER http://x.webdevstudios.com/blog/freshness/ripe/ http://x.webdevstudios.com/blog/fresh/ripe/ 41. Additional Arguments: misc Below are additional arguments for creating custom taxonomies public: whether the taxonomy is publicly queryable show_ui: whether to display the admin UI for the taxonomy hierarchical: whether the taxonomy is hierarchical.Categories are hierarchical, tags are not. label: the name of your taxonomy in the admin dashboard query_var: whether to be able to query posts using the taxonomy.rewrite: whether to use a pretty permalink when viewing the taxonomy page. show_tagcloud: whether to show a tag cloud in the admin UI 42. Putting it all together register_taxonomy('freshness','zombies', array('labels' => array( 'name' => 'Freshness', 'singular_name' => 'Freshness', 'search_items' =>'Search Freshness', 'popular_items' => 'Popular Freshness', 'all_items' => 'All Freshness', 'parent_item' => 'Parent Freshness', 'parent_item_colon' => 'Parent Freshness:', 'edit_item' => 'Edit Freshness','update_item' => 'Update Freshness', 'add_new_item' => 'Add New Freshness', 'new_item_name' => 'New Freshness Name' ),'hierarchical' => false,'public' => true, 'show_ui' => true, 'query_var' => 'freshness', 'show_tagcloud' => true, 'rewrite' => array( 'slug' => 'fresh', 'with_front' => false ))); 43. 44. Displaying in WordPress#protip 45. Displaying Custom Post Type Content By default custom post type content will NOT display in the Loop Placing the above code directly before the Loop will only display our zombies 46. Displaying Custom Post Type Content BEFORE ZOMBIED (After) 47. Custom Loop

Creating a custom Loop for your post type 48. Function: get_post_type() Returns the post type of the content you are viewing Custom Post Type Functions http://codex.wordpress.org/Function_Reference/get_post_type 49. if ( is_post_type( 'zombies' ) ) { echo 'Zombies Exist!'; } Function: is_post_type() Check if a post type exists Custom Post Type Functions if ( is_post_type( 'zombies' $post_id) ) { echo Post ID: .$post_id .is a Zombie!'; } Can also check a specific post against a post type 50. Function: get_the_term_list() Display freshness taxonomy for our zombies Custom Taxonomy Functions http://codex.wordpress.org/Function_Reference/get_the_term_list 51. Recommended Plugin 52. Custom Post Type UI http://wordpress.org/extend/plugins/custom-post-type-ui/ Easily create custom post types without writing code! 53. Custom Post Type UI http://wordpress.org/extend/plugins/custom-post-type-ui/ Also easily create custom taxonomies without writing code! 54. Custom Post Type UI http://wordpress.org/extend/plugins/custom-post-type-ui/ Plugin also gives you the PHP code for custom post types and taxonomies! 55.

Custom Post Types and Taxonomies in WordPress

Documents

Transcript of Custom Post Types and Taxonomies in WordPress