/cmb2-taxonomy

Custom metaboxes for taxonomies

Primary LanguagePHPGNU General Public License v2.0GPL-2.0

CMB2 Taxonomy

Contributors: jcchavezs
Tags: metaboxes, forms, fields, options, settings, taxonomy, term
Requires at least: 3.8.0
Tested up to: 4.2.2
Stable tag: 1.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Description

CMB2 Taxonomy will create metaboxes and forms with custom fields for your taxonomies using the CMB2 API (and yes, it will blow your mind too).

This plugin adds an additional table for term's metadata storage following the metadata patterns which means that eventhough we add an extra table we still using the metadata API. Check the Usage section out for more information.

To get started, please follow the examples in the included example-functions.php file and have a look at the basic usage instructions.

You can see a list of available field types here.

Links

Installation

If installing the plugin from wordpress.org:

  1. Upload the entire /cmb2-taxonomy directory to the /wp-content/plugins/ directory.
  2. Activate CMB2 Taxonomy through the 'Plugins' menu in WordPress.
  3. Copy (and rename if desired) example-functions.php into to your theme or plugin's directory.
  4. Edit to only include the fields you need and rename the functions.
  5. Profit.

Usage

This plugin adds a couple of new functions for metadata management, similar to the post_meta functions:

  • get_term_meta: Retrieves metadata for the specified term.
  • update_term_meta: Update metadata for the specified term. If no value already exists for the specified term ID and metadata key, the metadata will be added.
  • add_term_meta: Add metadata for the specified term.
  • delete_term_meta: Delete metadata for the specified term.