rest_get_route_for_taxonomy_items() │ WP 5.9.0

Gets the REST API route for a taxonomy.

Return

String. The route path with a leading slash for the given taxonomy.

Usage

rest_get_route_for_taxonomy_items( $taxonomy );

$taxonomy(string) (required)

Name of taxonomy.

Changelog

rest_get_route_for_taxonomy_items() rest get route for taxonomy items code ^{WP 6.6.2}

function rest_get_route_for_taxonomy_items( $taxonomy ) {
	$taxonomy = get_taxonomy( $taxonomy );
	if ( ! $taxonomy ) {
		return '';
	}

	if ( ! $taxonomy->show_in_rest ) {
		return '';
	}

	$namespace = ! empty( $taxonomy->rest_namespace ) ? $taxonomy->rest_namespace : 'wp/v2';
	$rest_base = ! empty( $taxonomy->rest_base ) ? $taxonomy->rest_base : $taxonomy->name;
	$route     = sprintf( '/%s/%s', $namespace, $rest_base );

	/**
	 * Filters the REST API route for a taxonomy.
	 *
	 * @since 5.9.0
	 *
	 * @param string      $route    The route path.
	 * @param WP_Taxonomy $taxonomy The taxonomy object.
	 */
	return apply_filters( 'rest_route_for_taxonomy_items', $route, $taxonomy );
}