{"id":3600,"date":"2017-08-14T09:36:51","date_gmt":"2017-08-14T16:36:51","guid":{"rendered":"https:\/\/scottdeluzio.com\/?p=3600"},"modified":"2017-08-14T09:39:18","modified_gmt":"2017-08-14T16:39:18","slug":"intro-wordpress-plugin-development-register-custom-post-types","status":"publish","type":"post","link":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/","title":{"rendered":"Intro to WordPress Plugin Development: Register Custom Post Types"},"content":{"rendered":"<div class=\"seriesmeta\">This entry is part 5 of 12 in the series <a href=\"https:\/\/scottdeluzio.com\/series\/intro-to-wordpress-plugin-development\/\" class=\"series-25\" title=\"Intro to WordPress Plugin Development\">Intro to WordPress Plugin Development<\/a><\/div><p>So far in the Intro to WordPress Plugin Development series, we&#8217;ve talked about properly formatting code, and how to use filters and actions. Next, we&#8217;ll look at creating our own custom post type.<\/p>\n<h2>What are WordPress custom post types?<\/h2>\n<p>WordPress comes with several different post types, like posts and pages. Since WordPress started off as a blogging platform, the name &#8220;post&#8221; sort of stuck, but a custom post type might more accurately be called a custom content type. Regardless of the name, a custom post type refers to different types of content.<\/p>\n<p>Technically, you don&#8217;t really need to use a custom post type. You could categorize your content using the built-in categories or tags. However, some content doesn&#8217;t need a full-blown text editor like posts have. Some content may require custom fields that shouldn&#8217;t be made available to other post types.<\/p>\n<p>Let&#8217;s look at some examples of when a custom post type might make sense.<\/p>\n<ul>\n<li>Content that doesn&#8217;t need to be listed in a chronological order like posts are can be made into a custom post type. For example, a list of sports teams doesn&#8217;t need to be displayed in chronological order along with your blog post.<\/li>\n<li>Content that requires additional fields might be made into a custom post type. For example, a &#8220;book&#8221; custom post type might have custom fields like author, published date, ISBN, rating, etc.<\/li>\n<li>Content that shouldn&#8217;t be visible publically on the site can be made into a custom post type. Custom post types have a setting that enables the content to be publically visible. If you have some information that you only want visible to administrators on your site via the dashboard, you can turn off the public visibility for this content.<\/li>\n<\/ul>\n<h2>Let&#8217;s build a custom post type<\/h2>\n<p>We&#8217;re going to use the example of a sports team custom post type. This can be useful for anything from a town&#8217;s Little League website, to a pro-sports news site.<\/p>\n<p>To add our custom post type we&#8217;ll use the function <a href=\"https:\/\/codex.wordpress.org\/Function_Reference\/register_post_type\" target=\"_blank\">register_post_type()<\/a>. In the WordPress codex, it says that this function should only called with the <code>init<\/code> action. If you remember the previous lesson on using actions, you might be able to guess why.<\/p>\n<p>Any call to <code>register_post_type()<\/code> before the init action runs will not work. Any call to it after the init action runs may not work correctly. Basically, WordPress is telling us that the <code>init<\/code> action is the right place for this function to run.<\/p>\n<pre lang=\"php\">\r\nfunction team_cpt_new_post_type(){\r\n\tregister_post_type(\r\n\t\t'teams',\r\n\t\tarray(\r\n\t\t\t'labels'\t=> array(\r\n\t\t\t\t'name'\t\t\t=> __( 'Teams' ),\r\n\t\t\t\t'singular_name'\t\t=> __( 'Team' )\r\n\t\t\t),\r\n\t\t\t'public' \t\t=> true,\r\n\t\t\t'has_archive' \t\t=> true,\r\n\t\t\t'rewrite' \t\t=> array(\r\n\t\t\t\t'slug'\t=> 'teams',\r\n\t\t\t),\r\n\t\t\t'supports' \t\t=> array(\r\n\t\t\t\t'title',\r\n\t\t\t\t'editor',\r\n\t\t\t),\r\n\t\t)\r\n\t);\r\n}\r\nadd_action( 'init', 'team_cpt_new_post_type' );\r\n<\/pre>\n<p>What this code does is it registers a post type &#8216;teams&#8217; with a series of arguments. These arguments tell our custom post type what it can and can&#8217;t do. <\/p>\n<p>The first argument is <code>labels<\/code>, which defines the words we see on the screen when referring to this post type. In this case, we see &#8220;Teams&#8221; when referring to several of this post type, and &#8220;Team&#8221; when referring to one of them.<\/p>\n<p>The second argument is <code>public<\/code>, which dictates whether or not this post type is available on the front end of the site.<\/p>\n<p>The third argument is <code>has_archive<\/code>, which tells WordPress if this post type should have an archive page, similar to your main blog page for your posts.<\/p>\n<p>The fourth argument is <code>rewrite<\/code>. This tells WordPress what to use in the URL when accessing posts of this type. For example, your site might access a &#8220;team&#8221; post at http:\/\/example.com\/teams\/boston-red-sox<\/p>\n<p>The fifth argument is <code>supports<\/code>. This indicates what features we need our custom post type to have. The title and editor arguments should be familiar to you. These enable the post&#8217;s title and the main editor field.<\/p>\n<p>There are <a href=\"https:\/\/codex.wordpress.org\/Function_Reference\/register_post_type#Arguments\" target=\"_blank\">a lot of other arguments<\/a> you can use for your post type, but this is the basics.<\/p>\n<h2>Add content to our custom post type<\/h2>\n<p>Now, adding content to our new custom post type is just as easy as writing a new blog post. The difference is that the content won&#8217;t appear on the blog page. It will now appear in our newly created &#8220;Teams&#8221; page, which would be located at http:\/\/example.com\/teams\/<\/p>\n","protected":false},"excerpt":{"rendered":"<div class=\"seriesmeta\">This entry is part 5 of 12 in the series <a href=\"https:\/\/scottdeluzio.com\/series\/intro-to-wordpress-plugin-development\/\" class=\"series-25\" title=\"Intro to WordPress Plugin Development\">Intro to WordPress Plugin Development<\/a><\/div><div class=\"seriesmeta\">This entry is part 5 of 12 in the series <a href=\"https:\/\/scottdeluzio.com\/series\/intro-to-wordpress-plugin-development\/\" class=\"series-25\" title=\"Intro to WordPress Plugin Development\">Intro to WordPress Plugin Development<\/a><\/div>\n<p>So far in the Intro to WordPress Plugin Development series, we&#8217;ve talked about properly formatting code, and how to use filters and actions. Next, we&#8217;ll look at creating our own custom post type. What are WordPress custom post types? WordPress comes with several different post types, like posts and pages. Since WordPress started off as [&hellip;]<\/p>\n","protected":false},"author":2,"featured_media":3668,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_genesis_hide_title":false,"_genesis_hide_breadcrumbs":false,"_genesis_hide_singular_image":false,"_genesis_hide_footer_widgets":false,"_genesis_custom_body_class":"","_genesis_custom_post_class":"","_genesis_layout":"","footnotes":""},"categories":[24],"tags":[],"series":[25],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v22.6 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Intro to WordPress Plugin Development: Register Custom Post Types - Scott DeLuzio<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Intro to WordPress Plugin Development: Register Custom Post Types - Scott DeLuzio\" \/>\n<meta property=\"og:description\" content=\"So far in the Intro to WordPress Plugin Development series, we&#8217;ve talked about properly formatting code, and how to use filters and actions. Next, we&#8217;ll look at creating our own custom post type. What are WordPress custom post types? WordPress comes with several different post types, like posts and pages. Since WordPress started off as [&hellip;]\" \/>\n<meta property=\"og:url\" content=\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/\" \/>\n<meta property=\"og:site_name\" content=\"Scott DeLuzio\" \/>\n<meta property=\"article:published_time\" content=\"2017-08-14T16:36:51+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2017-08-14T16:39:18+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png\" \/>\n\t<meta property=\"og:image:width\" content=\"1024\" \/>\n\t<meta property=\"og:image:height\" content=\"512\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"author\" content=\"Scott DeLuzio\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@scottdeluzio\" \/>\n<meta name=\"twitter:site\" content=\"@scottdeluzio\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Scott DeLuzio\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/\",\"url\":\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/\",\"name\":\"Intro to WordPress Plugin Development: Register Custom Post Types - Scott DeLuzio\",\"isPartOf\":{\"@id\":\"https:\/\/scottdeluzio.com\/#website\"},\"primaryImageOfPage\":{\"@id\":\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#primaryimage\"},\"image\":{\"@id\":\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#primaryimage\"},\"thumbnailUrl\":\"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png\",\"datePublished\":\"2017-08-14T16:36:51+00:00\",\"dateModified\":\"2017-08-14T16:39:18+00:00\",\"author\":{\"@id\":\"https:\/\/scottdeluzio.com\/#\/schema\/person\/a0578da297e094ef0d581122331b5360\"},\"breadcrumb\":{\"@id\":\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/\"]}]},{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#primaryimage\",\"url\":\"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png\",\"contentUrl\":\"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png\",\"width\":1024,\"height\":512,\"caption\":\"WordPress Plugin Register Custom Post Types\"},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/scottdeluzio.com\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Intro to WordPress Plugin Development: Register Custom Post Types\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/scottdeluzio.com\/#website\",\"url\":\"https:\/\/scottdeluzio.com\/\",\"name\":\"Scott DeLuzio\",\"description\":\"WordPress Development Tutorials\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/scottdeluzio.com\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"en-US\"},{\"@type\":\"Person\",\"@id\":\"https:\/\/scottdeluzio.com\/#\/schema\/person\/a0578da297e094ef0d581122331b5360\",\"name\":\"Scott DeLuzio\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/scottdeluzio.com\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/secure.gravatar.com\/avatar\/1aab25f8a9570a61b20078bcb4ab4588?s=96&d=mm&r=g\",\"contentUrl\":\"https:\/\/secure.gravatar.com\/avatar\/1aab25f8a9570a61b20078bcb4ab4588?s=96&d=mm&r=g\",\"caption\":\"Scott DeLuzio\"},\"sameAs\":[\"https:\/\/x.com\/scottdeluzio\"],\"url\":\"https:\/\/scottdeluzio.com\/author\/scottdeluzio82\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Intro to WordPress Plugin Development: Register Custom Post Types - Scott DeLuzio","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/","og_locale":"en_US","og_type":"article","og_title":"Intro to WordPress Plugin Development: Register Custom Post Types - Scott DeLuzio","og_description":"So far in the Intro to WordPress Plugin Development series, we&#8217;ve talked about properly formatting code, and how to use filters and actions. Next, we&#8217;ll look at creating our own custom post type. What are WordPress custom post types? WordPress comes with several different post types, like posts and pages. Since WordPress started off as [&hellip;]","og_url":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/","og_site_name":"Scott DeLuzio","article_published_time":"2017-08-14T16:36:51+00:00","article_modified_time":"2017-08-14T16:39:18+00:00","og_image":[{"width":1024,"height":512,"url":"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png","type":"image\/png"}],"author":"Scott DeLuzio","twitter_card":"summary_large_image","twitter_creator":"@scottdeluzio","twitter_site":"@scottdeluzio","twitter_misc":{"Written by":"Scott DeLuzio","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/","url":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/","name":"Intro to WordPress Plugin Development: Register Custom Post Types - Scott DeLuzio","isPartOf":{"@id":"https:\/\/scottdeluzio.com\/#website"},"primaryImageOfPage":{"@id":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#primaryimage"},"image":{"@id":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#primaryimage"},"thumbnailUrl":"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png","datePublished":"2017-08-14T16:36:51+00:00","dateModified":"2017-08-14T16:39:18+00:00","author":{"@id":"https:\/\/scottdeluzio.com\/#\/schema\/person\/a0578da297e094ef0d581122331b5360"},"breadcrumb":{"@id":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#primaryimage","url":"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png","contentUrl":"https:\/\/scottdeluzio.com\/wp-content\/uploads\/2017\/08\/register-cpt.png","width":1024,"height":512,"caption":"WordPress Plugin Register Custom Post Types"},{"@type":"BreadcrumbList","@id":"https:\/\/scottdeluzio.com\/intro-wordpress-plugin-development-register-custom-post-types\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/scottdeluzio.com\/"},{"@type":"ListItem","position":2,"name":"Intro to WordPress Plugin Development: Register Custom Post Types"}]},{"@type":"WebSite","@id":"https:\/\/scottdeluzio.com\/#website","url":"https:\/\/scottdeluzio.com\/","name":"Scott DeLuzio","description":"WordPress Development Tutorials","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/scottdeluzio.com\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"en-US"},{"@type":"Person","@id":"https:\/\/scottdeluzio.com\/#\/schema\/person\/a0578da297e094ef0d581122331b5360","name":"Scott DeLuzio","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/scottdeluzio.com\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/1aab25f8a9570a61b20078bcb4ab4588?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/1aab25f8a9570a61b20078bcb4ab4588?s=96&d=mm&r=g","caption":"Scott DeLuzio"},"sameAs":["https:\/\/x.com\/scottdeluzio"],"url":"https:\/\/scottdeluzio.com\/author\/scottdeluzio82\/"}]}},"_links":{"self":[{"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/posts\/3600"}],"collection":[{"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/comments?post=3600"}],"version-history":[{"count":0,"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/posts\/3600\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/media\/3668"}],"wp:attachment":[{"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/media?parent=3600"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/categories?post=3600"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/tags?post=3600"},{"taxonomy":"series","embeddable":true,"href":"https:\/\/scottdeluzio.com\/wp-json\/wp\/v2\/series?post=3600"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}