SuperCPT

Lastly, if you’ve built a lot of custom post types, you’re probably sick and tired of the pushpin icon. SuperCPT comes with 350 gorgeous icons courtesy of Font Awesome that are extremely easy to implement. Here’s what it looks like:

$movies->set_icon( 'film' );

Custom Taxonomies

To define a new Custom Taxonomy, much like with Custom Post Types, you instantiate Super_Custom_Taxonomy with a string for the term name. For example:

$actors = new Super_Custom_Taxonomy( 'actor' );

Again, we got free labels for doing this, using either ‘Actor’ or ‘Actors’ as appropriate, without needing to specify the 16 labels individually.

Custom Post Meta

Custom Post Meta is where SuperCPT shines the brightest, because this process is typically the most time-consuming. Super_Custom_Post_Meta is a free-standing class that can be added to any post type, even built-in post types (posts and pages). This class has a method add_meta_box which does the bulk of the work, and somewhat mimics the WordPress function. Here’s an example:

$movies->add_meta_box( array( 'id' => 'features', 'fields' => array( 'tagline' => array( 'type' => 'text' ) ) ) );

The method add_meta_box takes an array of parameters (unlike the core function which takes normal ordered arguments). id is the only required attribute, and that becomes the ID of the meta box as well as the title (this will get converted into “words” for the title, e.g. "movie_details" would become “Movie Details”). fields is an array of all the fields in the meta box. It’s an associative array, where the keys in the array are the field names and the values are another associative array of attributes for the field. The keys closely reflect the HTML attributes in the resulting field, and any key not known by the plugin will in fact become an HTML attribute (e.g. passing 'data-src' => 'foo' would become the HTML attribute data-src="foo" in the field). See the reference for the full gamut of options, both for the add_meta_box argument array and the fields array.

Long story short, using this class means you don’t have to do any additional work to store data, retrieve data, style the boxes, and so on.

Helper Functions

SuperCPT has a couple of helper functions for displaying your post meta. get_scpt_formatted_meta and the_scpt_formatted_meta

Demo Code

Here is the full demo code:

function scpt_demo() { if ( ! class_exists( 'Super_Custom_Post_Type' ) ) return; $demo_posts = new Super_Custom_Post_Type( 'demo-post' ); # Test Icon. Should be a square grid. $demo_posts->set_icon( 'th-large' ); # Taxonomy test, should be like tags $tax_tags = new Super_Custom_Taxonomy( 'tax-tag' ); # Taxonomy test, should be like categories $tax_cats = new Super_Custom_Taxonomy( 'tax-cat', 'Tax Cat', 'Tax Cats', 'category' ); # Connect both of the above taxonomies with the post type connect_types_and_taxes( $demo_posts, array( $tax_tags, $tax_cats ) ); # Add a meta box with every field type $demo_posts->add_meta_box( array( 'id' => 'demo-fields', 'context' => 'normal', 'fields' => array( 'textbox-demo' => array(), 'textarea-demo' => array( 'type' => 'textarea' ), 'wysiwyg-demo' => array( 'type' => 'wysiwyg' ), 'boolean-demo' => array( 'type' => 'boolean' ), 'checkboxes-demo' => array( 'type' => 'checkbox', 'options' => array( 'one', 'two', 'three' ) ), 'radio-buttons-demo' => array( 'type' => 'radio', 'options' => array( 'one', 'two', 'three' ) ), 'select-demo' => array( 'type' => 'select', 'options' => array( 1 => 'one', 2 => 'two', 3 => 'three' ) ), 'multi-select-demo' => array( 'type' => 'select', 'options' => array( 'one', 'two', 'three' ), 'multiple' => 'multiple' ), 'date-demo' => array( 'type' => 'date' ), 'label-override-demo' => array( 'label' => 'Label Demo' ) ) ) ); # Add another CPT to test one-to-one (it could just as easily be one-to-many or many-to-many) $linked_posts = new Super_Custom_Post_Type( 'linked-post', 'Other Post', 'Other Posts' ); $linked_posts->add_meta_box( array( 'id' => 'one-to-one', 'title' => 'Testing One-to-One relationship', 'context' => 'side', 'fields' => array( 'demo-posts' => array( 'type' => 'select', 'data' => 'demo-post' ), 'side-wysiwyg' => array( 'type' => 'wysiwyg' ) ) ) ); $linked_posts->set_icon( 'cogs' ); } add_action( 'after_setup_theme', 'scpt_demo' );<h3>To-Do</h3>

1. Add better support for multiple fields for one meta key 2. Add easy RSS feeds, e.g. in fields array, a parameter might be 'rss' => 'PubDate' to prefer that field’s data over the post’s publication date.