Retrieve the terms in a given taxonomy or list of taxonomies
Syntax
:
XHTML
1
2
3
4
5
6
7
8
[query.get_terms
taxonomies='taxonomy_slug'
orderby='order by term'
order='ASC'
parent='parent term id'
hide_empty=0
number='per page count'
/]
Input Parameters
:
taxonomies
(string|array) Taxonomy name, or array of taxonomies, to which results should be limited.
orderby: (string) Field(s) to order terms by. Accepts:
term fields (‘name’, ‘slug’, ‘term_group’, ‘term_id’, ‘id’, ‘description’, ‘parent’, ‘term_order’). Unless object_ids is not empty, ‘term_order’ is treated the same as ‘term_id’.
‘count’ for term taxonomy count.
‘include’ to match the ‘order’ of the $include param.
‘slug__in’ to match the ‘order’ of the $slug param.
‘meta_value’, ‘meta_value_num’.
the value of meta_key.
the array keys of meta_query.
‘none’ to omit the ORDER BY clause. Defaults to ‘name’.
order
(string) Whether to order terms in ascending or descending order. Accepts ‘ASC’ (ascending) or ‘DESC’ (descending). Default ‘ASC’.
hide_empty
(bool|int) Whether to hide terms not assigned to any posts. Accepts 1|true or 0|false. Default 1|true.
include
(array|string) Array or comma/space-separated string of term IDs to include. Default empty array.
exclude
(array|string) Array or comma/space-separated string of term IDs to exclude. If $include is non-empty, $exclude is ignored. Default empty array.
exclude_tree
(array|string) Array or comma/space-separated string of term IDs to exclude along with all of their descendant terms. If $include is non-empty, $exclude_tree is ignored. Default empty array.
number
(int|string) Maximum number of terms to return. Accepts ”|0 (all) or any positive number. Default ”|0 (all). Note that $number may not return accurate results when coupled with $object_ids. See #41796 for details.
offset
(int) The number by which to offset the terms query.
‘fields’ (string) Term fields to query for. Accepts:
‘all’ Returns an array of complete term objects (WP_Term[]).
‘all_with_object_id’ Returns an array of term objects with the ‘object_id’ param (WP_Term[]). Works only when the $object_ids parameter is populated.
‘ids’ Returns an array of term IDs (int[]).
‘tt_ids’ Returns an array of term taxonomy IDs (int[]).
‘names’ Returns an array of term names (string[]).
‘slugs’ Returns an array of term slugs (string[]).
‘count’ Returns the number of matching terms (int).
‘id=>parent’ Returns an associative array of parent term IDs, keyed by term ID (int[]).
‘id=>name’ Returns an associative array of term names, keyed by term ID (string[]).
‘id=>slug’ Returns an associative array of term slugs, keyed by term ID (string[]). Default ‘all’.
‘count’
(bool) Whether to return a term count. If true, will take precedence over $fields. Default false.
‘name’
(string|array) Optional. Name or array of names to return term(s) for.
‘slug’
(string|array) Optional. Slug or array of slugs to return term(s) for.
‘hierarchical’
(bool) Whether to include terms that have non-empty descendants (even if $hide_empty is set to true). Default true.
‘search’
(string) Search criteria to match terms. Will be SQL-formatted with wildcards before and after.
‘name__like’
(string) Retrieve terms with criteria by which a term is LIKE name__like.
‘description__like’
(string) Retrieve terms where the description is LIKE description__like.
‘pad_counts’
(bool) Whether to pad the quantity of a term’s children in the quantity of each term’s “count” object variable. Default false.
‘get’
(string) Whether to return terms regardless of ancestry or whether the terms are empty. Accepts ‘all’ or empty (disabled).
‘child_of’
(int) Term ID to retrieve child terms of. If multiple taxonomies are passed, $child_of is ignored. Default 0.
‘parent’
(int|string) Parent term ID to retrieve direct-child terms of.
‘childless’
(bool) True to limit results to terms that have no children. This parameter has no effect on non-hierarchical taxonomies. Default false.
‘cache_domain’
(string) Unique cache key to be produced when this query is stored in an object cache. Default is ‘core’.
‘update_term_meta_cache’
(bool) Whether to prime meta caches for matched terms. Default true.
‘meta_query’
(array) Optional. Meta query clauses to limit retrieved terms by.
Return Value
:
It returns:
List of WP_Term instances and their children.
Will return WP_Error, if any of taxonomies do not exist