A Select Terms field can be inserted in:

  • an Admin Page, as an option or a user_meta
  • a User Profile, as a user_meta
  • a Metabox, as a post_meta
Sukellos Admin Builder

The code below is used to generate this section in an Admin Page, for an option:

Copy to Clipboard

A Select Terms inherit from a Field, and an Item, then all settings described in Field Settings and Item Settings are also used.

Specific settings for Select Terms:

Select Terms Settings Description
taxonomy
string / Default: ‘category’
Taxonomy name, or array of taxonomies, to which results should be limited.
Leave blank ” for any types
object_ids
array / Default: array()
Object ID, or array of object IDs. Results will be limited to terms associated with these objects.
orderby
string / Default: ‘name’
Field(s) to order terms by.
Accepts: term fields (‘name’, ‘slug’, ‘term_group’, ‘term_id’, ‘id’, ‘description’, ‘parent’, ‘term_order’)…
Leave blank ” for any status
order
string / Default: ‘ASC’
Whether to order terms in ascending or descending order.
Accepts ‘ASC’ (ascending) or ‘DESC’ (descending). Default ‘ASC’.
hide_empty
boolean / Default: true
Whether to hide terms not assigned to any posts.
Accepts 1|true or 0|false. Default 1|true.
number
int / Default: 0
Maximum number of terms to return.
Accepts ”|0 (all) or any positive number. Default ”|0 (all)
include
array / Default: array()
(int[]|string) Array or comma/space-separated string of term IDs to include. Default empty array.
exclude
array / Default: array()
(int[]|string) Array or comma/space-separated string of term IDs to exclude.
If $include is non-empty, $exclude is ignored. Default empty array.
show_count
boolean / Default: false
Display count of attached posts type if true