rest_get_route_for_taxonomy_items

The timeline below displays how wordpress function rest_get_route_for_taxonomy_items has changed across different WordPress versions. If a version is not listed, refer to the next available version below.

WordPress Version: 5.9

/**
 * Gets the REST API route for a taxonomy.
 *
 * @since 5.9.0
 *
 * @param string $taxonomy Name of taxonomy.
 * @return string The route path with a leading slash for the given taxonomy.
 */
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);
}