Description
Now you have no need to make additional requests to get taxonomy info (term_id, name, slug, term_group, term_taxonomy_id, taxonomy, description, parent, count, filter) from their id that is available in the default json response.
Now all available taxonomy data is available in ‘pure_taxonomies’ field from your json response. It works for all custom added taxonomies, and for custom post types.
For example in ‘wp-json/wp/v2/posts’ you can find default fields ‘categories’, ‘tags’ and name of custom added taxonomies that contain only its id. With this plugin you can also find new ‘pure_taxonomies’ field that include all available ‘categories’, ‘tags’ and custom taxonomies data.
Before:
{
…
categories: [
3
],
tags: [
2
],
custom_taxonomy_name: [
1
]
…
}
After:
{
…
pure_taxonomies: {
categories: [
{
term_id: 3,
name: “First category”,
slug: “first-category”,
term_group: 0,
term_taxonomy_id: 3,
taxonomy: “category”,
description: “”,
parent: 0,
count: 3,
filter: “raw”,
cat_ID: 3,
category_count: 3,
category_description: “”,
cat_name: “First category”,
category_nicename: “first-category”,
category_parent: 0
}
],
tags: [
{
term_id: 2,
name: “First tag”,
slug: “first-tag”,
term_group: 0,
term_taxonomy_id: 2,
taxonomy: “post_tag”,
description: “”,
parent: 0,
count: 2,
filter: “raw”
}
],
custom_taxonomy_name: [
{
term_id: 1,
name: “Custom Taxonomy Name”,
slug: “custom-taxonomy-name”,
term_group: 0,
term_taxonomy_id: 1,
taxonomy: “custom_taxonomy_name”,
description: “”,
parent: 0,
count: 1,
filter: “raw”
}
]
}
…
}
Check my other useful rest-api plugins: https://wordpress.org/plugins/tags/andrew-magik-rest-api.
Installation
- Double check you have the WordPress REST (v2) API installed and active
- Upload the plugin folder to the
/wp-content/plugins/
directory, or install the plugin through the WordPress plugins screen directly. - Activate the plugin through the ‘Plugins’ screen in WordPress
FAQ
- How to add custom taxonomies into Rest API:
-
/**
* Add REST API support to an already registered taxonomy.
*/
add_action( ‘init’, ‘my_custom_taxonomy_rest_support’, 25 );
function my_custom_taxonomy_rest_support() {
global $wp_taxonomies;//Here should be a list of names of the already created custom taxonomies: $taxonomy_names = array( 'clients', 'technologies' ); foreach ( $taxonomy_names as $key => $taxonomy_name ) { if (isset($wp_taxonomies[$taxonomy_name])) { $wp_taxonomies[$taxonomy_name]->show_in_rest = true; $wp_taxonomies[$taxonomy_name]->rest_base = $taxonomy_name; $wp_taxonomies[$taxonomy_name]->rest_controller_class = 'WP_REST_Terms_Controller'; } } }
- How to add custom post type into Rest API:
-
/**
* Add REST API support to an already registered post type.
*/
add_action( ‘init’, ‘my_custom_post_type_rest_support’, 25 );
function my_custom_post_type_rest_support() {
global $wp_post_types;//Here should be a name of your already created custom post type: $post_type_name = 'portfolio'; if( isset( $wp_post_types[ $post_type_name ] ) ) { $wp_post_types[$post_type_name]->show_in_rest = true; $wp_post_types[$post_type_name]->rest_base = $post_type_name; $wp_post_types[$post_type_name]->rest_controller_class = 'WP_REST_Posts_Controller'; } }
- Do you have other useful REST-API plugins?
-
Yes, I have. You can check them by tag: https://wordpress.org/plugins/tags/andrew-magik-rest-api.
Reviews
Contributors & Developers
“WP REST API – Pure Taxonomies” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “WP REST API – Pure Taxonomies” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Change log
1.0
- Initial release!