Title: wp_xmlrpc_server::_prepare_taxonomy
Published: April 25, 2014
Last modified: May 20, 2026

---

# wp_xmlrpc_server::_prepare_taxonomy( WP_Taxonomy $taxonomy, array $fields ): array

## In this article

 * [Parameters](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#parameters)
 * [Return](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#return)
 * [Source](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#source)
 * [Hooks](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#hooks)
 * [Related](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#related)

[ Back to top](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#wp--skip-link--target)

Prepares taxonomy data for return in an XML-RPC object.

## 󠀁[Parameters](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#parameters)󠁿

 `$taxonomy`[WP_Taxonomy](https://developer.wordpress.org/reference/classes/wp_taxonomy/)
required

The unprepared taxonomy data.

`$fields`arrayrequired

The subset of taxonomy fields to return.

## 󠀁[Return](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#return)󠁿

 array The prepared taxonomy data.

## 󠀁[Source](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#source)󠁿

    ```php
    protected function _prepare_taxonomy( $taxonomy, $fields ) {
    	$_taxonomy = array(
    		'name'         => $taxonomy->name,
    		'label'        => $taxonomy->label,
    		'hierarchical' => (bool) $taxonomy->hierarchical,
    		'public'       => (bool) $taxonomy->public,
    		'show_ui'      => (bool) $taxonomy->show_ui,
    		'_builtin'     => (bool) $taxonomy->_builtin,
    	);

    	if ( in_array( 'labels', $fields, true ) ) {
    		$_taxonomy['labels'] = (array) $taxonomy->labels;
    	}

    	if ( in_array( 'cap', $fields, true ) ) {
    		$_taxonomy['cap'] = (array) $taxonomy->cap;
    	}

    	if ( in_array( 'menu', $fields, true ) ) {
    		$_taxonomy['show_in_menu'] = (bool) $taxonomy->show_in_menu;
    	}

    	if ( in_array( 'object_type', $fields, true ) ) {
    		$_taxonomy['object_type'] = array_unique( (array) $taxonomy->object_type );
    	}

    	/**
    	 * Filters XML-RPC-prepared data for the given taxonomy.
    	 *
    	 * @since 3.4.0
    	 *
    	 * @param array       $_taxonomy An array of taxonomy data.
    	 * @param WP_Taxonomy $taxonomy  Taxonomy object.
    	 * @param array       $fields    The subset of taxonomy fields to return.
    	 */
    	return apply_filters( 'xmlrpc_prepare_taxonomy', $_taxonomy, $taxonomy, $fields );
    }
    ```

[View all references](https://developer.wordpress.org/reference/files/wp-includes/class-wp-xmlrpc-server.php/)
[View on Trac](https://core.trac.wordpress.org/browser/tags/7.0/src/wp-includes/class-wp-xmlrpc-server.php#L815)
[View on GitHub](https://github.com/WordPress/wordpress-develop/blob/7.0/src/wp-includes/class-wp-xmlrpc-server.php#L815-L851)

## 󠀁[Hooks](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#hooks)󠁿

 [apply_filters( ‘xmlrpc_prepare_taxonomy’, array $_taxonomy, WP_Taxonomy $taxonomy, array $fields )](https://developer.wordpress.org/reference/hooks/xmlrpc_prepare_taxonomy/)

Filters XML-RPC-prepared data for the given taxonomy.

## 󠀁[Related](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/_prepare_taxonomy/?output_format=md#related)󠁿

| Uses | Description | 
| [apply_filters()](https://developer.wordpress.org/reference/functions/apply_filters/)`wp-includes/plugin.php` |

Calls the callback functions that have been added to a filter hook.

  |

| Used by | Description | 
| [wp_xmlrpc_server::wp_getTaxonomy()](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/wp_gettaxonomy/)`wp-includes/class-wp-xmlrpc-server.php` |

Retrieves a taxonomy.

  | 
| [wp_xmlrpc_server::wp_getTaxonomies()](https://developer.wordpress.org/reference/classes/wp_xmlrpc_server/wp_gettaxonomies/)`wp-includes/class-wp-xmlrpc-server.php` |

Retrieves all taxonomies.

  |

## User Contributed Notes

You must [log in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fdeveloper.wordpress.org%2Freference%2Fclasses%2Fwp_xmlrpc_server%2F_prepare_taxonomy%2F)
before being able to contribute a note or feedback.