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

Hiroaki Miyashita

<p>The Custom Field Template plugin adds the default custom fields on the Write Post/Page. The template format is almost same as the one of the rc:custom_field_gui plugin. The difference is following.</p>
<ul>
<li><a href="https://www.wpcft.com/" rel="nofollow ugc">English Custom Field Template Manual</a></li>
</ul>
<p>We have finally published a manual site for the custom field template plugin. You can also use the custom field refinement search for posts in the admin panel. Please check here.</p>
<ul>
<li>You can set any number of the custom field templates and switch the templates when you write/edit the post/page.</li>
<li>This plugin does not use the ini file for the template but set it in the option page of the plugin.</li>
<li>Support for TinyMCE in the textarea.</li>
<li>Support for media buttons in the textarea. – requires at least 2.5.</li>
<li>Support for multiple fields with the same key.</li>
<li>Support for hideKey and label options.</li>
<li>You can see the full option list in the setting page of the plugin.</li>
<li>You can customize the design of custom field template with css.</li>
<li>You can replace custom keys by labels.</li>
<li>You can use wpautop function.</li>
<li>You can use PHP codes in order to set values. (experimental, <code>code = 0</code>)</li>
<li>You can set an access user level in each field. (<code>level = 1</code>)</li>
<li>Supprt for inserting custom field values into tags automatically. (<code>insertTag = true</code>)</li>
<li>Adds [cft] Shortcode to display the custom field template. (only shows the attributes which have <code>output = true</code>)</li>
<li>Adds template instruction sections.</li>
<li>Adds the value label option for the case that values are diffrent from viewed values. (<code>valueLabel = apples # oranges # bananas</code>)</li>
<li>Adds the blank option. (<code>blank = true</code>)</li>
<li>Adds the break type. Set CSS of ‘#cft div’. (<code>type = break</code>)</li>
<li>Adds [cft] Shortcode Format.</li>
<li>Adds the sort option. (<code>sort = asc</code>, <code>sort = desc</code>, <code>sort = order</code>)</li>
<li>Support for Quick Edit of custom fields. (tinyMCE and mediaButton are not supported yet)</li>
<li>Support for the custom field search. (only shows the attributes which have <code>search = true</code>.)</li>
<li>Adds [cftsearch] Shortcode Format. (under development)</li>
<li>Adds PHP codes for the output value. (<code>outputCode = 0</code>)</li>
<li>Adds PHP codes before saving the values. (<code>editCode = 0</code>)</li>
<li>Adds the save functionality.</li>
<li>Adds the class option. (<code>class = text</code>)</li>
<li>Adds the auto hook of <code>the_content()</code>. (experimental)</li>
<li>You can use the HTML Editor in the textarea. (<code>htmlEditor = true</code>)</li>
<li>Adds the box title replacement option.</li>
<li>Adds the select option of the post type.</li>
<li>Adds the value count option.</li>
<li>Adds the option to use the shortcode in the widhet.</li>
<li>Adds the attributes of JavaScript Event Handlers. (<code>onclick = alert('ok');</code>)</li>
<li>Adds the Initialize button.</li>
<li>Adds the attributes of before and after text. (<code>before = blah</code>, <code>after = blah</code>)</li>
<li>Adds the export and import functionality.</li>
<li>Adds the style attribute. (<code>style = color:#FF0000;</code>)</li>
<li>Adds the maxlength attribute. (<code>maxlength = 10</code>)</li>
<li>Adds the attributes of multiple fields. (<code>multiple = true</code>, <code>startNum = 5</code>, <code>endNum = 10</code>, <code>multipleButton = true</code>)</li>
<li>Adds the attributes of the date picker in <code>text</code> type. (<code>date = true</code>, <code>dateFirstDayOfWeek = 0</code>, <code>dateFormat = yyyy/mm/dd</code>)</li>
<li>Adds the filter of page template file names (Thanks, Joel Pittet).</li>
<li>Adds the attribute of <code>shortCode</code> in order to output the shortcode filtered values. (<code>shortCode = true</code>)</li>
<li>Adds the attribute of <code>outputNone</code> in case there is no data to output. (<code>outputNone = No Data</code>)</li>
<li>Adds the attribute of <code>singleList</code> attribute in order to output with <code><ul><li></code> if the value is single. ex) <code>singleList = true</code></li>
<li>Adds the file upload type. (<code>type = file</code>)</li>
<li>Adds the fieldset type. (<code>type = fieldset_open</code>, <code>type = fieldset_close</code>)</li>
<li>Adds the option to deploy the box in each template.</li>
</ul>
<p>Localization</p>
<ul>
<li>Belorussian (by_BY) – <a href="http://www.fatcow.com/" rel="nofollow ugc">Marcis Gasuns</a></li>
<li>Catalan (ca) – <a href="http://andreullos.com/" rel="nofollow ugc">Andreu Llos</a></li>
<li>Czech (cs_CZ) – <a href="http://www.webees.cz/" rel="nofollow ugc">Jakub</a></li>
<li>German (de_DE) – F J Kaiser</li>
<li>Spanish (es_ES) – <a href="http://www.darioferrer.com/" rel="nofollow ugc">Dario Ferrer</a></li>
<li>Farsi (fa_IR) – <a href="http://sabood.ir/" rel="nofollow ugc">Mehdi Zare</a></li>
<li>French (fr_FR) – Nicolas Lemoine</li>
<li>Hungarian (hu_HU) – <a href="http://www.netpok.hu" rel="nofollow ugc">Balazs Kovacs</a></li>
<li>Indonesian (id_ID) – <a href="http://www.openscriptsolution.com/" rel="nofollow ugc">Masino Sinaga</a></li>
<li>Italian (it_IT) – <a href="http://gidibao.net/" rel="nofollow ugc">Gianni Diurno</a></li>
<li>Japanese (ja) – <a href="https://wpgogo.com/" rel="nofollow ugc">Hiroaki Miyashita</a></li>
<li>Dutch (nl_NL) – <a href="http://wordpresswebshop.com/" rel="nofollow ugc">Rene</a></li>
<li>Polish (pl_PL) – <a href="http://www.difreo.pl/" rel="nofollow ugc">Difreo</a></li>
<li>Brazilian Portuguese (pt_BR) – <a href="http://www.gn10.com.br/" rel="nofollow ugc">Caciano Gabriel</a></li>
<li>Russian (ru_RU) – <a href="http://www.sonika.ru/blog/" rel="nofollow ugc">Sonika</a></li>
<li>Swedish (sv_SE) – <a href="http://www.fristil.se/" rel="nofollow ugc">Pontus Carlsson</a></li>
<li>Turkish (tr_TR) – <a href="http://ramerta.com/" rel="nofollow ugc">Omer Faruk</a></li>
<li>Ukranian (uk_UA) – <a href="http://www.portablecomponentsforall.com" rel="nofollow ugc">Andrew Kovalev</a></li>
<li>Uzbek (uz_UZ) – <a href="http://www.comfi.com/" rel="nofollow ugc">Alexandra Bolshova</a></li>
<li>Chinese (zh_CN) – hurri zhu</li>
</ul>
<p>If you have translated into your language, please let me know.</p>
<ul>
<li><a href="http://ja.wpcft.com/" rel="nofollow ugc">Japanese Custom Field Template Manual</a></li>
</ul>
<p>Are you interested in other plugins? See the following site <a href="https://www.cmswp.jp/" rel="nofollow ugc">CMS x WP</a>.</p>
<h3>Known Issues / Bugs</h3>
<h3>Uninstall</h3>
<ol>
<li>Deactivate the plugin</li>
<li>That’s it! 🙂</li>
</ol>


Custom Field Template

The Custom Field Template plugin extends the functionality of custom fields.

SuperCPT vs Custom Field Template