W3cubDocs

/WordPress

_make_cat_compat( array|object|WP_Term $category )

This function’s access is marked private. This means it is not intended for use by plugin or theme developers, only in other core functions. It is listed here for completeness.

Updates category structure to old pre-2.3 from new taxonomy structure.

Description

This function was added for the taxonomy support to update the new category structure with the old category one. This will maintain compatibility with plugins and themes which depend on the old key or property names.

The parameter should only be passed a variable and not create the array or object inline to the parameter. The reason for this is that parameter is passed by reference and PHP will fail unless it has the variable.

There is no return value, because everything is updated on the variable you pass to it. This is one of the features with using pass by reference in PHP.

Parameters

$category

(array|object|WP_Term) (Required) Category row object or array.

Source

File: wp-includes/category.php 

function _make_cat_compat( &$category ) {
	if ( is_object( $category ) && ! is_wp_error( $category ) ) {
		$category->cat_ID               = $category->term_id;
		$category->category_count       = $category->count;
		$category->category_description = $category->description;
		$category->cat_name             = $category->name;
		$category->category_nicename    = $category->slug;
		$category->category_parent      = $category->parent;
	} elseif ( is_array( $category ) && isset( $category['term_id'] ) ) {
		$category['cat_ID']               = &$category['term_id'];
		$category['category_count']       = &$category['count'];
		$category['category_description'] = &$category['description'];
		$category['cat_name']             = &$category['name'];
		$category['category_nicename']    = &$category['slug'];
		$category['category_parent']      = &$category['parent'];
	}
}

Uses

Uses Description
wp-includes/load.php: is_wp_error()

Check whether variable is a WordPress Error.

Used By

Used By Description
wp-admin/includes/taxonomy.php: get_category_to_edit()

Get category object for given ID and ‘edit’ filter context.
wp-admin/includes/taxonomy.php: wp_update_category()

Aliases wp_insert_category() with minimal args.
wp-includes/category-template.php: get_the_category()

Retrieves post categories.
wp-includes/class-wp-query.php: WP_Query::get_queried_object()

Retrieve queried object.
wp-includes/category.php: get_categories()

Retrieves a list of category objects.
wp-includes/category.php: get_category()

Retrieves category data given a category ID or category object.
wp-includes/category.php: get_category_by_path()

Retrieves a category based on URL containing the category slug.
wp-includes/category.php: get_category_by_slug()

Retrieves a category object by category slug.

Changelog

Version Description
4.4.0 The $category parameter now also accepts a WP_Term object.
2.3.0 Introduced.

© 2003–2019 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/_make_cat_compat