get_taxonomies
Retrieves a list of registered taxonomy names or objects.
Description
(array) get_taxonomies( (array) $args = array(), (string) $output = 'names', (string) $operator = 'and' );
Returns (array)
A list of taxonomy names or objects.
Parameters (3)
- 0. $args — Optional. (array) =>
array()
- An array of key => value arguments to match against the taxonomy objects. Default empty array.
- 1. $output — Optional. (string) =>
'names'
- The type of output to return in the array. Accepts either taxonomy names or objects.. Default names.
- 2. $operator — Optional. (string) =>
'and'
- The logical operation to perform. Accepts and or or.. or. means only one element from the array needs to match; and means all elements must match. Default and .
Usage
if ( !function_exists( 'get_taxonomies' ) ) { require_once ABSPATH . WPINC . '/taxonomy.php'; } // Optional. An array of `key => value` arguments to match against the taxonomy objects. // Default empty array. $args = array(); // Optional. The type of output to return in the array. Accepts either taxonomy 'names' // or 'objects'. Default 'names'. $output = 'names'; $operator = 'and'; // NOTICE! Understand what this does before running. $result = get_taxonomies($args, $output, $operator);
Defined (1)
The function is defined in the following location(s).
- /wp-includes/taxonomy.php
- function get_taxonomies( $args = array(), $output = 'names', $operator = 'and' ) {
- global $wp_taxonomies;
- $field = ('names' == $output) ? 'name' : false;
- return wp_filter_object_list($wp_taxonomies, $args, $operator, $field);
- }