Shortcode by Bobby Bryant
From WordPress.org
get_terms( array|string $args = array(), array $deprecated = ” )
You can fully inject any customizations to the query before it is sent, as well as control the output with a filter.
The ‘get_terms’ filter will be called when the cache has the term and will pass the found term along with the array of $taxonomies and array of $args. This filter is also called before the array of terms is passed and will pass the array of terms, along with the $taxonomies and $args.
The ‘list_terms_exclusions’ filter passes the compiled exclusions along with the $args.
The ‘get_terms_orderby’ filter passes the ORDER BY
clause for the query along with the $args array.
Prior to 4.5.0, the first parameter of get_terms()
was a taxonomy or list of taxonomies:
$terms = get_terms( 'post_tag', array(
'hide_empty' => false,
) );
Since 4.5.0, taxonomies should be passed via the ‘taxonomy’ argument in the $args
array:
$terms = get_terms( array(
'taxonomy' => 'post_tag',
'hide_empty' => false,
) );
Parameters
- $args
-
(array|string) (Optional) Array or string of arguments to get terms.
- ‘taxonomy’
(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’), ‘count’ for term taxonomy count, ‘include’ to match the ‘order’ of the $include param, ‘meta_value’, ‘meta_value_num’, the value of$meta_key
, the array keys of$meta_query
, or ‘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. - ‘exclude’
(array|string) Array or comma/space-separated string of term ids to exclude. If $include is non-empty, $exclude is ignored. - ‘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. - ‘number’
(int|string) Maximum number of terms to return. Accepts ”|0 (all) or any positive number. Default ”|0 (all). - ‘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), ‘ids’ (returns an array of ids), ‘id=>parent’ (returns an associative array with ids as keys, parent term IDs as values), ‘names’ (returns an array of term names), ‘count’ (returns the number of matching terms), ‘id=>name’ (returns an associative array with ids as keys, term names as values), or ‘id=>slug’ (returns an associative array with ids as keys, term slugs as values). Default ‘all’. - ‘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) Meta query clauses to limit retrieved terms by. See_F9J_Meta_Query
. - ‘meta_key’
(string) Limit terms to those matching a specific metadata key. Can be used in conjunction with$meta_value
. - ‘meta_value’
(string) Limit terms to those matching a specific metadata value. Usually used in conjunction with$meta_key
.
Default value: array()
- ‘taxonomy’
- $deprecated
-
(array) (Optional) Argument array, when using the legacy function parameter format. If present, this parameter will be interpreted as
$args
, and the first function parameter will be parsed as a taxonomy or array of taxonomies.Default value: ”
From WordPress.org
get_term_link( object|int|string $term, string $taxonomy = ” )
Parameters
- $term
-
(object|int|string) (Required) The term object, ID, or slug whose link will be retrieved.
- $taxonomy
-
(string) (Optional) Taxonomy.
Default value: ”
Return
(string|_F9J_Error) HTML link to taxonomy term archive on success, _F9J_Error if term does not exist.