get_taxonomies( array $args = array(), string $output = 'names', string $operator = 'and' )

Retrieves a list of registered taxonomy names or objects.

Contents

Description Description

Parameters Parameters

$args

(array) (Optional) An array of key => value arguments to match against the taxonomy objects.

Default value: array()

$output

(string) (Optional) The type of output to return in the array. Accepts either taxonomy 'names' or 'objects'.

Default value: 'names'

$operator

(string) (Optional) 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 value: 'and'

Top ↑

Return Return

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

Top ↑

Source Source

File: wp-includes/taxonomy.php 

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 );
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
3.0.0 Introduced.

Top ↑

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/rest-api.php: create_initial_rest_routes()

Registers default REST API routes.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::get_item_schema()

Retrieves the term’s schema, conforming to JSON Schema.
wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php: WP_REST_Taxonomies_Controller::get_items_permissions_check()

Checks whether a given request has permission to read taxonomies.
wp-includes/rest-api/endpoints/class-wp-rest-taxonomies-controller.php: WP_REST_Taxonomies_Controller::get_items()

Retrieves all public taxonomies.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::search_available_items_query()

Performs post queries for available-item searching.
wp-includes/class-wp-customize-nav-menus.php: WP_Customize_Nav_Menus::available_item_types()

Return an array of all the available item types.
wp-admin/includes/export.php: export_wp()

Generates the WXR export file for download.
wp-admin/includes/misc.php: set_screen_options()

Saves option for number of rows when listing posts, pages, comments, etc.
wp-admin/includes/ajax-actions.php: wp_ajax_menu_get_metabox()

Ajax handler for retrieving menu meta boxes.
wp-admin/includes/nav-menu.php: wp_nav_menu_taxonomy_meta_boxes()

Creates meta boxes for any taxonomy menu item.
wp-includes/class-wp.php: WP::parse_request()

Parse request to find correct WordPress query.
wp-includes/class-wp-query.php: WP_Query::parse_tax_query()

Parses various taxonomy related query vars.
wp-includes/widgets/class-wp-widget-tag-cloud.php: WP_Widget_Tag_Cloud::form()

Outputs the Tag Cloud widget settings form.
wp-includes/post-template.php: get_post_class()

Retrieves an array of the class names for the post container element.
wp-includes/media.php: get_taxonomies_for_attachments()

Retrieves all of the taxonomies that are registered for attachments.
wp-includes/class-wp-xmlrpc-server.php: wp_xmlrpc_server::wp_getTaxonomies()

Retrieve all taxonomies.
Show 11 more used by Hide more used by

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    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
    Contributed by Ulrich —

    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().

  2. Skip to note 2 content
    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
    Contributed by hearvox —

    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>';	
}
?>

    Expand full source codeCollapse full source code

  4. Skip to note 4 content
    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
    Contributed by hearvox —

    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>';
	}
}  
?>
  5. Skip to note 5 content
    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
    Contributed by samjco —

    This can be used in certain use cases as if you need to find the taxonomy from a term slug

                    // We want to find the Taxonomy to this slug.
                $term_slug = 'myterm';
                $taxonomies = get_taxonomies();
                foreach ( $taxonomies as $tax_type_key => $taxonomy ) {
                    // If term object is returned, break out of loop. (Returns false if there's no object)
                    if ( $term_object = get_term_by( 'slug', $term_slug , $taxonomy ) ) {
                        break;
                    }
                }
				//Get the taxonomy!!
                echo $term_object->taxonomy . '<br>';

				// You can also retrieve other thing of the term:
                echo $term_object->name . '<br>'; //term name
                echo $term_object->term_id . '<br>'; // term id
                echo $term_object->description . '<br>'; // term description

				// See all options by dumping the $term_object:
				//var_dump( $term_object );

    Expand full source codeCollapse full source code

You must log in before being able to contribute a note or feedback.