Skip to content
Controls

Taxonomy

Taxonomy control lets you search and select terms from any WordPress taxonomy (categories, tags, or custom taxonomies).

Taxonomy Control

Only taxonomies registered with show_in_rest => true will appear in the control. If your custom taxonomy is not showing up, add this parameter:

register_taxonomy('your_taxonomy', 'post', [
    // ... other parameters
    'show_in_rest' => true,
]);

Control Settings

  • Taxonomy - Choose taxonomy type (Categories, Tags, etc.)
  • Appearance - Display as Select, Checkbox, or Radio
  • Output Format - Choose data format:
    • Term Slug - Returns term slug
    • Term ID - Returns term ID
    • Term Object - Returns full term object
  • Multiple - Allow selecting multiple terms

Usage Examples

Basic Usage (Term Slug)

PHP
<?php
$term = get_term_by('slug', $attributes['control_name'], 'category');
if ($term && !is_wp_error($term)) {
    echo '<span class="term">' . esc_html($term->name) . '</span>';
}
?>

Multiple Terms

PHP
<?php if ($attributes['control_name']) : ?>
    <ul class="terms-list">
        <?php foreach($attributes['control_name'] as $term_slug) :
            $term = get_term_by('slug', $term_slug, 'category');
            if ($term && !is_wp_error($term)) : ?>
                <li class="term-<?php echo esc_attr($term->slug); ?>">
                    <?php echo esc_html($term->name); ?>
                </li>
            <?php endif;
        endforeach; ?>
    </ul>
<?php endif; ?>

Using Term Object

PHP
<?php if ($attributes['control_name']) : ?>
    <div class="term-<?php echo esc_attr($attributes['control_name']->slug); ?>">
        <h4><?php echo esc_html($attributes['control_name']->name); ?></h4>
        <p><?php echo esc_html($attributes['control_name']->description); ?></p>
    </div>
<?php endif; ?>

Handlebars Usage

Set Output Format to Term Object when using Handlebars templates.

Single Term
<div class="term-{{control_name.slug}}">
  {{control_name.name}}
</div>
Multiple Terms
<ul class="terms-list">
  {{#each control_name}}
    <li class="term-{{this.slug}}">
      {{this.name}}
    </li>
  {{/each}}
</ul>

Post Meta

Post Meta
<?php
$term_slug = get_lzb_meta('control_meta_name');
if ($term_slug) {
    $term = get_term_by('slug', $term_slug, 'category');
    if ($term && !is_wp_error($term)) {
        echo '<span class="term">' . esc_html($term->name) . '</span>';
    }
}
?>

Use Term Object format to access all term data without additional database queries.

Previous ArticlePostsNext ArticleUnits

Was this article helpful?