🔥 HOT: Function Reference/get taxonomies

Retrieves a list of registered taxonomy names or objects.

Parameters

$argsarrayoptional: An array of key => value arguments to match against the taxonomy objects.

Default:array()
$outputstringoptional: The type of output to return in the array. Either 'names' or 'objects'. Default 'names'.
Default:'names'
$operatorstringoptional: The logical operation to perform. Accepts 'and' or 'or'. 'or' means only one element from the array needs to match; 'and' means all elements must match.
Default 'and'.
Default:'and'

Return

string[]|WP_Taxonomy[] An array of taxonomy names or objects.

More Information

Parameter $args is an array of key -> value arguments to match against the taxonomies. Only taxonomies having attributes that match all arguments are returned.

name
object_type (array)
label
singular_label
show_ui
show_tagcloud
show_in_rest
public
update_count_callback
rewrite
query_var
manage_cap
edit_cap
delete_cap
assign_cap
_builtin

Returned value is an array, a list of taxonomy names or objects. If returning names, you will get an array of the taxonomy names such as

Array ( [special_taxonomy] => special_taxonomy [custom_taxonomy] => custom_taxonomy )

If returning objects, you will get an array of objects such as:

Array ( [special_taxonomy] => stdClass Object  [custom_taxonomy] => stdClass Object  )

wherein each object will contain the following fields:

stdClass Object ( 
[hierarchical] => 
[update_count_callback] =>  
[rewrite] => 
[query_var] => 
[public] => 
[show_ui] => 
[show_tagcloud] => 
[_builtin] => 
[labels] => stdClass Object ( 
	[name] =>  
	[singular_name] =>
	[search_items] => 
	[popular_items] => 
	[all_items] => 
	[parent_item] => 
	[parent_item_colon] =>  
	[edit_item] => 
	[view_item] =>  
	[update_item] => 
	[add_new_item] => 
	[new_item_name] => 
	[separate_items_with_commas] => 
	[add_or_remove_items] => 
	[choose_from_most_used] => 
	[menu_name] =>  
	[name_admin_bar] =>  ) 
[show_in_nav_menus] => 
[cap] => stdClass Object ( 
	[manage_terms] =>  
	[edit_terms] =>  
	[delete_terms] =>  
	[assign_terms] =>  ) 
[name] =>  
[object_type] => Array () 
[label]  )

Source

function get_taxonomies( $args = array(), $output = 'names', $operator = 'and' ) {
	global $wp_taxonomies;

	$field = ( 'names' === $output ) ? 'name' : false;

	return wp_filter_object_list( $wp_taxonomies, $args, $operator, $field );
}

View all references View on Trac View on GitHub

Uses	Description
wp_filter_object_list()`wp-includes/functions.php`	Filters a list of objects, based on a set of key => value arguments.

Used by	Description
get_template_hierarchy()`wp-includes/block-template-utils.php`	Gets the template hierarchy for the given template slug to be created.
_build_block_template_result_from_post()`wp-includes/block-template-utils.php`	Builds a unified template object based a post Object.
WP_REST_Term_Search_Handler::__construct()`wp-includes/rest-api/search/class-wp-rest-term-search-handler.php`	Constructor.
WP_Sitemaps_Taxonomies::get_object_subtypes()`wp-includes/sitemaps/providers/class-wp-sitemaps-taxonomies.php`	Returns all public, registered taxonomies.
create_initial_rest_routes()`wp-includes/rest-api.php`	Registers default REST API routes.
WP_REST_Taxonomies_Controller::get_items_permissions_check()`wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php`	Checks whether a given request has permission to read taxonomies.
WP_REST_Taxonomies_Controller::get_items()`wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php`	Retrieves all public taxonomies.
WP_Customize_Nav_Menus::search_available_items_query()`wp-includes/class-wp-customize-nav-menus.php`	Performs post queries for available-item searching.
WP_Customize_Nav_Menus::available_item_types()`wp-includes/class-wp-customize-nav-menus.php`	Returns an array of all the available item types.
set_screen_options()`wp-admin/includes/misc.php`	Saves option for number of rows when listing posts, pages, comments, etc.
wp_ajax_menu_get_metabox()`wp-admin/includes/ajax-actions.php`	Handles for retrieving menu meta boxes via AJAX.
wp_nav_menu_taxonomy_meta_boxes()`wp-admin/includes/nav-menu.php`	Creates meta boxes for any taxonomy menu item.
WP::parse_request()`wp-includes/class-wp.php`	Parses the request to find the correct WordPress query.
WP_Query::parse_tax_query()`wp-includes/class-wp-query.php`	Parses various taxonomy related query vars.
WP_Widget_Tag_Cloud::form()`wp-includes/widgets/class-wp-widget-tag-cloud.php`	Outputs the Tag Cloud widget settings form.
get_post_class()`wp-includes/post-template.php`	Retrieves an array of the class names for the post container element.
wp_xmlrpc_server::wp_getTaxonomies()`wp-includes/class-wp-xmlrpc-server.php`	Retrieves all taxonomies.

Show 12 more Show less

Changelog

Version	Description
3.0.0	Introduced.

User Contributed Notes

hearvox 10 years ago

Display a list of only public custom taxonomies — will not list include WordPress built-in taxonomies (e.g., categories and tags):

<?php 
$args = array(
  'public'   => true,
  '_builtin' => false
  
); 
$output = 'names'; // or objects
$operator = 'and'; // 'and' or 'or'
$taxonomies = get_taxonomies( $args, $output, $operator ); 
if ( $taxonomies ) {
	echo '<ul>';
	foreach ( $taxonomies  as $taxonomy ) {
		echo '<li>' . $taxonomy . '</li>';
	}
	echo '</ul>';	
}
?>

Skip to note 9 content

Ulrich 8 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 3You must log in to vote on the helpfulness of this note
When querying the taxonomies with a specific post type like “posts” in this case, only the taxonomies connected only with this post type will be shown. If a taxonomy is attached to multiple post types it will not be listed. Core Trac Ticket 27918
```
<?php 
$args = array(
	'name' => array(
		'post',
	),
);
$taxonomies = get_taxonomies( $args );
```
The alternative is to use get_object_taxonomies().
Log in to add feedback
Skip to note 10 content

hearvox 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 1You must log in to vote on the helpfulness of this note
Display the plural name of a specific taxonomy (and setting the output to be 'object' rather than the default 'array‘):
```
<?php 
$args = array(
	'name' => 'genre'
);
$output = 'objects'; // or names
$taxonomies= get_taxonomies( $args, $output ); 
if ( $taxonomies ) {
	foreach ( $taxonomies as $taxonomy ) {
		echo '<div>' . $taxonomy->labels->name . '</div>';
	}
}  
?>
```
Log in to add feedback
Skip to note 11 content

hearvox 10 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Display a list all registered taxonomies:
```
<?php
$taxonomies = get_taxonomies();
if ( ! empty( $taxonomies ) ) : ?>
	<ul>
		<?php
		foreach ( $taxonomies as $taxonomy ) {
		    echo '<li>' . $taxonomy . '</li>';
		}
		?>
	</ul>
<?php endif; ?>
```
Log in to add feedback
Skip to note 12 content

samjco 7 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

🔥 HOT: Function Reference/get taxonomies - High Quality

get_taxonomies( array $args = array(), string $output = 'names', string $operator = 'and' ): string[]|WP_Taxonomy[]

In this article

Parameters

Return

More Information

Source

Changelog

User Contributed Notes

🔥 HOT: Function Reference/get taxonomies - High Quality

get_taxonomies( array $args = array(), string $output = 'names', string $operator = 'and' ): string[]|WP_Taxonomy[]

In this article

Parameters

Return

More Information

Source

Related

Changelog

User Contributed Notes