Mastering WordPress Custom Post Types - WordCamp Atlanta 2012

416style

/* Theme Name: Mike's Theme Description: Child Theme of Twenty
Eleven Template: twentyeleven */ @import url("../twentyeleven/style.css");

<?php /* * functions.php for mikes_theme * */

Add a Custom Post Type Called "Comics"

<?php /* * functions.php for mikes_theme * */ register_post_type( 'comic'
);

<?php add_action( 'init', 'mikes_theme_init' ); function mikes_theme_init() { register_post_type( 'comic'
); }

function mikes_theme_init() { register_post_type( 'comic', array( 'public' => true, ));
} But!

function mikes_theme_init() { register_post_type( 'comic', array( 'public' => true, 'label'
=> 'Comics', )); } Now!

=> 'Comics', 'rewrite' => array( 'with_front' => false, ), )); } Better, but quite right:

=> 'Comics', 'rewrite' => array( 'with_front' => false, 'slug' => 'comics', ), )); } Perfecto!

Add a Custom Form (a "Metabox") and Custom Fields

add_action('add_meta_boxes','mikes_theme_add_meta_boxes'); function mikes_theme_add_meta_boxes( $post_type ) { if ( 'comic' ==
$post_type ) add_meta_box( 'comic_info_box', // $id 'Comic Information', // $title 'mikes_theme_comic_meta_box', // $callback 'comic', // $page, 'normal', // $context, 'high' ); // $priority }

add_action( 'save_post', 'mikes_theme_save_post'); function mikes_theme_save_post( $post_id ) { if (
'comic' == $post_type ) { update_post_meta($post_id,'_cartoonist',$_POST['cartoonist']); update_post_meta($post_id,'_since',$_POST['since']); update_post_meta($post_id,'_website',$_POST['website']); } } Note the leading underscores on the post meta 'key' names (2nd parameter)

function mikes_theme_comic_meta_box( $post ) { $cartoonist = get_post_meta( $post->ID, '_cartoonist',
true ); $since = get_post_meta( $post->ID, '_since', true ); $website = get_post_meta( $post->ID, '_website', true ); $html =<<<HTML <table>

Create a Theme Template File for a Custom Post Type

<?php //Template for displaying single Comic Post Type. get_header(); if
( have_posts() ): the_post(); ?> <div id="content"> <div id="post-<?php the_ID(); ?>" <?php post_class(); ?>> <h1 class="entry-title"><?php the_title(); ?></h1> Cartoonist: <?php echo get_post_meta( $post->ID, '_cartoonist', true); ?> <br/> Since: <?php echo get_post_meta( $post->ID, '_since', true ); ?> <br/> Website: <?php echo get_post_meta( $post->ID, '_website', true ); ?> <br/><br/> <?php the_content(); ?> </div> </div> <?php endif; get_footer(); ?>

Add Admin Columns for your Custom Post Type

add_filter( 'manage_edit-comic_columns', 'mikes_theme_manage_edit_comic_columns' ); function mikes_theme_manage_edit_comic_columns( $columns ) { $columns['cartoonist']
= 'Cartoonist'; $columns['website'] = 'Website'; return $columns; }

add_filter( 'manage_comic_posts_custom_column', 'mikes_theme_manage_comic_posts_custom_column', 10, 2 ); function mikes_theme_manage_comic_posts_custom_column( $column_name, $post_id
) { switch ( $column_name ) { case 'cartoonist': echo get_post_meta( $post_id, "_cartoonist", true ); break; case 'website': $website = get_post_meta( $post_id, "_website", true ); $domain = trim( str_replace( 'http://', '', $website ), '/' ); echo "<a href=\"{$website}\">{$domain}</a>"; break; } }

Adding a Custom Taxonomy to a Post Type

function mikes_theme_init() { ... ... register_taxonomy( 'art-style', 'comic', array( 'hierarchical'
=> true, 'label' => 'Art Styles', 'rewrite' => array( 'slug' => 'art-styles', 'with_front' => false ), ));

Configure Post Edit Screens (including Posts and Pages)

function mikes_theme_init() { ... ... register_post_type( 'episode', array( 'label' =>
'Episodes', 'public' => true, 'rewrite' => array( 'slug' =>'episodes', 'with_front' => false ), 'supports' => array( 'title', 'thumbnail', 'excerpt' ), ));

Parent Post Field in a Post Editor Metabox (useful for
non-same post types)

Querying Custom Post Types

function mikes_theme_episode_meta_box( $post ) { $select_html = mikes_theme_comic_dropdown( $post->post_parent );
$html =<<<HTML <table> <tr> <th><label for="parent_id">Comic:</label></th> <td>{$select_html}</td> </tr> </table> HTML; echo $html; }

Hierarchical URLs for Custom Post Types

add_rewrite_rule( '^comics/([^/]*)/([^/]*)/?', 'index.php?post_type=episode&comic_qv=$matches[1]&episode_qv=$matches[2]', 'top' ); register_post_type( 'comic', array( ... 'query_var'
=> 'comic_qv', ... )); register_post_type( 'episode', array( ... 'query_var' => 'episode_qv', ... ));

add_action( 'post_type_link', 'mikes_theme_post_type_link', 10, 4 ); function mikes_theme_post_type_link( $link, $post,
$leavename, $sample ) { if ( 'episode' == $post->post_type ) { $parent = get_post( $post->post_parent ); $comic_slug = isset( $parent->post_name ) ? $parent->post_name ' : '%comic%'; $episode_slug = $sample ? '%postname%' : $post->post_name; $link = preg_replace( '#^(https?://[^/]+/).*$#', "$1comics/{$comic_slug}/{$episode_slug}/", $link ); } return $link; }

add_action( 'request', 'mikes_theme_request' ); function mikes_theme_request( $query_vars ) { global
$wp; if ( ! is_admin() && isset( $query_vars['post_type'] ) && 'episode' == $query_vars['post_type'] ) { $comic = get_page_by_path( $query_vars['comic_qv'], OBJECT, 'comic' ); $episode_query = new WP_Query( array( 'name' => $query_vars['episode_qv'], 'post_type' => 'episode', 'fields' => 'ids', 'post_parent' => $comic->ID, 'posts_per_page' => 1, 'suppress_filters' => true, )); if ( 0 == count( $episode_query->posts ) ) { $query_vars = array( 'error' => '404' ); } } return $query_vars; }

<?php get_header(); if ( have_posts() ): the_post(); ?> <div id="content">
<div id="post-<?php the_ID(); ?>" <?php post_class(); ?>> <?php edit_post_link( 'Edit', '<div class="edit-link">', '</div>' ); ?> <?php previous_post_link( '%link', '<<<Previous' ); ?> <?php next_post_link( '%link', 'Next&gt&gt>' ); ?> <h2 class="entry-parent">Comic: <?php echo get_the_title( $post->post_parent ); ? ></h2> <h1 class="entry-title"><?php the_title(); ?></h1> <?php the_content(); ?> <?php if ( has_post_thumbnail( $post->ID ) ) $image_html = wp_get_attachment_image_src( get_post_thumbnail_id( $post->ID ), 'single-post-thumbnail' ); ?> <img src="<?php echo $image_html[0]; ?>"> </div> </div> <?php endif; get_footer(); ?>

Custom Post Type Filters in Admin Post List

add_action( 'restrict_manage_posts', 'mikes_theme_restrict_manage_posts' ); function mikes_theme_restrict_manage_posts() { $comic_id = empty(
$_GET['comic_id'] ) ? 0 : $_GET['comic_id']; echo 'Comic: ' . mikes_theme_comic_dropdown( $comic_id, 'comic_id' ); } add_filter('pre_get_posts','mikes_theme_pre_get_posts'); function mikes_theme_pre_get_posts( $query ) { global $pagenow, $typenow, $wp_the_query; if ( 'edit.php' == $pagenow && 'episode' == $typenow && $query === $wp_the_query && ! empty( $_GET['comic_id'] ) ) { $query->set( 'post_parent', intval( $_GET['comic_id'] ) ); } }

You can do practically anything you put your mind to
with WordPress' CPTs and a little PHP!

There's More…

Mastering WordPress Custom Post Types - WordCam...

Mastering WordPress Custom Post Types - WordCamp Atlanta 2012

Other Decks in Programming

Featured

Transcript