MB Term Meta

Improve this page

Installation

Before installing the extension, you need to install Meta Box plugin first.

  1. Go to Plugins → Add New and search for Meta Box
  2. Click Install Now button to install the plugin
  3. After installing, click Activate Plugin to activate the plugin

The extension is just a WordPress plugin, you can install it like a normal WordPress plugin.

  1. Go to Plugins, click Add new, then click Upload plugin.
  2. Choose the .zip file you downloaded and click Install now
  3. After finishing upload, click Activate to finish.

Creating meta boxes

Creating custom meta boxes and custom fields for taxonomy terms is similar to posts. See this documentation to know how to create a meta box, and this documentation to know how to define fields.

The only difference here is when you create a meta box for a taxonomy, you need to specify a parameter taxonomies which the meta box will be added to. This parameter can be an array of taxonomy slugs or a string of single taxonomy slug. And you have to remove the parameter post_types.

Example

The code below register a meta box for category which has 4 custom fields:

add_filter( 'rwmb_meta_boxes', 'prefix_register_taxonomy_meta_boxes' );
function prefix_register_taxonomy_meta_boxes( $meta_boxes ){
    $meta_boxes[] = array(
        'title'      => 'Standard Fields',
        'taxonomies' => 'category', // List of taxonomies. Array or string

        'fields' => array(
            array(
                'name' => 'Featured?',
                'id'   => 'featured',
                'type' => 'checkbox',
            ),
            array(
                'name' => 'Featured Content',
                'id'   => 'featured_content',
                'type' => 'wysiwyg',
            ),
            array(
                'name' => 'Featured Image',
                'id'   => 'image_advanced',
                'type' => 'image_advanced',
            ),
            array(
                'name' => 'Color',
                'id'   => 'color',
                'type' => 'color',
            ),
        ),
    );
    return $meta_boxes;
}

Result:

mb term meta

Data

WordPress provides an identical way to store values in the meta tables for post / term / user. This extension utilizes that API and stores field value in the term meta exactly like post meta.

Getting field value

You’re able to use helper function rwmb_meta() to get field value for terms.

$value = rwmb_meta( $field_id, array( 'object_type' => 'term' ), $term_id );
echo $value;

Notes:

  • In the 2nd parameter, you need to pass 'object_type' => 'term', and
  • In the last parameter, you need to pass the term ID

Other parameters are the same as for post. Please see this documentation for details.

It requires the extension version 1.1+ to use the helper function. If you’re using an older version, please update now.

In case you use an older version than 1.1, you can get fiel value manually:

$meta = get_term_meta( $term_id, $field_id, true );
echo $meta;

// Or use this code if field has multiple value
$meta = get_term_meta( $term_id, $field_id, false );
foreach ( $meta as $value ) {
    echo $value;
}

Note that the get_term_meta function returns only raw data of field value. It doesn’t return meaningful information for images, file, etc. To do that, please add a small piece of code as follow:

// Getting images
$image_ids = get_term_meta( $term_id, $field_id, false ); // Media fields are always multiple.
foreach ( $image_ids as $image_id ) {
    $image = RWMB_Image_Field::file_info( $image_id, array( 'size' => 'thumbnail' ) );
    echo '<img src="' . $image['url'] . '">';
}

These are some helper functions that you can use to retrieve more info:

Field type Helper function(s)
image, image_advanced, plupload_image, thickbox_image wp_get_attachment_image_src()
  wp_get_attachment_image_url()
  RWMB_Image_Field::file_info( $image_id, $args ); (where $args is an array and accepts only size attribute)
file, file_advanced get_attached_file()
  RWMB_File_Field::file_info( $image_id );
oembed RWMB_OEmbed_Field::get_embed( $url );
taxonomy, taxonomy_advanced get_term()
user get_userdata()
post get_post()

Read more on how field values are saved into the database.