HelgaTheViking

<p>I found I constantly needed a way for clients to mark a post as something they wanted to feature and I’ve never found sticky posts particularly inuitive and the UI is pretty hidden for new users.  The simplest solution was a checkbox in prominently located metabox.</p>
<p>Please note that this plugin, by itself, will not change how your posts are displayed.  It just gives the UI to users and a meta key to theme developers to query for.</p>
<h4>Usage</h4>
<p>This plugin simply adds a <code>_featured</code> meta key to every post with a value of <code>yes</code> for featured items and <code>no</code> for everything else.  Actual display of the featured items is entirely up to the theme developer, but an example ( place in your template where you’d like to display a list of featured “Portfolios”) might be as follows:</p>
<pre><code>// params for our query
$args = array(
    'post_type' => 'portfolio',
   'posts_per_page'  => 5,
   'meta_key'        => '_featured',
   'meta_value'      => 'yes'
);

// The Query
$featured_portfolios = new WP_Query( $args );

// The Loop
if ( $featured_portfolios ) :

    echo '<ul class="featured">';

    while ( $featured_portfolios->have_posts() ) :
        $featured_portfolios->the_post();
        echo '<li>' . get_the_title() . '</li>';
    endwhile;

    echo '</ul>';

else :

    echo 'No featured portfolios found.';

endif;

/* Restore original Post Data
 * NB: Because we are using new WP_Query we aren't stomping on the
 * original $wp_query and it does not need to be reset.
*/
wp_reset_postdata();
</code></pre>
<p>Multiple queries per page load can slow down your site so it is worthwhile to take advantage of the <a href="https://codex.wordpress.org/Transients_API" rel="nofollow ugc">Transients API</a>, so an alternate usage would be:</p>
<pre><code>// Get any existing copy of our transient data
if ( false === ( $featured_portfolios = get_transient( 'featured_portfolios' ) ) ) {
    // It wasn't there, so regenerate the data and save the transient

   // params for our query
    $args = array(
        'post_type' => 'portfolio',
       'posts_per_page'  => 5,
       'meta_key'        => '_featured',
       'meta_value'      => 'yes'
    );

    // The Query
    $featured_portfolios = new WP_Query( $args );

    // store the transient
    set_transient( 'featured_portfolios', $featured_portfolios );

}

// Use the data like you would have normally...

// The Loop
if ( $featured_portfolios ) :

    echo '<ul class="featured">';

    while ( $featured_portfolios->have_posts() ) :
        $featured_portfolios->the_post();
        echo '<li>' . get_the_title() . '</li>';
    endwhile;

    echo '</ul>';

else :

    echo 'No featured portfolios found.';

endif;

/* Restore original Post Data
 * NB: Because we are using new WP_Query we aren't stomping on the
 * original $wp_query and it does not need to be reset.
*/
wp_reset_postdata();
</code></pre>
<p>Then to ensure that your featured posts list is updated, add a function to your theme’s functions.php to delete the transient when a portfolio (in this example) post type is saved.</p>
<pre><code>// Create a function to delete our transient when a portfolio post is saved
function save_post_delete_featured_transient( $post_id ) {
   if ( 'portfolio' == get_post_type( $post_id ) )
    delete_transient( 'featured_portfolios' );
}
// Add the function to the save_post hook so it runs when posts are saved
add_action( 'save_post', 'save_post_delete_featured_transient' );
</code></pre>
<p>Simple queries should only need the <code>meta_key</code> and <code>meta_value</code> parameters, but if you need something more advanced then you might want to read about how to use the more <a href="http://scribu.net/wordpress/advanced-metadata-queries.html" rel="nofollow ugc">complex Meta Query parameters</a>.</p>
<h4>Support</h4>
<p>Support is handled in the <a href="https://wordpress.org/support/plugin/featured-item-metabox" rel="ugc">WordPress forums</a>.  Please note that support is limited and does not cover any custom implementation of the plugin.</p>
<p>Please report any bugs, errors, warnings, code problems at <a href="https://github.com/helgatheviking/Featured-Item-Metabox/issues" rel="nofollow ugc">Github</a></p>


Featured Item Metabox

Quickly add a metabox to any post type for marking a post as featured.  Toggle featured status even more quickly from the posts lists/ quick edit scre …

Phan Chuong

<p>There is a dozen WordPress metaboxes out there, but this one is the unique one, the simplest one, and the most flexible one. Imagine you have a post that need to display multiple of <strong>item</strong>, and each item have a bundle of fields, you’d need IP Metaboxes’s help.</p>
<h4>**WHAT’S NEW on 2.1 ?**</h4>
<ol>
<li>New API function to get single metabox value.</li>
<li>Add new ability to upload feature to allow you to upload MP3 audio files together with pictures.</li>
<li>Fix compatibility with WordPress 3.8.1.</li>
</ol>
<h4>**HIGHLIGHTED FEATURES**</h4>
<ol>
<li>It has ability to add <strong>multiple items</strong> for each metabox. </li>
<li>You can <strong>change the order</strong> of each items according to your expectation.</li>
<li>All the settings and customizations are placed under <strong>only one page</strong>, and it’s super easy to add more and more metaboxes for any post, even custom post types. </li>
</ol>
<h4>How to use</h4>
<ol>
<li>After install, there is a custom menu that created at the bottom of admin page, it’s named “IP Metaboxes”. By opening that page, you’re accessing to the main setting page of IP Metaboxes.</li>
<li>Let’s start to define a metabox:
<ul>
<li><em>Metabox Name</em>: The name of metabox. There is no limitation of this name, you can define any easy-to-remember name for this. Changing this name would take no impact to your data.</li>
<li><em>Post Types</em>: The post type that you would like to apply metabox to. You can select multiple types, and of course you can select custom post type.</li>
<li><em>Context</em>: The location of metabox (left/right). Usually, <em>normal</em> and <em>advanced</em> would make your metabox stay on the left side (content section), and <em>side</em> would make it stay on the right side (publish section).</li>
<li><em>Priority</em>: The place of metabox (top, bottom). Usually, <em>high</em> would make your metabox go up and higher than the others.</li>
<li><em>Post IDs</em>: The special post IDs that you want to strict your metabox to display. You can enter multiple ID, separate by comma, e.g.: <code>102, 582</code>.</li>
</ul>
</li>
<li>Now, let’s add some fields for your metabox:
<ul>
<li><em>Name</em>: The name of field. You can enter any name you want here, but please remember that, <strong>CHANGING THE FIELD NAME WOULD MAKE YOUR OLD DATA LOST</strong>.</li>
<li><em>Type</em>: The type of field. </li>
<li><em>Options</em>: Each field type have some sort of options:
<ul>
<li>Text, editor: no special options.</li>
<li>Multiselect, select, checkbox, radio: each item is separated by comma, e.g.: <code>item 1, item 2, item 3</code>.</li>
<li>Upload: width and height are separated by comma, e.g.: <code>100, 200</code>.</li>
<li>Date: your expected format, default one is <code>dd/MM/yyyy</code>.</li>
</ul>
</li>
<li><em>Description</em>: The field’s description. Just use it to describe a little information about the field to end-user.</li>
<li><em>ID</em>: The field’s ID. This ID is auto-generated based on your field name, you might need it in order to get a specific data as you want.</li>
</ul>
</li>
<li>Finally, just save them all and you will see a sample code that show how to display the metaboxes you just added. Copy them to the template and well done.</li>
</ol>
<h4>Public API</h4>
<p>Currently IP Metaboxes only public 3 methods:</p>
<ol>
<li><code>ipmb_get_metabox_values($metabox_id, $post_id)</code>
<ul>
<li><code>$metabox_id</code>: you can found it under metaboxes table of IP Metaboxes setting page</li>
<li><code>$post_id</code>: by default it would be the current post. But in order to get metaboxes of some special post you can pass it’s ID here.</li>
</ul>
</li>
<li><code>ipmb_get_metabox_value($metabox_id, $post_id, $field_name)</code>
<ul>
<li><code>$metabox_id</code>: you can found it under metaboxes table of IP Metaboxes setting page.</li>
<li><code>$post_id</code>: by default it would be the current post. But in order to get metaboxes of some special post you can pass it’s ID here.</li>
<li><code>$field_name</code>: the specific field that you want to get value, can be found at metabox details table of IP Metaboxes setting page</li>
</ul>
</li>
<li><code>ipmb_get_metabox_images($url, $size)</code>
<ul>
<li><code>$url</code>: the url of image, you should have this from method <code>ipmb_get_metabox_values</code> with upload field</li>
<li><code>$size</code> : the thumbnail size, by default it’s ‘thumbnail’ but you can change to any size you want, even the array of width and height as you usually defined.</li>
</ul>
</li>
</ol>
<h4>Known Issues</h4>
<ol>
<li>When add an ‘editor’ with context ‘side’, it would automatically change to normal textarea, this happens because there is not much space for an editor when it’s displaying at sidebar.</li>
<li>When you try to move items around or add new item, and if the item contain editor(s), it will be disabled and you cannot edit it’s content. This is one of limitation of WordPress editor. So just save your post and you will be able to enter text.</li>
<li>There is no link for ‘Expand All’ and ‘Collapse All’ if the context is ‘side’ due to the title space is too small.</li>
</ol>
<p><strong>Please <a href="mailto:pltchuong@gmail.com" rel="nofollow ugc">let me know</a> if there is any bugs happens, or any feature that you’d like to have, I will do my best to complete it if I can 🙂</strong></p>


IP Metaboxes

A new metaboxes plugin, the unique one, the simplest one, and the most flexible one.

Featured Item Metabox vs IP Metaboxes