Matthew Boynes

Union Street Media

<h4>UPGRADE NOTICE</h4>
<p>SuperCPT now uses Font Awesome instead of Glyphicons. Some icon names will carry over, but not all. If this is a considerable inconvenience for you for a project, simply do not update it. It’s not a security release, so updating isn’t necessary.</p>
<h4>Overview</h4>
<p>SuperCPT is an object wrapper for Custom Post Types, Custom Taxonomies, and Custom Post Meta “for coders, by coders.” Simply put, SuperCPT:</p>
<ul>
<li>DRYs up the Custom Post Type and Custom Taxonomy process (e.g. automatically adds the name to all the labels),</li>
<li>allows you to set default options for all your Custom Post Types and Taxonomies,</li>
<li>significantly simplifies the process of creating, saving, and displaying Custom Post Meta,</li>
<li>is sexy! Your custom fields are styled to look great and SuperCPT comes with 361 awesome icons courtesy of <a href="http://fontawesome.io/" rel="nofollow ugc">Font Awesome</a>.</li>
</ul>
<h4>Demo Video</h4>
<div class="embed-vimeo" style="text-align: center;"><iframe loading="lazy" src="https://player.vimeo.com/video/59368054" width="750" height="422" frameborder="0" webkitallowfullscreen mozallowfullscreen allowfullscreen></iframe></div>
<h4>TextMate/Sublime Text 2 Bundle</h4>
<p>If you use TextMate, Sublime Text 2, or another editor which supports TextMate bundles, check out <a href="https://github.com/mboynes/super-cpt-bundle" rel="nofollow ugc">this set of snippets</a> to turbo-charge your development.</p>
<h4>And more…</h4>
<p>See the <a href="https://wordpress.org/extend/plugins/super-cpt/other_notes/" rel="ugc">Other Notes tab</a> for instructions and demo code. Find more demos and a full reference <a href="https://github.com/mboynes/super-cpt/wiki" rel="nofollow ugc">at GitHub</a>.</p>
<p>Since you’re a hard-core coder, <a href="https://github.com/mboynes/super-cpt" rel="nofollow ugc">check this out on GitHub</a> if you want to contribute!</p>
<h3>Instructions</h3>
<p>Depending on when and where you’re declaring your Custom Post Types and Taxonomies, you have different options for which action to hook onto. <code>after_setup_theme</code> is the safest bet, but if you’re referencing this in another plugin, <code>plugins_loaded</code> is a good choice. To avoid a fatal error if something goes awry, you should check to see if the class <code>Super_Custom_Post_Type</code> exists before referencing it. Don’t worry about keeping up, reference code is below.</p>
<h4>Custom Post Types</h4>
<p>To define a new Custom Post Type, instantiate the <code>Super_Custom_Post_Type</code> class with a string for the post type. For example,</p>
<pre><code>$movies = new Super_Custom_Post_Type( 'movie' );
</code></pre>
<p>It works very much like <a href="https://codex.wordpress.org/Function_Reference/register_post_type" rel="nofollow ugc"><code>register_post_type</code></a>. The first thing you gained by using this is that the labels all got setup with either ‘Movie’ or ‘Movies’. If our post type were ‘indie-film’, the labels would have “Indie Film” and “Indie Films” as appropriate. Of course, you do have the ability to set the plural word in cases such as goose/geese. You also gained the ability to define your own custom post type defaults through a filter. Lastly, you gained access to <code>Super_Custom_Post_Type</code>‘s parent class, <code>Super_Custom_Post_Meta</code>, for fast, clean, intuitive custom post meta, which we’ll go into shortly.</p>
<p>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 <a href="http://fontawesome.io/" rel="nofollow ugc">Font Awesome</a> that are extremely easy to implement. Here’s what it looks like:</p>
<pre><code>$movies->set_icon( 'film' );
</code></pre>
<h4>Custom Taxonomies</h4>
<p>To define a new Custom Taxonomy, much like with Custom Post Types, you instantiate <code>Super_Custom_Taxonomy</code> with a string for the term name. For example:</p>
<pre><code>$actors = new Super_Custom_Taxonomy( 'actor' );
</code></pre>
<p>Again, we got free labels for doing this, using either ‘Actor’ or ‘Actors’ as appropriate, without needing to specify the 16 labels individually.</p>
<h4>Custom Post Meta</h4>
<p>Custom Post Meta is where SuperCPT shines the brightest, because this process is typically the most time-consuming. <code>Super_Custom_Post_Meta</code> 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 <code>add_meta_box</code> which does the bulk of the work, and somewhat mimics the WordPress function. Here’s an example:</p>
<pre><code>$movies->add_meta_box( array(
    'id' => 'features',
    'fields' => array(
        'tagline' => array( 'type' => 'text' )
    )
) );
</code></pre>
<p>The method <code>add_meta_box</code> takes an array of parameters (unlike the core function which takes normal ordered arguments). <code>id</code> 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. <code>"movie_details"</code> would become “Movie Details”). <code>fields</code> 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 <code>'data-src' => 'foo'</code> would become the HTML attribute <code>data-src="foo"</code> in the field). See the reference for the full gamut of options, both for the <code>add_meta_box</code> argument array and the fields array.</p>
<p>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.</p>
<h4>Helper Functions</h4>
<p>SuperCPT has a couple of helper functions for displaying your post meta. <code>get_scpt_formatted_meta</code> and <code>the_scpt_formatted_meta</code></p>
<h3>Demo Code</h3>
<p>Here is the full demo code:</p>
<pre><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>
</code></pre>
<p>1. Add better support for multiple fields for one meta key<br />
2. Add easy RSS feeds, e.g. in fields array, a parameter might be <code>'rss' => 'PubDate'</code> to prefer that field’s data over the post’s publication date.</p>


SuperCPT

Insanely easy and attractive custom post types, custom post meta, and custom taxonomies

Barn2 Plugins

<p><em>Easy Post Types and Fields</em> makes it quick and easy to <a href="https://barn2.com/blog/custom-wordpress-post-types/?utm_source=wporg&utm_medium=freeplugin&utm_campaign=freepluginwporg&utm_content=ecpt-wporg" rel="nofollow ugc">add custom post types</a>, custom fields, and taxonomies to your WordPress website.</p>
<p><span class="embed-youtube" style="text-align:center; display: block;"><iframe loading="lazy" class="youtube-player" width="750" height="422" src="https://www.youtube.com/embed/NOmnHxHpnU8?version=3&rel=1&showsearch=0&showinfo=1&iv_load_policy=1&fs=1&hl=en-US&autohide=2&wmode=transparent" allowfullscreen="true" style="border:0;" sandbox="allow-scripts allow-same-origin allow-popups allow-presentation allow-popups-to-escape-sandbox"></iframe></span></p>
<p>There are lots of reasons why WordPress site owners need to add extra content types to the CMS:</p>
<ul>
<li>
<p><strong>Create dedicated areas for each type of content within the WordPress admin (these are called ‘custom post types’)</strong>. For example, if you’re adding ‘Resources’ to your site then it’s best to create a ‘Resources’ custom post type and manage the resources separately from your pages and posts.</p>
</li>
<li>
<p><strong>Add extra fields (called ‘custom fields’) to your pages, posts, or any custom post type</strong>. These are useful for storing and displaying information in a structured way. For example, you might add a ‘Modified Date’ field to your Resources post type.</p>
</li>
<li>
<p><strong>Create extra ways of categorizing and organizing your website content (these are called ‘custom taxonomies’)</strong>. These are like categories and tags in WordPress, but the difference is that you can have as many as you like – for any post type. For example, you might create an ‘Industries’ taxonomy in order to group your Resources by industry.</p>
</li>
</ul>
<p>Developed by leading UK-based plugin company <a href="https://barn2.com/?utm_source=wporg&utm_medium=freeplugin&utm_campaign=freepluginwporg&utm_content=ecpt-wporg" rel="nofollow ugc">Barn2</a>, <em>Easy Post Types and Fields</em> is intentionally simpler and easier to use than other plugins. It has all the essential features that you need to create custom post types, custom fields, and custom taxonomies – without any unnecessary complexity.</p>
<h4>How to add custom post types, fields, and taxonomies to WordPress</h4>
<p>Simply create any type of content using a simple and intuitive wizard. You can create brand new custom post types, or add custom fields and taxonomies to existing post types. Either way, it’s incredibly straightforward.</p>
<p>Once you have created your custom post types, fields, and taxonomies, it’s easy to add the extra information to the WordPress CMS. Each custom post type has its own section on the left of the WordPress admin. Your custom fields and taxonomies appear on the ‘Add/Edit’ screen for each post.</p>
<p>View the full <a href="https://barn2.com/kb-categories/easy-post-types-fields-kb/?utm_source=wporg&utm_medium=freeplugin&utm_campaign=freepluginwporg&utm_content=ecpt-wporg" rel="nofollow ugc">plugin documentation</a> in our knowledge base.</p>
<h4>Can I display the custom content on the front end of my website?</h4>
<p>By default, your theme will display your custom post types using the same templates as the blog. This will list custom posts in the same way as blog posts, and won’t include your custom fields or taxonomies. This may not be the best way to present your custom content, so we recommend displaying it in a table using the <a href="https://barn2.com/wordpress-plugins/posts-table-pro/?utm_source=wporg&utm_medium=freeplugin&utm_campaign=freepluginwporg&utm_content=ecpt-wporg" rel="nofollow ugc">Posts Table Pro</a> plugin.</p>
<p>Posts Table Pro is a dynamic WordPress table plugin that lists any type of content from your website in a searchable table. As well as displaying any custom post type, you can choose which columns of information to show in the table – including your custom fields and custom taxonomies. See below for screenshots.</p>
<p>Your users will view the information in a table on the front end of your site. They can use the search box, sortable columns, and filter dropdowns to find exactly what they’re looking for.</p>
<p>This is how it displays the information from Easy Post Types and Fields:</p>
<ul>
<li>
<p>Create a table listing any or all of the posts from your custom post type. For example, you can list all the custom posts, or list posts with a specific ID, custom field value, custom taxonomy term, published date, etc.</p>
</li>
<li>
<p>Display each custom field as a separate column in the table. Users can sort the table by custom field.</p>
</li>
<li>
<p>Display each custom taxonomy as a separate column in the table. Users can sort by taxonomy terms, and also click on a term to filter the table. In addition, you can add each taxonomy as a filter dropdown above the table. That way, users can instantly find custom posts by taxonomy.</p>
</li>
</ul>
<h4>This free WordPress custom post type plugin includes:</h4>
<ul>
<li>
<p>Custom post types:</p>
<ul>
<li>
<p>Create an unlimited number of custom post types. Each custom post type has its own section in the WordPress admin, so you can manage your custom content separately from other WordPress post types.</p>
</li>
<li>
<p>Extend existing post types.</p>
</li>
</ul>
</li>
<li>
<p>Custom fields:</p>
<ul>
<li>
<p>Add custom fields to any WordPress post type – either the post types that are built into WordPress itself (pages, posts, media attachments, etc.), content types created using Easy Post Types and Fields, or any other custom post type (e.g. post types created using other plugins such as <a href="https://barn2.com/wordpress-plugins/document-library-pro/?utm_source=wporg&utm_medium=freeplugin&utm_campaign=freepluginwporg&utm_content=ecpt-wporg" rel="nofollow ugc">Document Library Pro</a> and <a href="https://barn2.com/wordpress-plugins/woocommerce-product-table/?utm_source=wporg&utm_medium=freeplugin&utm_campaign=freepluginwporg&utm_content=ecpt-wporg" rel="nofollow ugc">WooCommerce Product Table</a>.</p>
</li>
<li>
<p>2 custom field types: Plain text or WYSIWYG (Visual Editor).</p>
</li>
</ul>
</li>
<li>
<p>Custom taxonomies:</p>
<ul>
<li>
<p>Add custom taxonomies to any post type.</p>
</li>
<li>
<p>Choose between hierarchical taxonomies (similar to WordPress categories) or non-hierarchical taxonomies (similar to WordPress tags).</p>
</li>
<li>
<p>Each taxonomy is unique to a specific post type, so you can manage the taxonomy terms separately from other categories and taxonomies.</p>
</li>
</ul>
</li>
</ul>
<h4>What doesn’t it include?</h4>
<p>Easy Post Types and Fields includes the features that the majority of WordPress site owners use when they create custom post types, custom fields, and taxonomies. It intentionally does not include more advanced features that only a small proportion of users need, such as:</p>
<ul>
<li>
<p>Additional custom field types such as date picker, checkbox, and color picker fields (remember, you can add dates, numbers, images, etc. to a Visual Editor custom field in Easy Post Types and Fields).</p>
</li>
<li>
<p>Privacy options to restrict which user roles can see each field.</p>
</li>
<li>
<p>Relationship and repeater fields.</p>
</li>
<li>
<p>Advanced Content Types (ACTs) that get their own database tables.</p>
</li>
</ul>
<p>If you need these features then we recommend using a different custom post type plugin (e.g. Pods, Custom Post Type UI, or ACF). There are some excellent options available if you are happy with the added complexity.</p>
<h4>Restrict access to custom post types and make them private</h4>
<p>Some people want to control who can access some or all of their custom posts. You can do this by using Easy Post Types and Fields with our other plugin, <a href="https://barn2.com/wordpress-plugins/password-protected-categories/?utm_source=wporg&utm_medium=freeplugin&utm_campaign=freepluginwporg&utm_content=ecpt-wporg" rel="nofollow ugc">WordPress Password Protected Categories</a>. This adds privacy options to your hierarchical custom taxonomies.</p>
<p>Simply restrict each one to specific logged-in users or user roles, or to anyone with the password. All the posts/custom posts in that taxonomy will then be private and hidden from view.</p>


Easy Post Types and Fields

Easy Post Types and Fields makes it quick and easy to add custom post types, custom fields, and taxonomies to your WordPress website.

SuperCPT vs Easy Post Types and Fields